La Linux Gazette en français

La traduction de la Linux Gazette en français est un des projets phares de Traduc.org : son but est de mettre à la disposition du public francophone les articles d’un des acteurs majeurs de la presse américaine dédiée à Linux.

Les fichiers sources des articles de la Linux Gazette en français sont écrits au format docbook XML v4.2 qui permet de générer de nombreux autres formats, dont le HTML que vous affichez sur votre navigateur, le PDF ou le PostScript.

Ce document vous explique le parcours d'un article depuis sa publication dans la Linux Gazette américaine qui se décline depuis fin novembre 2003 en deux sites distincts : http://www.linuxgazette.com et http://www.linuxgazette.net, jusqu'à sa diffusion sur notre FTP.

Nous emploierons un exemple concret tiré d'un article récent pour indiquer les diverses étapes nécessaires à la traduction en français et la mise en forme d’un article de la Linux Gazette en partant du fichier original en anglais.

Procédure générale de traduction

Abonnez-vous en premier lieu à la liste de discussion générale traduc@traduc.org à l'adresse : http://www.traduc.org/mailman/listinfo/traduc/ qui vous permet d’obtenir une réponse rapide aux questions que vous vous posez peut-être ou de demander de l'aide en cas de problème technique ou terminologique.

Sur le site de Traduc.org, dans le menu présentant les divers projets, cliquez sur Linux Gazette pour afficher l'interface graphique : http://www.traduc.org/docs/lgazette/etat_gazette.php?1..2. Elle présente en temps réel l’état des traductions : disponibles, en cours, relecture. Dès qu'un article est à jour, un clic sur le petit drapeau tricolore vous permet de l'afficher en français et en HTML sur votre navigateur.

Vous constatez que les articles de la Linux Gazette proposés à la traduction sont référencés de la manière suivante :

•	lg pour Linux Gazette
•	00 pour le numéro de la Linux Gazette
•	X pour attribuer un ordre de classement aux articles.

Respectez scrupuleusement cette signalétique lorsque vous choisissez l’article que vous traduirez car elle vous servira pour nommer votre fichier traduit.

Exemple : pour traduire l’article « Customizing the splash image in GRUB » de C.R. Jayanth, paru dans  le numéro 97 de la Linux Gazette de décembre 2003, indiquez sur votre message de réservation « Traduction article lg97-A ».

1.	Choisissez l’article que vous souhaitez traduire en fonction de votre niveau d’anglais, de votre disponibilité, de vos compétences et de vos centres d’intérêt pour les différents thèmes que traite la Linux Gazette. Tous les articles en anglais se trouvent sur les deux sites américains de la Linux Gazette : http://www.linuxgazette.com et http://www.linuxgazette.net. Un simple clic sur la référence du mois et de l’année vous mène à la liste des articles.

2.	Envoyez-moi un message à l’adresse : coordination-gazette@traduc.org pour réserver l’article que vous souhaitez traduire.

3.	Attendez ma confirmation, que je vous envoie en général rapidement. Vous pouvez la vérifier sur l'interface d'état.

4.	Commencez votre traduction en utilisant le modèle d’article docbook xml v4.2 disponible sur notre FTP : http://ftp.traduc.org/projets/gazette-linux/modele-docbook.sgml et en suivant les conseils ci-après.

5.	Envoyez-moi votre article traduit sous forme compressée (avec extension .gz ou .bz2) ou non, à l’adresse : coordination-gazette@traduc.org. Votre fichier sera alors relu, corrigé si nécessaire et mis en ligne.

Les outils du traducteur

A.	Les outils docbook : leur installation est nécessaire pour pouvoir travailler sur les fichiers sources docbook. Reportez-vous au guide « Writing Documentation using Docbook » à l’adresse : http://opensource.bureau-cornavin.com/crash-course/index.html qui contient toutes les informations utiles.

B.	Docbook xml est un langage « à balises » dont nous utilisons actuellement la DTD 4.2. Ne manquez pas de consulter le site http://www.oasis-open.org/docbook/, sans oublier l’ouvrage édité par O’Reilly et disponible en ligne (en anglais) : http://www.oreilly.com/catalog/docbook/chapter/book/docbook.html

C.	Un éditeur de texte offrant des fonctions de coloration syntaxique (Kate de KDE, GEdit de Gnome, VIm, XEmacs, etc.) pour un meilleur confort de travail.

D.	Quelques glossaires de termes informatiques courants :
•	Glossaire open source : http://opensource.bureau-cornavin.com/glossary/index.html ;
•	Le Grand Dictionnaire Terminologique ou GDT : http://www.granddictionnaire.com/_fs_global_01.htm ;
•	Eurodicautom : http://www.europa.eu.int/eurodicautom/Controller.

E.	Un dictionnaire de français, voire une grammaire.

Un exemple concret

Vous souhaitez traduire l’article « Customizing the splash image in GRUB » de C.R. Jayanth, disponible à l’adresse : http://www.linuxgazette.com/issue97/jayanth.html. Pour l'afficher, allez sur le site américain, cliquez sur ce lien qui correspond à cet article sur le numéro de la Linux Gazette de décembre 2002 pour l’afficher.

Astuce – Si vous souhaitez traduire un article de la Linux Gazette du mois en cours, par exemple celle de janvier 2004, allez sur la page d’accueil du site américain http://www.linuxgazette.com et cliquez sur le lien old format Linux Gazette pour afficher l’article souhaité sur votre navigateur. Pour http://www.linuxgazette.net, cliquez directement sur le lien January 2004.

Lisez attentivement cet article, cherchez à bien en comprendre le sens, notez les points ou les tournures qui vous paraissent obscures, documentez-vous si besoin est. Vous pouvez également consulter les autres publications éventuelles de l'auteur sur le site. Les articles ne traitent pas toujours que d’informatique, mais parfois d’autres disciplines et nécessitent une documentation complémentaire.

Imprimez-le et sauvegardez-le dans votre répertoire personnel : ce sera l’un de vos deux documents de travail. Vous devrez l’avoir à portée de la main tout au long de votre traduction.

Muni(e) du patron d’article docbook xml qui vous servira de modèle, créez un nouveau document dans un éditeur de texte et enregistrez-le en lui attribuant le nom définitif du fichier traduit à renvoyer, en respectant la signalétique décrite plus haut : ce sera votre second document de travail. Vous pouvez aussi faire un copier-coller de ce modèle pour ne pas oublier les diverses parties indispensables (dtd, en-tête, hiérarchisation des sections et sous-sections, etc.). Cette astuce vous facilitera la tâche si vous débutez avec docbook, en veillant bien entendu à la cohérence de l'article que vous traduisez.

Voici le source de l'article lg97-A de la Linux Gazette de décembre 2003, au format docbook xml v4.2 tel qu’il doit être saisi dans votre éditeur de texte et que vous devez me le renvoyer, traduit en français par un de nos fidèles traducteurs et relu par mes soins. Il montre quelques-unes des balises à inclure pour pouvoir valider un fichier docbook afin de générer divers formats :

<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [

]>

<article id="lg97a.fr" lang="fr">
 <articleinfo>
  <title>Personnalisez l'image d'accueil de GRUB</title>
   <subtitle>Linux Gazette n°97 - Décembre 2003</subtitle>
    <copyright><year>2003</year><holder> C.R. Jayanth</holder></copyright>
     <author><firstname>C.R.</firstname><surname>Jayanth</surname></author>
 </articleinfo>

<!-- ###################################################################### -->
<para>
L'image d'accueil est celle qui apparaît en arrière-plan quand le chargeur <acronym>GRUB</acronym> (<emphasis>GRand Unified Bootloader</emphasis>) affiche la liste des systèmes d'exploitation que vous pouvez amorcer. Habituellement, il s'agit du logo commercial de votre distribution Linux. Mais il est très simple de le personnaliser par une image de votre choix. Tout ce dont vous avez besoin est <application>The GIMP</application> et <application>gzip</application>. Ma version de <application>The GIMP</application> est 1.2. Même les versions antérieures peuvent convenir pour cette tâche.
</para>

<para>
Voici comment faire (vous devez être connecté en tant que super-utilisateur (<emphasis>root</emphasis>)&nbsp;:
</para>

<para>
<orderedlist numeration="arabic">
<listitem><para>Démarrez <application>The GIMP</application>.</para></listitem>
<listitem><para>Cliquez sur Fichier -> Nouveau ou appuyez sur Ctrl+N.</para></listitem>
<listitem><para>Dans la boîte de dialogue de la nouvelle image, modifiez la largeur à 640&nbsp;pixels et la hauteur à 480&nbsp;pixels (l'image devrait avoir une taille de 640x480&nbsp;pixels). Cliquez mainenant sur Valider.</para></listitem>
<listitem><para>Créez l'image que vous souhaitez avoir comme image d'accueil. Expérimenter les divers outils de <acronym>The GIMP</acronym> est très amusant.</para></listitem>
<listitem><para>Après avoir terminé la création de l'image, appuyez sur Alt+i ou faites un clic droit sur l'image et cliquez sur Image -> Mode -> Indexé...</para></listitem>
<listitem><para>Dans la boîte de dialogue Conversion des couleurs indexéesqui apparaît, cliquez sur le bouton radio <guibutton>Générer une palette optimale</guibutton> et dans <guibutton>nb de couleurs</guibutton>, saisissez 14. Cliquez sur OK (l'image doit avoir 14&nbsp;couleurs au maximum).</para></listitem>
<listitem><para>Faites un clic droit sur l'image et sélectionnez Fichier -> Enregistrer sous... Enregistrez le fichier sous le nom de <filename>splash.xpm</filename> dans le répertoire de votre choix.</para></listitem>
<listitem><para>Ouvrez à présent un terminal et allez dans le répertoire où vous avez enregistré <filename>splash.xpm</filename>.</para></listitem>
<listitem><para>Compressez ensuite <filename>splash.xpm</filename> avec <application>gzip</application>.</para></listitem>
<listitem><para>Vous constatez qu'un fichier nommé <filename>splash.xpm.gz</filename> est créé dans le répertoire où <filename>splash.xpm</filename> se trouvait.</para></listitem>
<listitem><para>Copiez ce fichier <filename>splash.xpm.gz</filename> dans le répertoire <filename>/boot/grub</filename>. Il se peut que vous ayiez à sauvegarder le fichier <filename>splash.xpl.gz</filename> dans le répertoire <filename>/boot/grub</filename> au préalable.</para></listitem>
</orderedlist>
</para>

<para>
C'est fini&nbsp;! Quand vous réamorcez, votre image apparaît en arrière-plan, ainsi que le menu des systèmes d'exploitation, etc... à l'avant-plan.
</para>

<para>
Naturellement, ce n'est pas la seule manière de changer l'image, mais celle-ci est très simple.
</para>

<para>Copyright &copy; 2003, C.R. Jayanth</para>
<para>Copying license <ulink
url="http://www.linuxgazette.com/copying.html">http://www.linuxgazette.com/copying.html</ulink></para>
<para>Paru dans le n°97 de la Linux Gazette de décembre 2003.</para>
<para>Traduction française par Eric Barbero
<email>eribar@free.fr</email>.</para>
<para>Relecture de la traduction française par Joëlle Cornavin
<email>jcornavi CHEZ club-internet POINT fr</email>.</para>
</article>

Vous trouverez en annexe de ce document l'article lg97-A une version papier présentant trois formats, dont voici les adresses correspondantes sur notre FTP pour plus de commodité :

a)	Au format HTML : http://ftp.traduc.org/doc-vf/gazette-linux/html/2003/097/lg97-A.html

b)	Au format PDF : http://ftp.traduc.org/doc-vf/gazette-linux/pdf/2003/097/lg97-A.pdf

c)	Au format PostScript : http://ftp.traduc.org/doc-vf/gazette-linux/ps/2003/097/lg97-A.ps

Remarque – Cet exemple a été choisi pour sa simplicité. Il est bien évidemment possible d’ajouter des liens faisant référence à un site web, des images, des listes numérotées, des listings de code, etc. Vous trouverez toutes ces précisions dans l'abondante documentation consacrée à docbook.

Après la traduction : relecture et vérification syntaxique

o	Au moins deux relectures : lorsque vous avez traduit votre article, vous devez bien évidemment vous relire pour vérifier que rien ne vous a échappé et mieux, faire relire votre texte à une personne de votre entourage, qui décèlera peut-être mieux que vous certaines imprécisions et autres tournures scolaires, approximatives ou familières qui sont absolument à bannir.

o	La vérification syntaxique : une fois votre traduction terminée et relue, il vous reste encore à vérifier votre syntaxe docbook. Dans un terminal, saisissez la commande 'docbook2html nom_du_fichier.sgml'. Si votre fichier est syntaxiquement correct, cette commande vous renvoie ’Done’ au bout de quelques instants : vous venez de générer une version HTML de votre fichier, enregistrée dans votre répertoire de travail sous forme d'un ou de plusieurs fichiers portant l’extension '.html', que vous pouvez lire plus confortablement sur votre navigateur.

Remarque – L'extension '.xml' au lieu de '.sgml' est tout à fait recevable.

En revanche, si pendant la vérification syntaxique vous voyez défiler sur votre console différents messages d'erreurs signalés sur certains numéros et positions de lignes, votre syntaxe docbook est incorrecte. Vérifiez à nouveau votre fichier en vous repérant à ces numéros et positions de lignes jusqu’à ce que la validation soit correcte. 

Admirez le résultat obtenu. C’est tout !

Merci de votre contribution.

Joëlle Cornavin
Coordinateur Linux Gazette
coordination-gazette@traduc.org