Au lancement de la V4 de lephpfacile.com, le manuel PHP avait disparu des rubriques du site.
Pourquoi ? Notamment pour une raison simple : celui-ci avait un code HTML "moisi".
Après le lancement de la V4, je me suis mis à travailler directement sur les sources XML de la documentation PHP via le CVS de PHP. Ces sources sont au format DocBook, et je connaissais pas du tout ce format.
Deux possibilités s'offraient alors à moi :
- soit réécrire le moteur XSLT afin de produire du code HTML correct
- soit parser tous les fichiers XML pour reconstituer le manuel
Et bien j'ai opté pour aucune de ces deux solutions !
En effet, à cause du boulot, j'avais mis de côté ce projet laborieux, et ce week-end, en téléchargeant directement les sources HTML du manuel PHP, je me rendu compte qu'il y avait eu des progrès énormes sur la qualité du code HTML.
Quelques regex accompagnées de tidy ont finalement étés suffisant pour générer un manuel PHP "propre" (ce n'est pas encore parfait, mais ça valide au W3C) et aux couleurs de lephpfacile.com.
- CVS PHP
- tidy
- le manuel PHP sur lephpfacile.com
Pourquoi ? Notamment pour une raison simple : celui-ci avait un code HTML "moisi".
Après le lancement de la V4, je me suis mis à travailler directement sur les sources XML de la documentation PHP via le CVS de PHP. Ces sources sont au format DocBook, et je connaissais pas du tout ce format.
Deux possibilités s'offraient alors à moi :
- soit réécrire le moteur XSLT afin de produire du code HTML correct
- soit parser tous les fichiers XML pour reconstituer le manuel
Et bien j'ai opté pour aucune de ces deux solutions !
En effet, à cause du boulot, j'avais mis de côté ce projet laborieux, et ce week-end, en téléchargeant directement les sources HTML du manuel PHP, je me rendu compte qu'il y avait eu des progrès énormes sur la qualité du code HTML.
Quelques regex accompagnées de tidy ont finalement étés suffisant pour générer un manuel PHP "propre" (ce n'est pas encore parfait, mais ça valide au W3C) et aux couleurs de lephpfacile.com.
- CVS PHP
- tidy
- le manuel PHP sur lephpfacile.com
-
Auteur
