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.

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:01:31