Petit guide du traducteur

Version : 0.65

Ce document libre a été créé par Jean-Philippe Guérard en mars 2003. Vous pouvez le diffuser et le modifier selon les termes de la licence Art libre. Vous trouverez un exemplaire de cette licence à la fin de ce document, ainsi que sur le site Copyleft Attitude.

3 août 2008

Historique des versions
Version 0.652008-08-03JPG
Clarification de l'utilisation de l'attribut « class » de <othercredit>. Correction d'une faute d'orthographe repérée par Philippe Petrinko.
Version 0.642008-03-23JPG
Ajout d'un section séparée expliquant comment indiquer dans le format DocBook que le document est en français.
Version 0.632007-02-26JPG
Mise à jour de la procédure de production simple.
Version 0.622006-05-18JPG
Mise à jour mineure : mise à jour des versions des logiciels utilisés dans la section « Production de la version HTML de ce guide pratique » et amélioration du balisage (ajout d'identifiants aux tables et aux sections qui n'en avaient pas encore).
Version 0.612006-02-07JPG
Correction d'une erreur dans la section « Production de la version HTML de ce guide pratique » sur une suggestion de ykerb2 (le script d'installation de la feuille de style XSL DocBook s'appelle « install.sh » et non « INSTALL »). Remise à jour de cette section.
Version 0.602006-01-28JPG
Mise à jour et simplification de l'annexe « Produire simplement une version HTML d'un document XML DocBook ».
Version 0.592006-01-28JPG
Correction d'une faute d'anglais sur une suggestion de khaqq.
Version 0.582006-01-02JPG
Restructuration de la section sur les codages, passage du document source en latin 9, plus quelques mises à jour mineures.
Version 0.572005-10-23JPG
Correction de la section « Production de la version HTML de ce guide pratique » (il n'y a pas de catalogue XML dans l'archive XSL DocBook). Mise à jour de la section « Ponctuation » pour revenir à l'utilisation de « &nbsp; » à la place de « &thinsp; », pour des raisons de compatibilité avec certains navigateurs.
Version 0.532005-03-14JPG
Suite à la disparition de l'option add-sgml-extension dans la version 0.60 d'Aspell, modification de la section sur la vérification d'orthographe, pour suggérer l'emploi de Aspell avec l'option -H pour vérifier l'orthographe des fichiers XML.
Version 0.512005-02-15JPG
Ajout d'un deux-points oublié dans la procédure de production de la version HTML de ce guide pratique. Merci à Pascal Miquet de cette correction !
Version 0.442004-12-28JPG
Ajout en annexe de la commande utilisée pour produire la version HTML de ce guide pratique.
Version 0.412004-12-13JPG
Ajout d'une note sur l'écriture simplifiée des hyperliens. Ajout d'une section sur l'adaptation des paragraphes « Nouvelles versions de ce document ».
Version 0.392004-11-20JPG
Ajout d'un section sur les blocs de texte littéral. Merci à Pierre Machard et Guillaume Lelarge de leurs corrections et suggestions !
Version 0.352004-10-18JPG
Ajout d'un chapitre sur la traduction de la licence.
Version 0.332004-08-25JPG
Ajout d'une section sur les titres de section (^_^). Ajout d'une section « Commentaires et corrections » au patron DocBook.
Version 0.312004-08-01JPG
Reformatage du modèle de courrier à envoyer à l'auteur pour respecter les marges des versions PostScript et PDF. Ajout d'une section sur la vérification de la structure avec xmllint. Mises à jour mineures du patron DocBook.
Version 0.272004-07-14JPG
Quelques corrections de Guillaume Lelarge, ajout d'un courrier type à envoyer aux auteurs pour les prévenir du début d'une traduction.

Résumé

Ce document est le fruit de l'expérience accumulée par le projet Traduc.org dans l'adaptation en français de guides pratiques (howto). Il tente de résumer les informations dont le traducteur a besoin et de définir des normes permettant de rendre cohérentes entre elles la présentation des traductions.


Table des matières

1. Introduction
1.1. Ce qu'il faut retenir
1.2. Commentaires et corrections
1.3. Nouvelles versions de ce document
2. Avant de commencer
2.1. S'abonner aux listes de discussion
2.2. Choisir un document
2.3. Obtenir le feu vert du coordinateur
2.4. Prendre contact avec l'auteur
3. La traduction
3.1. Reconnaître le format du document
3.2. Le format DocBook
3.3. Paramétrer DocBook pour le français
3.4. Le codage du texte
3.5. Les majuscules
3.6. La ponctuation
3.7. Le titre
3.8. Le nom du traducteur et du relecteur
3.9. La version
3.10. La date
3.11. L'historique des révisions
3.12. Le résumé
3.13. La licence du document
3.14. Les adresses électroniques
3.15. Les titres des sections
3.16. La section « Commentaires et corrections »
3.17. La section « Nouvelles versions de ce document »
3.18. Les liens et les références
3.19. Les blocs de texte littéral
3.20. Les scripts et les extraits de code
3.21. Les captures d'écrans et les exemples
4. Une fois la traduction terminée
4.1. Vérifier l'orthographe
4.2. Vérifier la structure du document
4.3. Livrer la traduction
5. Relire
5.1. Livrer sa relecture
A. Patron DocBook
B. Produire simplement une version HTML d'un document XML DocBook
C. Production de la version HTML de ce guide pratique
D. Aide-mémoire des licences libres
1. La licence de documentation libre GNU [GFDL]
2. La licence publique générale GNU [GPL]
E. Licence Art libre
1. Préambule
2. DÉFINITIONS
3. OBJET
4. L'ÉTENDUE DE LA JOUISSANCE
4.1. LA LIBERTÉ DE COPIER (OU DE REPRODUCTION)
4.2. LA LIBERTÉ DE DIFFUSER, D'INTERPRÉTER (OU DE REPRÉSENTATION)
4.3. LA LIBERTÉ DE MODIFIER
5. L'INCORPORATION DE L'ŒUVRE
6. VOS DROITS D'AUTEUR
7. LA DURÉE DE LA LICENCE
8. LES DIFFÉRENTES VERSIONS DE LA LICENCE
9. LES SOUS-LICENCES
10. LA LOI APPLICABLE AU CONTRAT

Ce document est destiné aux traducteurs et aux relecteurs et tente de répondre aux questions qui se posent lors de la traduction d'un guide pratique au format DocBook.

Les exemples présentés dans ce document sont rédigés en utilisant le format XML DocBook. Il ne faut pas hésiter à copier certains exemples dans une traduction et à s'en servir comme trame de base.

Ce chapitre explique comment préparer une traduction. Il décrit chacune des étapes préliminaires permettant de s'assurer que l'on réalisera un travail utile.

Le projet de traduction des documents libres utilise deux listes de discussion. Une liste pour les discussions internes et une liste destinée aux commentaires et corrections des lecteurs.

  • La liste traduc CHEZ traduc POINT org est le cœur de Traduc.org. Cette liste est le lieu de rencontre de nombreux traducteurs appartenant à de multiples projets, ce qui en fait l'endroit idéal pour obtenir de l'aide sur une traduction difficile. Je vous recommande fortement de vous y abonner si vous souhaitez participer aux traductions.

  • La liste commentaires CHEZ traduc POINT org est destinée à recevoir les commentaires des lecteurs des documents que nous avons traduits. Son adresse doit être indiquée dans les documents traduits.

    Cette liste est ouverte aux traducteurs, relecteurs, ainsi qu'à toute personne participant au projet, mais il n'est nullement obligatoire de s'y abonner. Le débit de cette liste devrait être relativement faible.

Choisir un document à traduire est relativement simple. Il faut trouver un document :

Le projet de traduction des documents libres dispose de pages de suivi pour chaque type de document : guides pratiques (howto) et livres (LDP guides). Ces pages permettent également de réserver en ligne un document non attribué.

[Note]Note

En plus de ce projet, Traduc.org rassemble d'autres groupes de traduction, qui sont toujours à la recherche de volontaires. Jetez un œil à la page de garde du projet Traduc.org qui vous conduira à ces différents projets.

Avant de se lancer, une recherche rapide via un moteur de recherche du type Google permettra de vérifier si une version française du document n'a pas déjà été publiée. Si l'on utilise Google, il est possible de limiter sa recherche aux pages francophones, ce qui simplifie les choses.

Lorsqu'un document contient l'adresse du site personnel de son auteur, il est souvent payant d'aller y jeter un œil : celui-ci peut en effet contenir une copie ou un lien vers une traduction française déjà existante.

Afin d'éviter une duplication du travail, le projet de traduction des documents libres a mis en place une procédure permettant d'assurer le suivi des traductions.

Avant de se lancer dans une traduction, il est donc nécessaire de réserver le document auprès du coordinateur. Pour cela, il faut soit réserver le document via les pages de suivi des guides pratiques (howto) et livres (LDP guides), soit envoyer un courrier au coordinateur (), en indiquant votre nom, votre adresse électronique, quel document vous souhaitez traduire et sous quel délai vous pensez réaliser cette traduction[1].

Une fois le document réservé, vous n'avez plus qu'à attendre le feu vert du coordinateur.

Cette démarche peut être rendue obligatoire par la licence du document, mais elle est de toutes façons fortement recommandée. D'une part, elle permet d'établir un premier contact dans de bonnes conditions avec l'auteur du document, d'autre part, elle permet de s'assurer que l'auteur n'a pas connaissance d'une autre traduction en cours et qu'une nouvelle version du document n'est pas sur le point d'être publiée.

Il suffit d'envoyer un courrier électronique à l'auteur en l'informant du démarrage de la traduction, lui indiquant qu'on le tiendra informé de la publication de la version française.

Afin de faciliter le suivi des traductions, mettez en copie de ce message le coordinateur .

Ce courrier peut par exemple ressembler à ceci :

Object : French translation of the [XXXX]-HOWTO
Cc :     coordination TIRET howto CHEZ traduc POINT org

Dear [Sir or Madam]:

I would like to translate in French the [XXXX]-HOWTO.
I am contacting you as you are the [author or current maintainer]
of this document.

Before starting this translation, I would like to ask you a few
questions:

- Could you tell me if you are aware of any existing French translation,
  or any French translation being currently done?

- Are you currently working on an update to this document? If it
  is the case, could you send me a preliminary version I can
  start working on?

- And, naturally, do you agree to have us translating this
  document?

For your information, once you have agreed to this translation,
I'll start working on it. After translation, the document will
be proofread and then published by the Traduc.org French
translation project.

I will notify you as soon as the translation is completed, and
if appropriate, send you a report of the updates applied to the
French version that could be integrated into your document.

The French version of this document will be available at the
following location:
http://www.traduc.org/docs/howto/lecture/[XXXX]-HOWTO.html

Thanks a lot in advance.

Best Regards.


[Prénom Nom]
[Adresse électronique]

C'est un peu technique, mais il est important de reconnaître le format utilisé par le document à traduire afin de savoir comment le modifier et comment produire les versions finales.

Nous travaillons toujours à partir de documents SGML aux formats LinuxDoc ou DocBook et de documents XML au format DocBook. Pour identifier le format du document, il suffit de regarder ses premières lignes.

En effet, un document SGML ou XML commence toujours par une déclaration de type de document (une ligne commençant par « <!doctype »). Cette déclaration permet d'identifier le format XML ou SGML utilisé.

Le format recommandé par le projet Traduc.org est le format XML DocBook (en version 4.5).

C'est un format ouvert et libre, modifiable via un simple éditeur de texte, permettant la publication du document dans de multiples formats (entre autres texte, HTML et PDF).

Tout comme le HTML, le format XML DocBook est un format de texte balisé. Les balises définissent la structure du texte. La présentation finale du document sera déduite de ces balises grâce à l'application d'une feuille de style.

Le traducteur n'a nul besoin d'être un expert du format XML DocBook, ni de savoir comment réaliser le document final à partir du format source XML DocBook. Dans la plupart des cas, il suffira de traduire le texte autour des balises (en schématisant un peu).

[Note]Note

Pour des raisons historiques, les documents aux formats SGML DocBook (version 3 et plus) et LinuxDoc sont aussi acceptés. L'utilisation de ces formats peut simplifier la vie lors de la traduction de documents dont c'est le format d'origine.

Un document au format XML DocBook se présente en gros ainsi :

... (déclaration de la version XML et du codage utilisé) ...
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">

<article lang="fr">
  <articleinfo>
    ... (en-tête du document) ...
  </articleinfo>
  ... (corps du document) ...
</article>

L'exemple ci-dessus correspond à un document utilisant la classe article, ce qui est le cas de la majorité des guides pratiques. Des documents plus volumineux utiliseront plutôt la classe book.

Lorsque votre document sera prêt, on lui appliquera des feuilles de style DocBook pour en produire une version lisible (au format HTML ou PDF par exemple). Ces feuilles de style devront être capable de produire des textes adaptés à la langue du document. Par exemple, le résumé du document sera intitulé « Abstract » si le document est en anglais et « Résumé » si le document est en français.

Vous devrez donc, pour que votre document final soit correct, indiquer dans quelle langue il est écrit. Pour cela, il suffit de rajouter à la balise servant de racine[3] au document (<article> ou <book> l'attribut « lang="fr" » :

... (déclaration de la version XML et du codage utilisé) ...
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">

<article lang="fr">
  <articleinfo>
    ... (en-tête du document) ...
  </articleinfo>
  ... (corps du document) ...
</article>

Dans cet exemple, l'attribut « lang="fr" » de la balise <article> indique que le document devra respecter les conventions d'écriture et typographiques françaises.

Enfin, vous pouvez utiliser le codage latin 1 (connu sous le poétique sobriquet de ISO 8859-1). Ce codage devrait être compatible avec l'essentiel des outils et des systèmes d'exploitation existants.

Le codage de base de Windows pour les langues d'Europe de l'ouest (Windows-1252), notamment, est une extension du codage latin 1.

L'en-tête de votre fichier XML devra mentionner le codage utilisé pour ce document[4]. Pour ce faire, la première ligne de votre document devra être :

<?xml version="1.0" encoding="iso-8859-1"?>

Dans cet en-tête, encoding="iso-8859-1" indique que le codage utilisé est le codage ISO 8859-1 dit latin 1.

Il vous suffit alors d'entrer votre texte en utilisant les caractères accentués normaux de votre clavier. Les seuls caractères français auxquels vous devrez faire attention sont les caractères « Œ », « œ », « Ÿ » et le symbole «  ». En effet, ces caractères avaient été oubliés lors de la définition du codage latin 1 (et l'Euro n'était pas encore à l'ordre du jour). Ces caractères ne peuvent donc pas être saisis directement mais doivent être représentés de la façon suivante :


Le tableau ci-dessous résume les règles de présentation de la ponctuation applicables au français. On retiendra notamment que l'on fait précéder d'une espace fine insécable[5] les points-virgules, points d'exclamation et points d'interrogation et d'une espace mot insécable[6] les deux-points.


Certaines balises (comme <revremark>) ne permettent pas l'emploi de la balise <quote>. Dans un tel cas, il faudra directement utiliser les caractères représentant les guillemets et des espaces insécables :


[Important]Important

Le choix d'un titre français clair, compréhensible et qui donne envie de lire le document est crucial.

Le titre est souvent perçu par le traducteur comme quelque chose d'accessoire. Il est oublié ou traité à la va-vite. Pourtant, c'est lui qui décidera avant tout le reste de l'utilité d'un document.

En effet, l'adaptation française d'un document dont le titre est bâclé, incompréhensible ou non traduit ne sera tout simplement pas lue. Ceci, du fait que la lecture du titre n'éveillera ni la curiosité, ni l'intérêt du lecteur !

  • Lu isolément, le titre doit donner une idée claire du sujet du document, car il sera repris dans des index ne contenant pas forcément de résumé.

  • Le projet de documentation Linux (LDP) a défini 2 formats de documents, qui composent l'essentiel de sa production.

    Les howto sont en règle générale des documents pratiques présentant la marche à suivre pour réaliser un objectif précis. Les LDP guides sont eux des livres complets couvrant un thème spécifique.

    Le LDP disposait également auparavant d'un troisième format, qui a maintenant été fusionné avec les howto : les mini-howto. Ce terme se retrouve encore dans le titre de certains documents.

    Ces trois noms de formats, que ce soit dans le titre ou dans le corps du texte, seront systématiquement traduits en français de la façon suivante :

    AnglaisFrançais
    Mini-howtoPetit guide
    HowtoGuide pratique
    LDP guideLivre
  • Enfin, indiquez en sous-titre le nom original du document.

    Cela permettra d'une part d'indiquer clairement l'origine de ce document, sans avoir à recourir à un titre en franglais. Cela facilitera également la recherche de la version française d'un document à partir des moteurs de recherche.

Voici un exemple de traduction de titre, qui peut servir de modèle. Le titre original suivant :

<articleinfo>
  ...
  <title>
     Online Troubleshooting Resources HOWTO
  </title>
  ...
</articleinfo>

pourra être traduit par :

<articleinfo>
  ...
  <title>
     Guide pratique du dépannage via Internet
  </title>
  <subtitle>
     Version française du <foreignphrase lang="en">Online 
     Troubleshooting Resources HOWTO</foreignphrase>
  </subtitle>
  ...
</articleinfo>

Afin que le lecteur puisse toujours savoir quelle version du document il est en train de consulter, toute version française publiée doit comporter son propre numéro de version. Le seul examen du numéro de version doit toujours permettre de différencier deux versions françaises du même document.

Ce numéro de version doit être différent du numéro de la version originale, afin de pouvoir sans risque de confusion mettre à jour la version française (par exemple pour corriger une erreur) alors que la version originale n'a pas évoluée.

Afin de permettre au lecteur de repérer en un clin d'œil quelle version du document original correspond à ce document, nous avons choisi de construire le numéro de la version française à partir du numéro de la version originale.

Nous avons donc adopté la convention suivante : le numéro de la version française est constituée du numéro de la version originale suivi de « .fr. » suivi du numéro de la version française relatif à cette version originale.


Ce système permet notamment, si le besoin s'en fait sentir, de continuer à mettre à jour une ancienne version.

La version sera indiquée par une balise <releaseinfo> :

<articleinfo>
  ...
  <releaseinfo>Version&nbsp;: 3.0.fr.1.1</releaseinfo>
  ...
</articleinfo>

L'historique des révisions permet à un lecteur d'identifier facilement les modification faites par les nouvelles versions d'un document. Chaque document publié doit comporter un historique des révisions, que la version originale en comporte un ou non.

Pour l'historique des révisions, respectez les règles de présentation suivantes :

Ce qui donnera par exemple :

<articleinfo>
  ...
  <revhistory>
    <revision>
      <revnumber>0.2.fr.1.0</revnumber>
      <date>2003-12-20</date>
      <authorinitials>BLC,AM</authorinitials>
      <revremark>Première traduction française</revremark>
    </revision>
    <revision>
      <revnumber>0.2</revnumber>
      <date>2002-10-08</date>
      <authorinitials>JS</authorinitials>
      <revremark>
          Ajout d'une partie consacrée aux inverseurs de polarité.
          <emphasis lang="en">[7]Added a part on polarity
          reversers.</emphasis>
      </revremark>
    </revision>
  ...
  </revhistory>
  ...
</articleinfo>

La licence du document est un point auquel il faut faire particulièrement attention. Lors de sa traduction, il faut notamment comprendre et respecter les points suivants :

Les documents originaux comportent souvent une mention du style :

<section>
<title>
    Feedback and corrections
</title>
<para>
    If you have questions or comments about this document, please
    feel free to contact the author at 
    <email>tylor@corbeaunoir.org</email>.
</para>
</section>

Ici, plusieurs remarques s'imposent :

Le document traduit pourrait donc ressembler à ceci :

<section>
<title>
    Commentaires et corrections
</title>
<para>
     
     Merci de faire parvenir en anglais à l'auteur vos questions
     et commentaires relatifs à la version originale de ce
     document à l'adresse
     
     <email>tylor CHEZ corbeaunoir POINT org</email>.
     
</para>
<para>
    
    N'hésitez pas à faire parvenir vos commentaires et suggestions
    concernant l'adaptation française de ce document au projet
    <ulink url="http://traduc.org">Traduc.org</ulink> à
    l'adresse&nbsp;:
    
    <email>commentaires CHEZ traduc POINT org</email>.

</para>
</section>

Le document original comporte souvent un lien vers le site de l'auteur ou du projet qui l'a créé. Ce lien permet aux lecteurs de retrouver la version la plus à jour du document.

Le lien vers le document original doit être conservé, en précisant bien qu'il s'agit d'un lien vers la version originale. Cependant, on rajoutera systématiquement un lien vers l'emplacement officiel de la version française, afin que le lecteur puisse se reporter à sa plus récente version.

Dans le cas des guides pratiques, on utilisera pour la plus récente version française le lien stable vers celle-ci.

Par exemple :

<title>
Latest version of this document
</title>

<para>
The latest version of this document can always be found at <ulink 
url="http://www.tldp.org/HOWTO/nom_original_du_guide.html/>.
</para>

sera traduit par :

<title>
Nouvelles versions de ce document
</title>

<para>
Vous trouverez la plus récente version française de ce document à 
l'adresse&nbsp;: <ulink url="&howto;nom_original_du_guide.html"/>
</para>

<para>
La plus récente version originale de ce document est disponible à 
l'adresse&nbsp;: <ulink 
url="http://www.tldp.org/HOWTO/nom_original_du_guide.html/>.
</para>

Le site traduc.org offre une adresse de lecture stable pour tous les guides pratiques (howto) du projet de documentation Linux (LDP). Cette adresse de lecture stable offre l'avantage de présenter au lecteur, d'une manière dynamique, la version française si elle est disponible et si ce n'est pas le cas la version anglaise.

Ce système évite d'avoir à mettre à jour tous les documents qui font référence à un guide pratique lorsque celui-ci est traduit.

Pour utiliser ce système, il suffira de remplacer le lien vers le guide pratique par un lien vers :

<!-- Cas d'un guide pratique (howto) -->
<ulink 
url="http://www.traduc.org/docs/howto/lecture/nom_original.html"/>

<!-- Cas d'un livre (LDP guide) -->
<ulink 
url="http://www.traduc.org/docs/guides/lecture/nom_original/"/>

Ce court chapitre ne va pas parler d'adaptation française, une fois n'est pas coutume, mais de présentation et de rendu final. En effet, les blocs de texte littéral (<programlisting>, <screen>, <synopsis> et <literallayout> notamment) de par leurs caractéristiques doivent être modifiés avec précautions, afin d'éviter qu'ils ne soient illisibles dans la version française.

Dans les blocs de texte littéral, contrairement aux textes d'un document XML en général, chaque espace compte ! Chacun des espaces et des passages à la ligne inclus entre les balises de début et de fin de bloc sera pris en compte pour le rendu du document final.

Par exemple :

<programlisting>$ cd "$CHEMIN"
                $ mkdir "Mon dossier"
</programlisting>

deviendra, dans le document final :

$ cd "$CHEMIN"
                $ mkdir "Mon dossier"

ce qui n'est pas forcément le but recherché ^_^

[Important]Important

Un bloc de texte littéral doit donc être présenté dans le fichier source tel qu'il devra apparaître dans le document final.

Pour ces blocs de texte littéral, je vous recommande d'essayer d'adopter toujours la même présentation :

...
</para> (1)

<programlisting> (2)
BEGIN { (3)
    MOIS["janvier"]=1
    MOIS["février"]=2
    MOIS["mars"]=3
    MOIS["avril"]=4
    MOIS["mai"]=5
    MOIS["juin"]=6
    MOIS["juillet"]=7
    MOIS["août"]=8
    MOIS["septembre"]=9
    MOIS["octobre"]=10
    MOIS["novembre"]=11
    MOIS["décembre"]=12
}

{
    gsub( "er" , "" , $1 )
    if ($2 in MOIS) print $3 "-" MOIS[$2] "-" $1
    else print $0
} (4)
</programlisting> (5)

<para> (6)
...

16

Le bloc de texte littéral ne sera en général pas inclus dans un paragraphe, mais sera utilisé comme un bloc indépendant entre des paragraphes fermés.

2

La balise initiale est placée seule en début de ligne, sans être précédée d'espace. Le texte littéral commence à la ligne suivante.

3

Le texte littéral commence à la ligne suivant immédiatement la balise de début de bloc. Il est collé au début de la ligne — autrement dit, il n'est pas précédé d'espace. Rien n'empêche par contre que le texte lui-même soit indenté pour être plus lisible.

4

Le texte littéral se termine immédiatement avant la balise de fin de bloc, sans laisser de ligne blanche entre les deux.

5

La balise finale, comme la balise initiale, est placée seule en début de ligne, sur la ligne suivant immédiatement la dernière ligne du bloc.

Autre point, la largeur des blocs de texte littéral ne doit pas dépasser 66 colonnes. En effet, si le texte est trop long, il risque de déborder sur les marges et d'être coupé dans les versions imprimables (Postcript, PDF).

Attention cependant, redécouper des scripts ou des programmes demande de comprendre le langage utilisé, que le programme redécoupé soit syntaxiquement équivalent au programme original. Bref, que le programme fonctionne toujours ^_^

Je vous recommande de vérifier au fur et à mesure le rendu final des blocs de texte littéral, par exemple en produisant une version HTML du document. De plus, avant de finir le document, essayez de systématiquement produire une version d'impression (PostScript ou PDF) afin de vérifier le bon rendu des blocs littéraux.

Il est important de traduire les captures d'écrans et les exemples afin que la version présentée corresponde à l'utilisation de la version française.

Il ne faut donc pas traduire les captures d'écran directement, par exemple avec un logiciel de dessin, mais réaliser les même captures d'écran sur la version française du logiciel (si elle existe).

Dans le cas de commandes en mode texte, c'est la même chose. Les exemples doivent être montrés avec la version française du logiciel.

Par exemple :

$ df -h
Filesystem            Size  Used Avail Use% Mounted on
/dev/hda1              18G  2,4G   15G  15% /
/dev/hda4              38M  8,9M   28M  25% /boot

deviendra :

$ df -h
Sys. de fich.         Tail. Occ. Disp. %Occ. Monté sur
/dev/hda1              18G  2,5G   15G  15% /
/dev/hda4              38M  8,9M   28M  25% /boot

Pour choisir la langue utilisée par une commande lancée depuis un terminal, il suffit de faire précéder la commande de LANGUAGE=en pour obtenir la version anglaise et de LANGUAGE=fr pour obtenir la version française.

Par exemple, pour obtenir la version originale de la commande df, il suffira d'entrer la commande suivante :

LANGUAGE=en df

Ce qui aura pour effet de donner à la variable d'environnement LANGUAGE la valeur indiquée pour l'exécution de cette commande. Cette variable d'environnement est utilisée par gettext pour déterminer quelle langage utiliser pour communiquer avec l'utilisateur. C correspond à la version originale, en à la version anglaise et fr à la version française.

L'étape de la relecture doit permettre de vérifier le document, autant sur la forme que sur le fond. Cette étape peut être réalisée par une seule personne, mais il est intéressant de faire relire le document par plusieurs personnes ayant des profils différents :

Deux types de relecture doivent être réalisées. Tout d'abord, la version française doit être relue en parallèle de la version originale (ce qui sera plutôt fait par un relecteur ayant un profil de traducteur). Ensuite, une fois que la version française donne satisfaction par rapport à la version originale, elle doit être relue indépendamment.

Relire la version française indépendamment de la version originale est indispensable pour s'assurer que le document traduit sera clair et compréhensible par un francophone.

A. Patron DocBook

Ce patron présente un exemple commenté de l'en-tête d'un document XML DocBook. Il reprend tous les éléments de l'en-tête d'une traduction française placés dans leur contexte.

<?xml version="1.0" encoding="iso-8859-15"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY howto      "http://www.traduc.org/docs/howto/lecture/">
<!ENTITY guide      "http://www.traduc.org/docs/guides/lecture/">
<!ENTITY traduc     "http://www.traduc.org">
]>

<article lang="fr">

<articleinfo>

  <!--
      Merci à Simon Depiets qui a réalisé la version initiale de
      ce patron.
   -->


  <!-- Titre et sous-titre -->

  <!--
      Si vous voulez être sûr que votre document soit lu,
      assurez-vous que le titre français du document soit
      simple, clair et compréhensible. Garder le titre
      original n'est en général pas un bon choix.
    -->

  <title>

     Petit guide d'exemple de structure XML DocBook

  </title>

  <subtitle>
  
     Version française du <foreignphrase lang="en">DocBook 
     Structure Example Mini-HOWTO</foreignphrase>
  
  </subtitle>

  <!--
      On conserve toujours la mention du titre original en
      sous-titre afin de rendre le document plus facile à trouver
      par une recherche réalisée à partir du titre original.
   -->
  

  <!-- Version et date de la version française -->
  
  <releaseinfo>Version&nbsp;: 0.6.fr.1.0</releaseinfo>  

  <pubdate>1er août 2004</pubdate>

  <!-- 
      La date du document doit être en clair (i. e. en français)
   -->


  <!-- Auteurs, traducteurs et relecteurs -->

  <author>
     <firstname>Jeffrey</firstname>
     <surname>Sinclair</surname>
     <email>jeff CHEZ bab POINT com</email>
  </author>

  <othercredit role="traduction" class="translator">
     <firstname>Brice</firstname>
     <surname>Le Creurer</surname>
     <contrib>Adaptation française</contrib>
     <email>brice CHEZ grandcroix POINT net</email>
  </othercredit>

  <othercredit role="relecture" class="translator">
    <firstname>Alice</firstname>
    <surname>Martin</surname>
    <contrib>Relecture de la version française</contrib>
    <email>alice CHEZ ouebe POINT org</email>
  </othercredit>


  <!-- Historique des révisions -->

  <revhistory>

    <revision>
      <revnumber>0.6.fr.1.0</revnumber>
      <date>2004-08-01</date>

      <!--
          Les dates de l'historique des révisions doivent
          utiliser le format Iso : « aaaa-mm-jj » avec
          aaaa = année sur 4 chiffres,
          mm = mois sur 2 chiffres et
          jj = jour sur 2 chiffres.
        -->

      <authorinitials>BLC, AM</authorinitials>
      <revremark>Première traduction française.</revremark>
    </revision>

    <revision>
      <revnumber>0.6</revnumber>
      <date>2003-06-17</date>
      <authorinitials>JS</authorinitials>
      <revremark>

          Quelques corrections pour que le document aie une
          structure valide. <emphasis lang="en">Some
          fixes to get a valid document structure.</emphasis>

          <!--
              Si la licence l'exige — c'est par exemple le cas de
              la licence de documentation libre GNU (GFDL) —
              il est nécessaire de conserver une copie du texte de 
              l'historique des révision en version originale.
           -->
    
      </revremark>
    </revision>
    
    <revision>
      <revnumber>0.4</revnumber>
      <date>2002-02-20</date>
      <authorinitials>JS</authorinitials>
      <revremark>

          Version initiale. <emphasis lang="en">Initial 
          revision.</emphasis>

      </revremark>
    
    </revision>

  </revhistory>


  <!-- Résumé du document -->   

  <abstract><para>
    
      Ce document est un document d'exemple donnant la structure
      de base d'une traduction française rédigée selon le format
      XML DocBook. Ce document n'est pas intéressant en lui-même.
      Tout son intérêt tient en son code source (^_^).
    
      <!--
          Ce résumé doit être clair et pouvoir être compris hors
          du contexte du document
        -->

  </para></abstract>

</articleinfo>

<section>
  <title>
      Commentaires et corrections
  </title>

  <para>

       Merci de faire parvenir en anglais à l'auteur vos questions
       et commentaires relatifs à la version originale de ce
       document à l'adresse

       <email>jeff CHEZ bab POINT com</email>.

  </para>
  <para>

      N'hésitez pas à faire parvenir vos commentaires et suggestions
      concernant l'adaptation française de ce document au projet
      <ulink url="&traduc;">Traduc.org</ulink> à
      l'adresse&nbsp;:

      <email>commentaires CHEZ traduc POINT org</email>.

  </para>
</section>

<section>

  <title>
      Nouvelles versions de ce document
  </title>

  <para>

      Vous trouverez la plus récente version française de ce document à
      l'adresse&nbsp;: <ulink url="&howto;patron.html"/>.

  </para>

  <para>
      
      La plus récente version originale de ce document est disponible à
      l'adresse&nbsp;: <ulink
      url="http://www.tldp.org/HOWTO/patron.html"/>.
  
  </para>
</section>

<section>

  <title>
      Reste du document
  </title>

  <para>

      Bla bla bla bla bla bla bla bla bla bla bla bla bla bla
      bla bla bla bla bla bla bla bla bla bla bla bla bla bla
      bla bla bla bla bla bla bla bla bla bla bla bla bla bla
      bla bla bla bla bla bla bla bla bla bla bla bla bla bla
      bla bla bla bla bla bla bla bla bla bla bla bla.

  </para>

  <para>

      Bla bla bla bla bla bla bla bla bla bla bla bla bla bla
      bla bla bla bla bla bla bla bla bla bla bla bla bla bla
      bla bla bla bla bla bla bla bla.

  </para>

  <para>

      Bla bla bla bla bla bla bla bla bla bla bla bla bla bla
      bla bla bla bla bla bla bla bla bla bla bla bla bla bla
      bla bla bla bla bla bla bla bla bla bla bla bla bla bla
      bla bla bla bla.

  </para>

</section>

</article>

B.  Produire simplement une version HTML d'un document XML DocBook

Vous devez disposer des paquets suivants[8] :

docbook-xml

Les définitions de type de document (DTD) décrivant le format DocBook. Ils sont disponibles sur le site du consortium OASIS : http://www.oasis-open.org/docbook/xml/4.5/.

docbook-xsl

Les feuilles de style XSLT de base du format DocBook. Elle permettent notamment la production de versions HTML de documents au format XML DocBook. Elles sont disponibles sur : http://docbook.sourceforge.net.

xsltproc

La commande xsltproc permet d'appliquer une feuille de style XSLT à un document XML pour produire un document final (par exemple au format HTML).

Pour produire une version HTML, vous devrez simplement indiquer à xsltproc l'emplacement de la feuille de style utilisée (appelée xhtml/docbook.xsl) et le nom du fichier source XML :

xsltproc feuille_de_style.xsl document.xml > document.html

Par exemple, chez moi, j'utilise la commande suivante :

FEUILLE_DE_STYLE="/usr/share/xml/docbook/stylesheet/nwalsh/xhtml/docbook.xsl"
xsltproc "${FEUILLE_DE_STYLE}" document.xml > document.html

Et voilà ! C'est fini. Vous disposez maintenant d'une version HTML de votre document.

Il est possible d'améliorer le rendu du document produit en utilisant certaines options de la feuille de style XSL DocBook. Du fait de l'ajout de ces options, la ligne de commande peut devenir un peu longue. Pour simplifier, j'ai donc préparé un petit script qui rassemble toutes les options que j'utilise.

#!/bin/bash

# On s'arrête en cas d'erreur

set -e

# Vérification du nombre de paramètres

if [ "$#" -ne 1 ] ; then

    echo
    echo "Script de production d'une version HTML d'un document XML DocBook."
    echo
    echo "Utilisation :"
    echo "$(basename $0) document.xml"
    echo
    exit 1

fi

# Définition des fichiers à utiliser

SOURCE_XML="$1"
DOCUMENT_HTML="${1%.xml}.html"

# Feuille de style XSL (à personnaliser)

FEUILLE_DE_STYLE_XSL="/usr/share/xml/docbook/stylesheet/nwalsh/xhtml/docbook.xsl"

# Vérification de l'existence du document XML source

if [ ! -f "${SOURCE_XML}" ] ; then

    echo
    echo "Erreur : fichier ${SOURCE_XML} introuvable !"
    echo
    exit 1

fi

# Vérification de la structure du document

echo "Vérification de la structure de ${SOURCE_XML}"

xmllint --valid --noout "${SOURCE_XML}"

# Production de la version HTML

echo "Production de la version HTML de ${SOURCE_XML}"

xsltproc --stringparam "admon.graphics" "1" \
         --stringparam "html.stylesheet" "style.css" \
         --stringparam "css.decoration" "0" \
         --stringparam "blurb.on.titlepage.enabled" "1" \
         --stringparam "contrib.inline.enabled" "0" \
         --stringparam "make.valid.html" "1" \
         --stringparam "make.year.ranges" "1" \
         --stringparam "html.cleanup" "1" \
         --stringparam "section.autolabel" "1" \
         "${FEUILLE_DE_STYLE_XSL}" "${SOURCE_XML}" \
         > "${DOCUMENT_HTML}"

echo "Terminé"
  • L'option html.stylesheet permet d'obtenir un document HTML dont le rendu est personnalisable à l'aide de la feuille de style CSS indiquée.

    Grâce à cette option, vous pourrez améliorer le rendu du document simplement en récupérant la feuille de style CSS du projet Traduc.org http://tigreraye.org/style.css (ou une autre feuille de style CSS pour DocBook) et en la plaçant au même endroit que le fichier HTML :

    wget http://tigreraye.org/style.css
    
  • L'option admon.graphics permet d'activer l'utilisation d'images pour les avertissements et les mises en garde. Cette option modifie le fichier HTML pour qu'il utilise ces images, mais ne les installe pas. Il faut donc recopier le répertoire images contenu dans le répertoire des feuilles de style XSL DocBook à côté de votre document.

    Si vous ne voulez pas utiliser ces images, il vous suffit d'indiquer "0" comme valeur de l'option admon.graphics.

C.  Production de la version HTML de ce guide pratique

Ce chapitre explique quels outils utiliser, comment les installer et se termine par la commande permettant la production de la version HTML de ce guide pratique. La bibliothèque libxml2 et ses outils associés sont supposés installés sur votre machine. Les commandes nécessaire à la production des autres formats sont laissées en exercice pour le lecteur (^_^)

L'outil utilisé pour produire la version HTML de ce guide pratique est la version Java 2 de Xalan.

[Note]Note

Xsltproc, bien qu'il soit plus simple à utiliser, ne permet pas de produire une version complètement correcte de ce document. En effet, ce document utilise, dans un extrait de code, des icônes numérotées de renvois (callout). Le rendu de ces icônes n'est pas possible sans utiliser de bibliothèques d'extensions complémentaires, ce qui est notamment possible avec Xalan et Saxon.

Dans les étapes qui suivent, lorsque nous installerons de nouveaux outils, nous les installerons dans le répertoire ~/outils-docbook/, c'est-à-dire dans un sous-répertoire créé pour l'occasion dans votre répertoire personnel. Si vous êtes administrateur de votre machine, vous devrez extrapoler à partir de ces instructions d'installation afin de réaliser une installation globale accessible à tous vos utilisateurs.

Nous allons commencer par installer le DTD[2] XML DocBook. Téléchargez sur http://www.oasis-open.org/docbook/xml/4.5/ l'archive zip contenant le DTD et installez-le comme suit :

# Définition du répertoire cible de l'installation
CIBLE="$HOME/outils-docbook"

# Création du dossier où installer le DTD
mkdir -p "$CIBLE/docbook-xml-4.5/"

# Décompression de l'archive
unzip docbook-xml-4.5.zip -d "$CIBLE/docbook-xml-4.5/"

# Création d'un lien logique docbook-xml
cd "$CIBLE"
ln -s docbook-xml-4.5 docbook-xml

# Retour dans votre répertoire personnel
cd

Pour utiliser ce DTD, vous devrez modifier la variable d'environnement XML_CATALOG_FILES :

export XML_CATALOG_FILES="$HOME/outils-docbook/docbook-xml/catalog.xml $XML_CATALOG_FILES"

Cette commande devra être répétée à chaque nouvelle session. Pour simplifier les choses, ajoutez cette commande à vos scripts de production ou à vos scripts de début de session.

Il nous faut maintenant installer la feuille de style XSL utilisée pour transformer le XML DocBook en HTML. Téléchargez les feuilles de style XSL sur : http://docbook.sourceforge.net et installez-les comme suit :

# Décompression et installation de l'archive
tar -xvjf docbook-xsl-1.70.0.tar.bz2 -C "$CIBLE"

# Création d'un lien logique docbook-xsl
cd "$CIBLE"
ln -s docbook-xsl-1.70.0 docbook-xsl

# Installation de la feuille de style
cd docbook-xsl
sh install.sh

# Retour dans votre répertoire personnel
cd

Téléchargez la feuille de style personnalisée du Projet de documentation Linux (LDP) sur http://www.happy-monkey.net/docbook/ et installez-la comme suit :

# Décompresser l'archive
tar xvzf tldp-xsl-04MAR2005.tar.gz

# Recopier la feuille de style personnalisée du LDP
# avec la feuille de style XSL DocBook
cp -Rv tldp-xsl-04MAR2005/* "$CIBLE/docbook-xsl/"

Vous n'avez plus besoin de conserver le dossier tldp-xsl-04MAR2005/ après cela.

Nous allons maintenant télécharger et installer l'environnement d'exécution Java. Vous pourrez le télécharger sur le site de Sun : http://java.sun.com/javase/.

# Déplacez l'archive dans le répertoire d'installation
mv jre-1_5_0_06-linux-i586.bin "$CIBLE"

# Exécutez l'installation
cd "$CIBLE"
sh jre-1_5_0_06-linux-i586.bin

# Créez un lien vers la version courante de Java
ln -s jre1.5.0_06 jre

# Retour dans votre répertoire personnel
cd

Pour utiliser ce moteur d'exécution, vous devrez définir la variable d'environnement suivante :

export JAVA_HOME="$HOME/outils-docbook/jre"

Nous allons maintenant installer le logiciel Xalan lui-même. Ce logiciel est disponible sur http://xml.apache.org/xalan-j/index.html. Téléchargez la version binaire de Xalan-J 2.7.0 et installez-la comme ceci :

# Définition du chemin vers l'environnement d'exécution Java
JAVA_HOME="$CIBLE/jre1.5.0_06"

# Décompression de l'archive
tar xvzf xalan-j_2_7_0-bin.tar.gz

# Installation de Xalan dans l'environnement d'exécution Java
cd xalan-j_2_7_0/bin
cp xalan.jar xercesImpl.jar xml-apis.jar "$JAVA_HOME/lib/ext/"

# Retour dans votre répertoire personnel
cd

Une fois cette dernière étape faite, vous n'aurez plus besoin de conserver le dossier xalan-j_2_7_0.

Il ne reste plus qu'à produire la version HTML avec la commande appropriée :

# Répertoire d'installation des outils DocBook

OUTILS_DOCBOOK="$HOME/outils-docbook"

# Répertoire local d'installation de Java

JAVA_HOME="$OUTILS_DOCBOOK/jre"

# Répertoire d'installation des catalogues XML
#
# - Le premier correspond au catalogue du DTD XML
#   DocBook installé en local.
#
# - Le second correspond au catalogue des feuilles
#   de style XSL installées en local.

XML_CATALOG_FILES="$OUTILS_DOCBOOK/docbook-xml/catalog.xml $XML_CATALOG_FILES"

# Extensions Java des feuilles de style XSL écrites pour Xalan

EXTENSIONS_XALAN="$OUTILS_DOCBOOK/docbook-xsl/extensions/xalan27.jar"

# Feuille de style XSL personnalisée du Projet de documentation Linux

XSL_LDP_MONOHTML="$OUTILS_DOCBOOK/docbook-xsl/html/tldp-one-page.xsl"

# Production de la version HTML

$JAVA_HOME/bin/java -classpath "$EXTENSIONS_XALAN" \
    org.apache.xalan.xslt.Process \
    -IN "Petit-guide-du-traducteur.xml" \
    -OUT "Petit-guide-du-traducteur.html" \
    -XSL "$XSL_LDP_MONOHTML" \
    -PARAM "admon.graphics" "1" \
    -PARAM "use.extensions" "1" \
    -PARAM "callouts.extensions" "1"

En cas de problème, vous pouvez vérifier que votre installation est correcte avec la commande suivante :

# Répertoire d'installation des outils DocBook

OUTILS_DOCBOOK="$HOME/outils-docbook"

# Répertoire local d'installation de Java

JAVA_HOME="$OUTILS_DOCBOOK/jre"

# Extensions Java des feuilles de style XSL écrites pour Xalan

EXTENSIONS_XALAN="$OUTILS_DOCBOOK/docbook-xsl/extensions/xalan25.jar"

# Production de la version HTML

$JAVA_HOME/bin/java -classpath "$EXTENSIONS_XALAN" \
    org.apache.xalan.xslt.EnvironmentCheck

Une fois le document HTML créé, il ne vous reste plus qu'à récupérer la feuille de style CSS du projet Traduc.org http://tigreraye.org/style.css et les images correspondant aux icônes utilisées. Pour les installer, recopiez la feuille de style style.css et le dossier ~/outils-docbook/docbook-xsl/images/ au même endroit que le fichier HTML :

wget http://tigreraye.org/style.css
cp -Rv ~/outils-docbook/docbook-xsl/images .

D.  Aide-mémoire des licences libres

[Avertissement]Attention !

Cet aide-mémoire ne vous dispense pas de lire complètement la licence d'un document avant d'en commencer la traduction ! Lire la licence d'un document vous permettra de connaître les conditions selon lesquels un document peut être traduit et sa traduction diffusée.

La traduction d'un document est une version modifiée de sa version originale. Donc une licence interdisant la diffusion d'une version modifiée interdit également d'en diffuser une traduction !

La licence de documentation libre GNU [GFDL] est une licence plutôt bien conçue pour la diffusion de documents. Elle est par contre assez lourde pour les documents traduits, car elle oblige à conserver les versions originales d'un certain nombre de passages. De plus, il n'existe pas de version française officielle de cette licence, donc, pour bien faire, la version française doit inclure une copie de la licence officielle en version originale et une copie de sa version française officieuse.

Les principaux points à respecter sont les suivants :

  • Le titre de la version française doit être différent du titre original (cf. Section 3.7, « Le titre ») ;

  • le nom des personnes ayant collaboré à cette traduction doit être clairement indiqué dans la page de titre (cf. Section 3.8, « Le nom du traducteur et du relecteur ») ;

  • dans la page de titre, le nom de l'éditeur original doit être remplacé par l'éditeur de la version française (i. e. si le document est publié par le Projet de documentation Linux (LDP), la version française sera par exemple publiée par Traduc.org — la version française ne doit pas indiquer qu'elle est publiée par le Projet de documentation Linux à moins que le projet de documentation Linux n'aie directement publié cette traduction.)

  • Toutes les mentions de copyright, de droits d'auteurs, de droits d'utilisations et de limitations de responsabilités (disclaimer) doivent être préservées en version originale dans le document. Le cas échéant, afin que les lecteurs francophones puissent comprendre ce dont il s'agit, nous vous recommandons fortement d'inclure une version française de ces éléments, en indiquant que seule la version originale fait foi (cf Section 3.13, « La licence du document ») ;

  • la version française doit inclure une copie non modifiée du texte de la licence (GFDL) et, si possible, une copie de sa version française officieuse indiquée comme telle ;

  • la version française du document doit comporter un historique des révisions reprenant le texte en version originale de l'historique et comprenant une entrée additionnelle pour la version française (cf. Section 3.11, « L'historique des révisions ») ;

  • la version française doit inclure les liens vers la version originale de référence qui se trouvaient dans la version originale.

E. Licence Art libre

Avec cette Licence Art libre, l'autorisation est donnée de copier, de diffuser et de transformer librement les œuvres dans le respect des droits de l'auteur.

Loin d'ignorer les droits de l'auteur, cette licence les reconnaît et les protège. Elle en reformule le principe en permettant au public de faire un usage créatif des œuvres d'art.

Alors que l'usage fait du droit de la propriété littéraire et artistique conduit à restreindre l'accès du public à l'œuvre, la Licence Art libre a pour but de le favoriser.

L'intention est d'ouvrir l'accès et d'autoriser l'utilisation des ressources d'une œuvre par le plus grand nombre. En avoir jouissance pour en multiplier les réjouissances, créer de nouvelles conditions de création pour amplifier les possibilités de création. Dans le respect des auteurs avec la reconnaissance et la défense de leur droit moral.

En effet, avec la venue du numérique, l'invention de l'internet et des logiciels libres, un nouveau mode de création et de production est apparu. Il est aussi l'amplification de ce qui a été expérimenté par nombre d'artistes contemporains.

Le savoir et la création sont des ressources qui doivent demeurer libres pour être encore véritablement du savoir et de la création. C'est à dire rester une recherche fondamentale qui ne soit pas directement liée à une application concrète. Créer c'est découvrir l'inconnu, c'est inventer le réel avant tout souci de réalisme.

Ainsi, l'objet de l'art n'est pas confondu avec l'objet d'art fini et défini comme tel.

C'est la raison essentielle de cette Licence Art libre : promouvoir et protéger des pratiques artistiques libérées des seules règles de l'économie de marché.

Cette œuvre est soumise au droit d'auteur et l'auteur par cette licence vous indique quelles sont vos libertés pour la copier, la diffuser et la modifier :



[1] Si vous n'avez aucune idée du délai nécessaire, ce n'est pas grave, c'est juste à titre indicatif de toutes façons ^_^

[2] Un DTD est une Définition de Type de Document. Il sert de définition à un format XML en définissant quelles balises sont reconnues et comment et dans quel contexte les employer.

[3] La balise racine du document est la première balise du document. Elle s'ouvre pour commencer le document et se ferme lorsque celui-ci se termine.

[4] Les documents SGML aux formats LinuxDoc et DocBook utilisent par défaut le codage latin 1.

[5] En théorie, représentée par l'entité &thinsp;. Cependant, pour des raisons de compatibilité, nous utilisons pour l'instant l'entité &nbsp; pour représenter une espace fine.

[6] Représentée par l'entité &nbsp;.

[7] On utilise ici <emphasis> à la place de <foreignphrase> car cette dernière balise est interdite à l'intérieur des commentaires relatifs à une révision. De même, les balise <quote> et </quote> devraient ici être remplacée par respectivement «&nbsp; et &nbsp;».

[8] Le nom de ces paquets peut varier selon la distribution Linux utilisée.