Bonjour,
Voici une mise à jour d’une page de manuel :
https://www.debian.org/devel/website/htmlediting
Les fichiers sont aussi ici :
https://salsa.debian.org/webmaster-team/webwml/raw/master/french/devel/website/htmlediting.wml
https://salsa.debian.org/webmaster-team/webwml/raw/master/english/devel/website/htmlediting.wml
Merci d’avance pour vos relectures et commentaires.
Amicalement.
--
Jean-Paul
--- htmlediting.wml.orig 2023-10-16 09:11:01.529015661 +0200
+++ htmlediting.wml 2023-10-16 09:39:14.791996683 +0200
@@ -2,7 +2,7 @@
#use wml::debian::common_tags
#use wml::debian::acronyms
#use wml::debian::toc
-#use wml::debian::translation-check translation="648de6ad5bea60540e41a5733da0b761a34c7927"
+#use wml::debian::translation-check translation="b2595631761ec70fe18145ffa27080c0d5a5dd69"
# Previous translator : Nicolas Bertolissio
@@ -50,10 +50,10 @@
<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
+ Certaines balises produisent une espace si elles sont placées sur des lignes
séparées. Par exemple la balise <q> utilisée pour de courtes
citations et de courts extraits. Vous ne pouvez les séparer sur une ligne
- que comme un tout avec leur contenu, sinon il pourrait y avoir un espace
+ que comme un tout avec leur contenu, sinon il pourrait y avoir une espace
entre le contenu et la balise dans 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.
@@ -170,7 +170,7 @@
<p>
Si des images sont ajoutées à la page, il n'est pas nécessaire d'ajouter un
-attribut border=0 invalide. Mais, si possible, la taille de l'image et un
+attribut border=0 non autorisé. 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
@@ -178,6 +178,14 @@
l'image.
</p>
+<p>
+Si vous voulez lier une page de <code>https://www.debian.org</code> dans la
+documentation, veuillez utiliser des variables définies dans le fichier
+<code>.wmlrc</code> pour chaque langue. Par exemple, l’adresse web dans la balise
+<br /> <code><a href="https://www.debian.org/devel/website/htmlediting">htmlediting</a></code><br />
+devrait être remplacée en utilisant la variable <tt>DEVEL</tt> comme ceci :
+<code><a href="$(DEVEL)/website/htmlediting">htmlediting</a></code>.
+</p>
# <toc-add-entry name=""></toc-add-entry>
#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="b2595631761ec70fe18145ffa27080c0d5a5dd69"
# Previous translator : Nicolas Bertolissio
<p>
Cette page est actuellement une version de travail.
</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 à créer des pages
correctement formatées. Elle contient des conseils sur l'utilisation des
balises et sur la manière de créer de nouvelles pages et de les rendre plus
faciles à traduire.
</p>
<toc-add-entry name="general">Quelques conseils généraux</toc-add-entry>
<p>
Voici une liste de conseils géné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épasser 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 également important car 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
comme par exemple <div>, <p>, <table> et <ul>. Pour
faciliter les choses 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 une espace si elles sont placées sur des lignes
séparées. Par exemple la balise <q> utilisée pour de courtes
citations et de courts extraits. Vous ne pouvez les séparer sur une ligne
que comme un tout avec leur contenu, sinon il pourrait y avoir une espace
entre le contenu et la balise dans 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èrent pas et
ensuite les définitions d'un acronyme et d'une abréviation sont incohérentes
(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. Les lettres des mots devraient être capitalisées
selon l'usage français. L'attribut « lang » n'est requis que si
l'acronyme ou l'abréviation est en langue étrangère.
</p>
<p>
Il y a 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>acronym</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ègles différentes sur 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 citations plus longues, la balise <blockquote> devrait être
utilisée. Une balise <blockquote> délimite un ou plusieurs paragraphes de
texte qui sont marqué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ées aux citations et seront affichées
par une feuille de style spécifique à la langue à l'avenir.
</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 elle
est ajoutée comme attribut sous forme d’URL 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é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 d'affichages de terminal</toc-add-entry>
<p>
Pour les affichages de terminal à l'écran, il existe une balise spéciale
nommée <samp>. Si vous avez un grand bloc d'affichage, 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 la saisie de l'utilisateur.
Veuillez également vous reporter au chapitre sur les <a href="#var">\
variables</a> pour savoir comment baliser les saisies de variable.
</p>
<toc-add-entry name="var">Variables</toc-add-entry>
<p>
Parfois, il est nécessaire d'indiquer qu'une entrée de variable telle qu'une
adresse IP particulière ou un nom d'utilisateur doit être fournie à un
programme sur la ligne de commande. Pour ces saisies de 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'autres 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 border=0 non autorisé. 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 navigant avec lynx et aux aveugles ce que contient
l'image.
</p>
<p>
Si vous voulez lier une page de <code>https://www.debian.org</code> dans la
documentation, veuillez utiliser des variables définies dans le fichier
<code>.wmlrc</code> pour chaque langue. Par exemple, l’adresse web dans la balise
<br /> <code><a href="https://www.debian.org/devel/website/htmlediting">htmlediting</a></code><br />
devrait être remplacée en utilisant la variable <tt>DEVEL</tt> comme ceci :
<code><a href="$(DEVEL)/website/htmlediting">htmlediting</a></code>.
</p>
# <toc-add-entry name=""></toc-add-entry>
commit b2595631761ec70fe18145ffa27080c0d5a5dd69
Author: Thomas Lange <la...@debian.org>
Date: Sun Oct 15 15:07:50 2023 +0200
add info how to use variables, Closes: #757943
diff --git a/english/devel/website/htmlediting.wml b/english/devel/website/htmlediting.wml
index 558787af8bf..fccf447fc3d 100644
--- a/english/devel/website/htmlediting.wml
+++ b/english/devel/website/htmlediting.wml
@@ -135,6 +135,13 @@ time. The <code>alt</code> attribute should contain something that tells users b
with lynx and blind people what is in the image.
</p>
+<toc-add-entry name="links">Links</toc-add-entry>
+<p>
+If you intend to link to a page within <code>https://www.debian.org</code> in the
+documentation, please use variables defined in the <code>.wmlrc</code> file for each language. For e.g. the URL in the tag <br />
+<code><a href="https://www.debian.org/devel/website/htmlediting">htmlediting</a></code><br />
+should be replaced using the variable <tt>DEVEL</tt> like this <code><a href="$(DEVEL)/website/htmlediting">htmlediting</a></code>.
+</p>
# <toc-add-entry name=""></toc-add-entry>
