Le texte ordinaire (appelé «texte brut» dans ce document) peut contenir des éléments de formatage spécial et de référencement croisé. Le texte brut apparaît dans les titres de chapitres et de sections, dans le résumé du copyright, à l'intérieur des paragraphe et dans d'autres endroits équivalents.
Il y a un certain nombre d'éléments pour marquer la signification particulière de certains morceaux de textes. Pour ceux-ci, la fin du texte spécial doit être marqué explicitement, en utilisant une balise de fin explicite </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, Chapitre 1).
Typiquement 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*.
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>.
Dans 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.
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.
Dans 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.
Il y a plusieurs éléments permettant d'introduire des références croisées soit vers les autres parties d'un même document soit vers d'autres documents.
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.
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="...">..
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 < >.
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.
Les notes de bas de page peuvent apparaître dans la plupart des textes bruts et sont indiquées par <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.
Manuel de Debiandoc-SGML
14 octobre 2004ijackson@gnu.ai.mit.edu
clebars@debian.org