«Mens sana in corpore sano», Juvénal, Satires (X, 356)

24 novembre 2009

Un mémento pour Jelix, première édition

Le mémento

Vous pouvez télécharger le mémento Jelix, version 1.0 en pdf.

Idée

Il y a quelques jours sur le salon IRC #jelix, on discutait de comment préparer le salon open source du forum php 2009. On voulait essayer de proposer quelque chose aux visiteurs du stand Jelix.

Comme je savais qu'Olivier avait commencé à travailler sur une cheatsheet online pour Jelix, je me suis dit que l'on pourrait en proposer une, joliment imprimée. Après réflexion, et parce qu'avec l'expérience je trouve inutile les cheatsheets sur une feuille A4 à plat, qui finissent toutes dans une pile pour ne plus jamais en ressortir (sauf pour aller à la poubelle), j'ai eu envie de modifier un peu la mise en page pour en faire un objet un peu plus sympa qui pourrait trainer facilement à côté des claviers. Un mémento. Acte.

Conception

Étant destiné à être imprimé, j'ai utilisé un outil adapté pour concevoir le mémento : Scribus, un logiciel de PAO open source. J'ai trouvé sa prise en assez simple et rapide et pu organiser la mise en page du mémento de façon assez propre. Je ne suis pas un expert de la PAO, j'ai donc peut-être sous utilisé le logiciel par moment, mais je suis assez satisfait de l'utilisation que j'ai pu faire de Scribus.

La conception demandait de travailler sur deux aspects :

  • la mise en page pure
  • le rédactionnel

La mise en page

Ce n'est pas mon point fort (c'est bien pour cela que nous sommes deux chez Kayuko et que tout ce qui touche à l'apparence est réalisé par Guy-Philippe) mais j'ai essayé de m'y mettre pour cette fois. Je voulais faire simple et pas trop chargé. En suivant certains bons conseils (essentiellement Guy-Philippe, encore lui) et en travaillant par itérations successives, la mise en page s'est mise au point.

Il fallait que le contenu soit lisible rapidement. Pour cela je voulais des titres bien en évidence pour attirer l'oeil. Au fil des itérations, la 2ème contrainte qui est apparue est celle de la quantité d'encre utilisée. Il serait mieux si l'impression d'un mémento chez vous ne vous vidait pas les cartouches.

Nous sommes donc arrivés au résultat final, qui je trouve n'est pas si mal. Je dois par contre essayer de mieux gérer les marges des imprimantes par rapport à ma mise en page.

Le contenu

Avoir un fichier ouvert sous scribus, avoir défini des styles et voir comment va apparaitre le texte c'est bien. Mais y mettre du contenu utile est une autre histoire. Je me suis basé sur le travail initial d'Olivier, que je remercie au passage pour ce qu'il a fait.

C'est sur ce point dont je suis le moins satisfait de mon travail. En effet je suis parti avec comme objectif d'avoir un mémento utile pour les personnes découvrant Jelix. Y mettre les concepts de base et couvrir l'utilisation principale de manière simple. C'est ce dont je me suis attaché à faire.

Mais finalement cela ne me convient pas. Peut-être car je ne suis pas la cible même de ce mémento ? Certainement. Je voulais un outil qui serve vraiment et je pense que pour cela il ne fallait pas viser la découverte de Jelix mais bel et bien son utilisation au quotidien.

Je peux donc déjà annoncer que je vais retravailler le rédactionnel pour faire une nouvelle version plus intéressante. L'avantage est que j'ai maintenant mieux en main Scribus et que je n'ai plus à travailler la mise en page.

Tout comme mon choix initial de la langue anglaise qui est à revoir ou au moins à compléter avec une version en français. Si j'ai bien remarqué une chose avec Jelix, c'est que de la documentation en français est toujours plus appréciée ;)

Publication du mémento

Jelix est un projet open source, le mémento se devait de l'être tout autant. Il est donc publié sous Licence Creatice Commons by-nc-sa 3.0. Les sources sont disponibles sur bitbucket (j'utilise d'ailleurs de plus en plus mercurial au quotidien) vous pouvez donc cloner et patcher autant que vous voulez ;)

N'hésitez pas non plus à me faire des retours sur ce document pour qu'il soit amélioré et puisse être plus utile au quotidien.

Petite conclusion

  • Travailler par itérations c'est bien
  • Concevoir en amont «sur papier» avant de se jeter sur un clavier aussi
  • Versionner son travail c'est pratique
  • Le partager c'est bon pour tous

23 février 2009

Publication de Jelix 1.1

La nouvelle semble être passée un peu inaperçue et c'est pourquoi je la relaie : la version finale 1.1 de Jelix est publiée !

Je vous invite fortement à découvrir Jelix si ce n'est pas déjà fait car ce framework mérite vraiment que l'on s'y intéresse. Cette version majeure marque un bon pas en avant avec un changelog long comme le bras. Ce n'est pas pour rien que la communauté continue de s'agrandir.

Jelix 1.1 s'accompagne donc d'une documentation, sur laquelle un énorme travail a été fait. Elle est maintenant disponible aussi en anglais avec des versions téléchargeable en PDF.

Je félicite vraiment toute l'équipe pour le travail accompli, c'est du très beau boulot ! Je suis assez fiers de participer à ce projet, même si dernièrement mes contributions en code n'ont pas été très importante.

Nous profitons aussi de cette publication majeure et du changement de job de Laurent pour améliorer fortement l'organisation du projet. Jelix est vraiment porté par une communauté et nous allons utiliser au mieux les compétences pour avancer encore et encore. N'hésitez d'ailleurs pas à répondre à l'appel à contribution.

Hoopa Jelixians !

9 décembre 2008

Jelix 1.1RC1 dans les bacs !

Aujourd'hui vient de sortir la première (et certainement unique) release candidate de Jelix. Je vous encourage donc à télécharger Jelix 1.1RC1 et à la tester. C'est vraiment l'occasion de venir découvrir ce framework php 5 qui n'a rien a envier aux autres, bien au contraire.

La documentation, déjà très fournie, est en train d'être complétée pour vous donner tous les moyens d'apprivoiser l'outil. Je vous rappel qu'il y a aussi les forums et le chan IRC (#jelix sur irc.freenode.net) pour venir demander de l'aide ou des compléments d'explication.

Je ne vais pas vous lister ici tous les changements de cette nouvelle version, pour cela il y a le changelog.

Je remercie bien évidemment Laurent et le reste de la Jelix Team pour le travail accompli. Aller les gars, nous sommes tout proche de la relase finale ! :)

Liens utiles :

29 octobre 2008

Besoin d'un site pour votre restaurant ? ComResto !

J'avoue, je délaisse ce blog. Du coup je ne vous ai même pas parlé du dernier service lancé par Kayuko, notre société avec Guy-Philippe, honte à moi ;)

Voici donc ComResto ! Qu'est-ce donc ? ComResto est une plateforme de création de site pour restaurants. Nos objectifs principaux sont de fournir :

  • un service utile : pas de fonctionnalités superflues mais le principal pour le restaurateur et les clients
  • de la qualité : nous sommes attachés à produire du travail bien fait
  • un prix très raisonnable : 24,90€/mois, soit un véritable site professionnel avec backoffice intuitif pour moins de 300€/an.

Une nouvelle fois je suis très heureux d'avoir monté ce projet avec Guy-Philippe. Entre nos projets clients, nous venons de commettre en effet notre 2ème application propre à Kayuko (après le comparateur de prix de DVDs). La phase de développement initiale est terminée, le produit est lancé, maintenant nous allons le maintenir, l'améliorer et surtout le commercialiser.

Côté développement, l'intégralité de la plateforme a été développée avec Jelix, forcément ;)

Retenez bien ce nom : ComResto ! :)

24 juillet 2008

Utiliser les librairies du Zend Framework depuis Jelix, c'est intégré

Il y a un moment maintenant, je vous avais présenté un plugin Jelix permettant de faciliter l'utilisation des librairies du Zend Framework.

Comme ce plugin pourrait servir à bien d'autres que moi et permettre aux Jelixians d'avoir à disposition les librairies intéressantes du Zend Framework, il a été finalement intégré directement dans Jelix. Il sera donc disponible dans la version 1.1 (et dès demain dans les nightly build du trunk).

Pour l'utiliser :

  • copier le fichier lib/jelix/plugins/coord/zendframework/zendframework.coord.ini.php.dist vers votreappli/var/config/zendframework.coord.ini.php
  • configurer la variable zendLibPath dans ce fichier de configuration
  • activer le plugin dans le fichier de configuration de votre application :
[coordplugins]
zendframework = zendframework.coord.ini.php

Comme vous ne voudrez certainement pas charger inutilement le loader du Zend Framework à chaque action de votre application, il faudra explicitement déclarer que vous voulez vous servir de ses librairies. Cela se fait avec la variable de classe $pluginParams du controller (ici je n'active le ZF que pour l'action fooPdf de mon controller) :

public $pluginParams = array('fooPdf' => array('zf.active' => true));

Ensuite libre à vous, dans votre action ou dans une classe métier qui sera utilisée dans cette action, d'utiliser les librairies du ZF. Je reprends l'exemple que j'avais précédemment donné avec Zend_Pdf :

function fooPdf() {
$rep = $this->getResponse('binary');

Zend_Loader::loadClass('Zend_Pdf');
$pdf = new Zend_Pdf();
$pdf->pages = ($page = $pdf->newPage('A4'));
$font = Zend_Pdf_Font::fontWithName(Zend_Pdf_Font::FONT_HELVETICA);
$page->setFont($font, 32);
$page->drawText('Zend Framework with Jelix !', 120, 500);

$rep->content = $pdf->render();
$rep->outputFileName = 'fooo.pdf';
$rep->mimeType = 'application/pdf';

return $rep;

}

Dans ce cas précis il n'est pas exclu que je propose une réponse personnalisée jResponseZfPdf pour mapper de manière plus élégante l'utilisation des pdf dans Jelix avec Zend_Pdf.

- page 1 de 4