--
.~. Nicolas Bertolissio
/V\ [EMAIL PROTECTED]
// \\
/( )\
^`~'^ Debian GNU-Linux
#use wml::debian::template title="Usage pour le HTML des pages du site de Debian" BARETITLE=true
#use wml::debian::common_tags
#use wml::debian::acronyms
#use wml::debian::toc
#use wml::debian::translation-check translation="1.9" translation_maintainer="Nicolas Bertolissio"
<p>
Cette page est toujours à l'état de brouillon.
</p>
<toc-display/>
<toc-add-entry name="preface">Préface</toc-add-entry>
<p>
Cette page est là pour aider les auteurs et les traducteurs à bien former les
pages. Elle contient des astuces sur l'utilisation des balises et sur la
manière de créer de nouvelles pages de les rendre plus facile à traduire.
</p>
<toc-add-entry name="general">Quelques astuces générales</toc-add-entry>
<p>
Voici une liste de conseils généraux pour les nouvelles pages ou les nouvelles
traductions.
</p>
<dl>
<dt>Ne pas utiliser de longues lignes</dt>
<dd>
Les lignes des fichiers wml et des autres fichiers devraient rentrer dans
une fenêtre de terminal standard. C'est plus facile pour l'édition dans vi,
plus simple d'y faire des recherches et plus aisé à traduire. C'est
également important car CVS est orienté lignes et qu'il est plus difficile
de résoudre des conflits dans de longues lignes.
</dd>
<dt>Placer les balises sur des lignes séparées si possible</dt>
<dd>
La plupart des balises HTML peuvent être placées sur des lignes séparées.
Cela comprend <div>, <p>, <table> et <ul>. Pour
rendre les choses plus faciles aux traducteurs, vous devriez placer toutes
les balises qui peuvent être utilisées de cette façon sur des lignes
séparées. Sinon les traducteurs pourraient effacer accidentellement ces
balises et oublier de les remettre dans leur traduction.
</dd>
<dt>Ne pas utiliser d'espaces ou de sauts de lignes dans les balises situées
dans le texte</dt>
<dd>
Certaines balises produisent un espace si elles sont placées sur des lignes
séparées. Par exemple la balise <q> utilisée pour de courtes
citations et des extraits. Vous ne pouvez les séparer sur une ligne que
comme un tout avec leur contenu. Il peut aussi y avoir un espace entre le
contenu et la balise et le reste de la page HTML. À l'intérieur de ces
balises vous pouvez avoir autant de sauts de lignes ou d'espaces que vous
le souhaitez entre les mots.
</dd>
</dl>
<toc-add-entry name="abbreviations">Abréviations et acronymes</toc-add-entry>
<p>
Pour les abréviations et les acronymes, la balise HTML <acronym> devrait
être utilisée. Il y a deux raisons pour ne pas recommander l'utilisation de la
balise <abbr> : d'abord tous les navigateurs ne la gère pas et
ensuite il y a des définitions contradictoires de ce qu'est un acronyme et ce
qu'est une abréviation (N. d. T. : en anglais peut-être, mais pas en
français).
</p>
<p>
Un acronyme devrait être ajouté à la page avec la syntaxe suivante :
<code><acronym lang="code de langue" title="définition complète de
l'acronyme">ACRONYME</acronym></code>. Le titre devrait contenir la
totalité des mots prononcés. L'attribut « lang » n'est requis que si
l'acronyme ou l'abréviation est en langue étrangère.
</p>
<p>
Il existe déjà un ensemble d'acronymes usuels dans les modèles wml à utiliser
dans vos pages, vous devriez ajouter une ligne pour utiliser les
<code>acronyms</code> dans le fichier wml. Par exemple, la balise wml pour DD
est <acronym_DD />.
</p>
<toc-add-entry name="citations">Citations et extraits</toc-add-entry>
<p>
Il y a plusieurs règles différentes de ce qu'est une citation ou un extrait
pour différentes langues. Si vous avez une courte citation dans le texte, vous
devriez utiliser la balise <q>. L'affichage du contenu est géré par la
feuille de style de la langue. Les balises <q> ne devraient pas avoir
d'espace ou de saut de ligne entre la balise ouvrante ou fermante et le
contenu.
</p>
<p>
Pour des citation plus longues, la balise <blockquote> devrait être
utilisée. Un <blockquote> entoure un ou plusieurs paragraphes de textes
qui sont balisés par <p>. Veuillez ne pas utiliser les balises
<blockquote> pour centrer un bloc de texte qui n'est pas une citation.
Les blockquotes sont exclusivement réservés aux citations et seront affichés
par une feuille de style spécifique à la langue dans le futur.
</p>
<p>
Il existe également une balise <cite> en HTML. Cette balise <cite>
n'est pas utilisée pour le texte de la citation lui-même. Elle est utilisée
pour la source de la citation. Ce peut être le nom de la personne citée et est
ajouté en tant qu'attribut à un <blockquote> comme URL.
</p>
<toc-add-entry name="code">Noms de programmes et code</toc-add-entry>
<p>
Pour les noms de programmes et le code informatique il existe une balise nommée
<code>. Les navigateurs devraient normalement savoir comment afficher le
code et les noms de programmes, mais l'affichage peut aussi être modifié par
une feuille de style. Utiliser <tt> n'est pas une bonne idée car cela ne
renseigne pas sur le contenu.
</p>
<toc-add-entry name="samp">Exemples de résultats de commandes</toc-add-entry>
<p>
Pour les résultats de commandes sur l'écran, il existe une balise spéciale
nommée <samp>. Si vous avez un bloc plus large de résultat de commande,
vous devriez également regarder dans le fichier de feuille de style si une
classe particulière existe.
</p>
<toc-add-entry name="kbd">Saisie au clavier</toc-add-entry>
<p>
S'il y a des exemples où l'utilisateur doit saisir quelque chose au clavier, la
balise <kbd> devrait être utilisée pour l'entrée de l'utilisateur.
Veuillez également vous reporter au chapitre sur les <a
href="#var">variables</a> pour savoir comment baliser les saisies de variables.
</p>
<toc-add-entry name="var">Variables</toc-add-entry>
<p>
Il est parfois nécessaire d'accentuer une entrée variable telle qu'une adresse
IP particulière ou le nom d'utilisateur à fournir à une programme sur la ligne
de commande. Pour ces entrées variables, la balise <var> devrait être
utilisée.
</p>
<toc-add-entry name="pre">Contenu préformaté</toc-add-entry>
<p>
La balise <pre> ne devrait être utilisée que pour le texte préformaté. La
longueur des lignes, les espaces et d'autre choses seront préservés.
Naturellement cette balise ne peut pas contenir la plupart des autres balises
HTML.
</p>
<toc-add-entry name="img">Images</toc-add-entry>
<p>
Si des images sont ajoutées à la page, il n'est pas nécessaire d'ajouter un
attribut invalide border=0. Mais si possible la taille de l'image et un
attribut <code>alt</code> devraient être ajoutés. La taille devrait être
ajoutée par wml si elle n'est pas présente mais cela demande du temps de
compilation. L'attribut <code>alt</code> devrait contenir quelque chose qui
explique aux utilisateurs navigants avec lynx et aux aveugles ce que contient
l'image.
</p>
# <toc-add-entry name=""></toc-add-entry>
