Je cherchai justement une classe d’abstraction de base de donnée. Qu’est-ce que c’est ? Quand on a écrit des pages PHP pour MySQL, et qu’ensuite vous voulez porter ce programme pour une autre base de donnée, vous devez réécrire toute la partie d’accès aux données. Le moyen d’éviter cela, c’est d’écrire sa propre bibliothèque de fonctions génériques d’accès aux données, ces fonctions étant définies dans un autre fichier, différent par base de données, qui lui est spécifique à chaque base. Il suffit ainsi lorqu’on change de base de changer le fichier à inclure.

C’est très intéressant et très formateur d’écrire sa propre bibliothèque, mais j’ai du faire un choix de porter mon attention sur d’autres domaines, et partant de là je me suis mis à rechercher une bibliothèque toute faite. Il en existe beaucoup. La plus connue et la plus ancienne est celle incluse dans la bibliothèque Phplib, mais aujourd’hui il semble que la bibliothèque de référence soit celle incluse dans PEAR, PEAR ::DB. La plus avancée en terme d’abstraction de base de donnée est METABASE. Aujourd’hui un projet, PEAR ::MDB tente de porter METABASE aux standards PEAR.

Toujours est-il que lorsque j’ai parcouru le manuel en français de PEAR, je me suis aperçu que peu de pages étaient traduites en français. Quans j’en ai fais la remarque, on m’a répondu que toute aide pour la traduction était la bienvenue. Voilà comment je me suis retrouvé traducteur du manuel PEAR pour le français. Je ne suis pas le seul, mais depuis que j’ai commencé début 2003, je suis le seul à ajouter (lentement) des traductions. J’ai commencé à travailler sur la version 2 de peardoc (peardoc2) alors que la version 1 était en ligne jusqu’au 30 avril 2003 pour la version anglaise, les autres langages étant encore à l’ancienne version.

Il faut savoir que ce n’est pas simple de faire la traduction de PEAR. Ce n’est pas un problème de language, mais de forme. Je croyais naïvement écrire dans un éditeur html. Sans rentrer dans le détail, la documentation de PEAR et de PHP est écrite en XML. XML (Extensible Markup Language, ou Langage Extensible de Balisage) est le langage destiné à succéder à HTML sur le World Wide Web. Comme HTML (Hypertext Markup Language) c’est un langage de balisage (markup), c’est-à-dire un langage qui présente de l’information encadrée par des balises. Mais contrairement à HTML, qui présente un jeu limité de balises orientées présentation (titre, paragraphe, image, lien hypertexte, etc.), XML est un métalangage, qui va permettre d’inventer à volonté de nouvelles balises pour isoler toutes les informations élémentaires (titre d’ouvrage, prix d’article, numéro de sécurité sociale, référence de pièce…), ou agrégats d’informations élémentaires, que peut contenir une page Web.

Ainsi chaque application qui utilise XML invente ses propres balises. Pour résumer, ces balises propres à chaque application sont répertoriées dans un dictionnaire, qui permet de définir ainsi les documents. Ce dictionnaire s’appelle un DTD, pour Document Type Definition (Definition du Type de Document). Pour écrire des documentations informatiques et industrielles, il en existe une appelé Docbook. DocBook est la DTD de référence dans le monde SGML et XML pour écrire de la documentation.

Le problème c’est qu’il n’existe quasimment aucun éditeur pour travailler en WYSIWYG, il faut écrire dans un éditeur de texte. Voici à quoi çà ressemble :

&lt;legalnotice id=&quot;copyright&quot;&gt;<br />   &lt;title&gt;Copyright&lt;/title&gt;<br />   &lt;simpara&gt;<br />   Ce manuel est &amp;copy; Copyright 2001-2003 par<br />   le PHP PEAR Group. Les membres de ce groupe sont list&eacute;s<br />   sur la premi&egrave;re page de ce manuel.<br />   &lt;/simpara&gt;<br />   &lt;simpara&gt;<br />   Ce manuel peut &ecirc;tre redistribu&eacute; sous les termes de la license GNU    <br />   GPL (General Public License), comme publi&eacute; par la &quot;Free Software<br />   Foundation&quot;; soit la version 2 de la license, ou (&agrave; votre choix)<br />   une version post&eacute;rieure.<br />   &lt;/simpara&gt;<br />   &lt;/legalnotice&gt;

Le chance que j’ai c’est de ne faire que la traduction, je n’ai donc qu’à récupérer la version anglaise et à traduire les chaines de texte. Le seul problème est pour visualiser le résultat. La génération des pages html à partir des fichiers XML se fait un peu comme une compilation de programme. Sous Linux, il faut taper dans le répertoire des fichiers XML :

autoconf
./configure
make

et au bout de quelques dizaines de secondes à quelques minutes selon la puissance de la machine (il y a presque 1000 pages HTML à générer), vous avez vos fichiers dans le répertoire HTML. Sous Windows euh… ce n’est pas possible, à moins d’installer Cygwin, un environnement permettant d’émuler le fonctionnement et les principaux programmes d’un système UNIX. Normalement çà doit marcher mais chez moi en tapant les même commandes que ci-dessus j’ai eu des erreurs que je n’ai jamais su résoudre, donc j’ai laissé tombé (mais d’autres y arrivent).

Au jour où j’écris, la traduction en ligne, http://pear.php.net/manual/fr/index.php , est toujours celle de la version 1, et a été construite le 26 janvier 2003 (la date figure sur la première page).