Page suivante Page précédente Table des matières

3. Votre premier document

3.1 Depuis un document au format texte

Si vous possédez un document au format texte que vous désirez formater en SGML pour ensuite le transformer en divers formats, voici la marche à suivre :

  1. Ajoutez au tout début du fichier les lignes suivantes :
            <!doctype linuxdoc system>
            <article>
            <title>le titre ici</title>
            <author>
            le nom de l'auteur, son email
            </author>
            <date>
            la version et la date du document
            </date>
           
    
  2. S'il y a au tout début du document un court paragraphe qui décrit brièvement le contenu de ce document, encadrez ce paragraphe avec les balises <abstract> et </abstract>.
  3. Ajoutez juste à la suite la balise <toc>, qui insère automatiquement la table des matières.
  4. Au début de chaque nouveau chapitre, remplacez la ligne contenant le numéro et le titre du chapitre par :
           <sect>le titre du chapitre
           
    
    et rajoutez la balise </sect> à la fin du chapitre.
    Note : Il n'est pas nécessaire d'indiquer le numéro du chapitre, car ils sont numérotés automatiquement.
  5. Faites la même chose pour les sections, en remplaçant le numéro et le titre par <sect1> et en rajoutant </sect1> à la fin de la section.
  6. Il est possible de créer des sous-sections jusqu'au niveau 4 (avec <sect4> et </sect4>) en opérant de la même manière.
  7. À chaque début de paragraphe, ajoutez la balise <p>.
  8. Si vous désirez mettre en valeur certains mots ou certaines phrases, entourez-les des balises <it> et </it> (italique), ou <bf> et </bf> (gras), ou encore <tt> et </tt> (caractères de machine à écrire d'antan).
  9. Lorsqu'une liste apparaît dans le texte, comme celle-ci par exemple :
            Voici une liste :
    
            - d'une ligne,
            - ah non, deux,
            - tiens, trois,
            - c'est tout.
    
            de quatre lignes !
           
    
    il faut la remplacer par :
            Voici une liste :
           <itemize>
           <item>d'une ligne,
           <item>ah non, deux,
           <item>tiens, trois,
           <item>c'est tout.
            </itemize>
            de quatre lignes !
           
    
  10. Lorsqu'un bloc représente une partie de programme, ou autre chose que l'on veut faire ressortir :
           <verb>
            10 REM Tiens qu'est-ce que c'est ?
            20 REM Je croyais que ca n'existait plus !
            30 PRINT "Je suis de retour ";
            40 PRINT "pour sauver le monde."
            50 INPUT "Des mains de qui d'après toi ?",M$
            60 IF M$="Bill" THEN PRINT "Tu es un sage":GOTO AUPARADIS
            70 ELSE PRINT "Tu n'as rien compris...":GOTO AUPAYSDUDOLLAR
            </verb>
           
    
  11. Arrivé à ce point, vous avez déjà bien avancé votre formatage en SGML. Vous pourrez, si vous voulez affiner votre document, jeter un oeil sur le guide d'utilisation des SGML-Tools, qui décrit plus en détail le type de document LinuxDoc.

Page suivante Page précédente Table des matières