[RFR] webwml://www.debian.org/devel/website/htmlediting.wml
--
.~. Nicolas Bertolissio
/V\ nico.bertol@free.fr
// \\
/( )\
^`~'^ 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 �'�t de brouillon.
</p>
<toc-display/>
<toc-add-entry name="preface">Pr�ce</toc-add-entry>
<p>
Cette page est l�our aider les auteurs et les traducteurs �ien former les
pages. Elle contient des astuces sur l'utilisation des balises et sur la
mani� de cr� de nouvelles pages de les rendre plus facile �raduire.
</p>
<toc-add-entry name="general">Quelques astuces g�rales</toc-add-entry>
<p>
Voici une liste de conseils g�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�e de terminal standard. C'est plus facile pour l'�tion dans vi,
plus simple d'y faire des recherches et plus ais� traduire. C'est
�lement important car CVS est orient�ignes et qu'il est plus difficile
de r�udre des conflits dans de longues lignes.
</dd>
<dt>Placer les balises sur des lignes s�r� si possible</dt>
<dd>
La plupart des balises HTML peuvent �e plac� sur des lignes s�r�.
Cela comprend <div>, <p>, <table> et <ul>. Pour
rendre les choses plus faciles aux traducteurs, vous devriez placer toutes
les balises qui peuvent �e utilis� de cette fa� sur des lignes
s�r�. 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�
dans le texte</dt>
<dd>
Certaines balises produisent un espace si elles sont plac� sur des lignes
s�r�. Par exemple la balise <q> utilis�pour de courtes
citations et des extraits. Vous ne pouvez les s�rer 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�eur 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�ations et acronymes</toc-add-entry>
<p>
Pour les abr�ations et les acronymes, la balise HTML <acronym> devrait
�e utilis� Il y a deux raisons pour ne pas recommander l'utilisation de la
balise <abbr> : d'abord tous les navigateurs ne la g� pas et
ensuite il y a des d�nitions contradictoires de ce qu'est un acronyme et ce
qu'est une abr�ation (N. d. T. : en anglais peut-�e, mais pas en
fran�s).
</p>
<p>
Un acronyme devrait �e ajout� la page avec la syntaxe suivante :
<code><acronym lang="code de langue" title="d�nition compl� de
l'acronyme">ACRONYME</acronym></code>. Le titre devrait contenir la
totalit�es mots prononc� L'attribut � lang � n'est requis que si
l'acronyme ou l'abr�ation est en langue �ang�.
</p>
<p>
Il existe d� un ensemble d'acronymes usuels dans les mod�s wml �tiliser
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�es diff�ntes de ce qu'est une citation ou un extrait
pour diff�ntes langues. Si vous avez une courte citation dans le texte, vous
devriez utiliser la balise <q>. L'affichage du contenu est g� 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 �e
utilis� Un <blockquote> entoure un ou plusieurs paragraphes de textes
qui sont balis�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�rv�aux citations et seront affich�par une feuille de style sp�fique �a langue dans le futur.
</p>
<p>
Il existe �lement une balise <cite> en HTML. Cette balise <cite>
n'est pas utilis�pour le texte de la citation lui-m�. Elle est utilis�pour la source de la citation. Ce peut �e le nom de la personne cit�et est
ajout�n tant qu'attribut �n <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�<code>. Les navigateurs devraient normalement savoir comment afficher le
code et les noms de programmes, mais l'affichage peut aussi �e modifi�ar
une feuille de style. Utiliser <tt> n'est pas une bonne id�car cela ne
renseigne pas sur le contenu.
</p>
<toc-add-entry name="samp">Exemples de r�ltats de commandes</toc-add-entry>
<p>
Pour les r�ltats de commandes sur l'�an, il existe une balise sp�ale
nomm�<samp>. Si vous avez un bloc plus large de r�ltat de commande,
vous devriez �lement regarder dans le fichier de feuille de style si une
classe particuli� existe.
</p>
<toc-add-entry name="kbd">Saisie au clavier</toc-add-entry>
<p>
S'il y a des exemples o�tilisateur doit saisir quelque chose au clavier, la
balise <kbd> devrait �e utilis�pour l'entr�de l'utilisateur.
Veuillez �lement 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�ssaire d'accentuer une entr�variable telle qu'une adresse
IP particuli� ou le nom d'utilisateur �ournir �ne programme sur la ligne
de commande. Pour ces entr� variables, la balise <var> devrait �e
utilis�
</p>
<toc-add-entry name="pre">Contenu pr�rmat�toc-add-entry>
<p>
La balise <pre> ne devrait �e utilis�que pour le texte pr�rmat�La
longueur des lignes, les espaces et d'autre choses seront pr�rv�
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� �a page, il n'est pas n�ssaire d'ajouter un
attribut invalide border=0. Mais si possible la taille de l'image et un
attribut <code>alt</code> devraient �e ajout� La taille devrait �e
ajout�par wml si elle n'est pas pr�nte 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>
Reply to: