Le retour du manuel PHP sur lephpfacile.com

le 17/03/2008 à 19:24
Le retour du manuel PHP sur lephpfacile.com
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

A lire également

Une petite news pour vous annoncer la présence du manuel MySQL sur le site.
Celui ci est accessible via un lien dans la colonne de droite, dans la sections "Manuels".

Cela fait maintenant quelques années que ce manuel avait disparu du site, en fait, depuis la mise en ligne de la V4 du site.
Il était "normal" pour un site traitant de PHP, mais aussi de SQL, que cette documentation refasse son retour.

Sinon, sachez aussi que les manuels Pear et Smarty sont en préparation :)

- Manuel MySQL

Commentaires

Ecrire
Amery
le 18/03/2008 à 13:59
Amery
Très pratique. Excellente nouvelle!!!
Ecrire

Ecrire un message

Votre message vient d'être créé avec succès.
LoadingChargement en cours