</
element>
, la balise
de fin abrégée fermant l'élément le plus proche </>
ou
la barre oblique /
qui termine la forme la plus abrégée
des balises. (voir Balises SGML et caractères spéciaux, chapter 1).
<em>
- emphaseTypiquement ceci sera représenté si possible par des italiques, ou par un texte en gras ou souligné, ou bien dans les formats de texte seulement, sans styles de caractère spéciaux, en encadrant le texte avec des astérisques comme *ceci*.
<var>
- méta-variable
Typiquement ceci sera représenté par des italiques, ou les formats
de texte seulement en encadrant le texte avec des crochets angulaires
comme <ceci>. Si plusieurs méta-variables apparaissent
successivement, elles doivent chacune utiliser leur propre élément
<var>
.
<prgn>
- nom d'un programme ou d'un fichier bien connuDans les formats de sortie où il existe des styles de caractères spéciaux et des styles de polices variés, ceci est habituellement représenté en utilisant une police non-proportionnelle. Dans les formats de sortie texte seulement, ces noms ne sont pas spécialement marqués, puisqu'ils surviennent fréquemment et qu'introduire un encadrement perturberait le cours du texte.
<tt>
- chemin, code ou fragment de sortie, chaîne de commande<tt>
plutôt que des
éléments environnants.Ceci sera habituellement représenté en utilisant une police de largeur fixe; dans les formats texte seulement un encadrement peut être utiliser autour de l'élément.
<qref id="
refid">
- référence conditionnelleDans les formats permettant des références croisées non-perturbantes en faisant d'une zone de texte un hyperlien sans introduire du nouveau texte, cet élément fera du texte contenu un hyperlien vers la cible de la référence croisée. Dans les autres formats cet élément n'aura aucun effet.
Les références croisées internes au document sont basées sur un schéma
d'identifiants référentiels. Chaque chapitre, section, sous-section, etc.
peut avoir un attribut id
lui donnant son identifiant référentiel
- par exemple <chapt id="spong">
spécifie que le chapitre
commençant possède l'identifiant référentiel spong
. Cet identifiant
référentiel peut alors être pointé dans d'autres parties du document
en utilisant les éléments spéciaux des références croisées.
L'identifiant référentiel sera aussi utilisé pour générer des noms de fichiers et des objets référentiels pour les formats tel que HTML qui produisent plusieurs fichiers de sortie; si aucun identifiant référentiel n'est spécifié alors les numéros de chapitres et de sections seront utilisés. C'est une bonne idée de donner au moins à tous vos chapitres un identifiant référentiel pour que les noms de fichiers ne changent pas si vous changez l'ordre des chapitres ou des sections dans votre document.
<ref id="
idref">
- Référence interne au document
L'élément <ref>
n'a pas de contenu; le numéro de section ou de
chapitre, le titre et son numéro de page ou tout autre chose approprié
pour le format de sortie sera inséré dans le texte à l'endroit où la
balise apparaît.
Syntaxiquement la référence croisée est une phrase sans verbe,
approprié dans des situations tel que
(voir <ref id="
...">)
ou
plus d'informations dans <ref id="
...">.
.
<manref name="
nom" section="
section">
-
page de manuel (manpage)
nom(
section)
, sera
inséré à l'endroit où <manref>
apparaît.
<email>
- adresse de courrier électronique (email)</email>
ne doit pas être omise, mais on peut l'oublier
lorsque l'adresse apparaît à la fin d'un élément <author>
.
Le début de l'élément suivant impliquera la fin de l'adresse de courrier
électronique.
Dans certains formats, ceci générera une véritable référence croisée
qui pourra (par exemple) être utiliser pour envoyer un courrier électronique
à l'adresse définie. Dans d'autres, cela marquera simplement le texte
de manière spéciale, habituellement en l'encadrant de crochets angulaires
<
>
.
<ftpsite>
- nom de site FTP anonyme<ftppath>
- chemin dans le dernier site FTP cité<ftpsite>
indique que le contenu de l'élément est le nom DNS
d'un site FTP anonyme et <ftppath>
un chemin dans ce site FTP.
Les deux éléments ne peuvent contenir aucune balise de style de
caractères ou de références croisées.
Typiquement les deux éléments seront représentés par une police non-proportionnelle;
si possible, le chemin du site (<ftppath>
) sera
transformé en un hyperlien fonctionnel vers le fichier ou le répertoire
du dernier site FTP (<ftpsite>
) cité.
<ftppath>
doit toujours être précédé par
<ftpsite>
dans le même chapitre, mais une fois qu'un
site FTP a été cité, plusieurs chemins peuvent apparaître.
<footnote>
...</footnote>
.
Le texte de la note de bas de page sera retiré, placé ailleurs
(l'endroit dépendant du format) et remplacé par une référence ou un
hyperlien vers la note de bas de page.Le contenu de la note de bas de page doit être un ou plusieurs paragraphes; le début du premier paragraphe doit être marqué explicitement. Les balises de texte brut tel que les styles de caractères n'ont pas d'effet sur le contenu de la note de bas de page définit à l'intérieur d'eux - la note de bas de page fait table rase.
Les notes de bas de page peuvent être imbriquées, mais c'est rarement une bonne idée.