[RFR] webwml://www.debian.org/devel/website/htmlediting.wml
Merci à Frédéric et Mohammed
--
.~. 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 actuellement une version de travail.
</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 cr� des pages
correctement format�. Elle contient des conseils sur l'utilisation des
balises et sur la mani� de cr� de nouvelles pages et de les rendre plus
faciles �raduire.
</p>
<toc-add-entry name="general">Quelques conseils g�raux</toc-add-entry>
<p>
Voici une liste de conseils g�raux pour les nouvelles pages ou les
traductions.
</p>
<dl>
<dt>Ne pas utiliser de longues lignes</dt>
<dd>
Les lignes des fichiers wml et des autres fichiers ne devraient pas
d�sser la taille d'un terminal standard. C'est plus facile �diter sous
vi, il est 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�
comme par exemple <div>, <p>, <table> et <ul>. Pour
faciliter les choses 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 de courts extraits. Vous ne pouvez les s�rer sur une ligne
que comme un tout avec leur contenu, sinon il pourrait y avoir un espace
entre le contenu et la balise dans 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�nt pas et
ensuite les d�nitions d'un acronyme et d'une abr�ation sont incoh�ntes
(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� Les lettres des mots devraient �e capitalis�
selon l'usage fran�s. L'attribut � lang � n'est requis que si
l'acronyme ou l'abr�ation est en langue �ang�.
</p>
<p>
Il y a 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 existe plusieurs r�es diff�ntes sur 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 citations plus longues, la balise <blockquote> devrait �e
utilis� Une balise <blockquote> d�mite un ou plusieurs paragraphes de
texte qui sont marqu�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 �'avenir.
</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�ou une
URL si elle est ajout�omme attribut dans une balise <blockquote>.
</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 d'affichages d'ordinateur</toc-add-entry>
<p>
Pour les affichages d'ordinateur �'�an, il existe une balise sp�ale
nomm�<samp>. Si vous avez un grand bloc d'affichage, 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 la saisie de l'utilisateur.
Veuillez �lement vous reporter au chapitre sur les <a href="#var">\
variables</a> pour savoir comment baliser les saisies variables.
</p>
<toc-add-entry name="var">Variables</toc-add-entry>
<p>
Parfois, il est n�ssaire d'indiquer qu'une entr�variable telle qu'une
adresse IP particuli� ou un nom d'utilisateur doit �e fournie �n
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'autres 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 border=0 invalide. 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 navigant avec lynx et aux aveugles ce que contient
l'image.
</p>
# <toc-add-entry name=""></toc-add-entry>
Reply to: