Debian GNU/Linux Reference Guide
Prev	Home	Next

13.8.2 SGML

Pr�paration :

     # apt-get install debiandoc-sgml debiandoc-sgml-doc

R�f�rences pour debiandoc-sgml :

• /usr/share/doc/debiandoc-sgml-doc

• debiandoc-sgml(1)

• DocBook: The Definitive Guide, par Walsh et Muellner (O'Reilly)

SGML permet de g�rer plusieurs formats pour un document. Un syst�me SGML facile est Debiandoc, qui est utilis� ici. Cela requiert des conversions mineurs dans le fichier texte original, pour les caract�res suivants :

     <   &lt;
     >   &gt;
     " " "&nbsp;"  (espace non s�quable)
     &   &amp;
     %   &percnt;
     ©   &copy;
     –   &ndash;
     —   &mdash;

Pour marquer une section en tant que commentaire non imprimable, faites :

     <!-- Indiquez le probl�me ici ... -->

Pour marquer une section en tant que commentaire ou pas � l'impression, faites :

     <![ %FIXME; [ Indiquez le probl�me ici ... ]]>

En SGML, la premi�re d�finition d'une entit� l'emporte. Par exemple :

     <!entity % qref "INCLUDE">
     <![ %qref; [ <!entity param "Data 1"> ]]>
     <!entity param "Data 2">
     &param;

Cela termine en tant que � Data 1 �. Si la premi�re ligne inclut � IGNORE � au lieu de � INCLUDE �, cela termine en tant que � Data 2 � (la deuxi�me ligne est une expression conditionnelle). De plus, les phrases souvent r�p�t�es peuvent �tre d�finies � l'avance s�par�ment du contexte.

     <!entity whoisthis "my">
     Hello &whoisthis; friend.
     This is &whoisthis; book.

Le r�sultat est :

     Hello my friend.
     This is my book.

Voir le court exemple de SGML sample.sgml dans les exemples.

Lorsque des documents SGML deviennent plus gros, TeX cause parfois des erreurs. Il faut augmenter la taille du bassin dans /etc/texmf/texmf.cnf (ou mieux �ditez /etc/texmf/texmf.d/95NonPath et lancez update-texmf) pour r�parer cela.

---

Debian GNU/Linux Reference Guide
Prev	Home	Next