Chapitre 11. SGML, mode d'emploi

Table des matières
Préambule
Les balises utilisées dans AlternC

Préambule

Cette documentation a été écrite en SGML. Le SGML est un format de document proche du HTML. On peut éditer du SGML avec n'importe quel éditeur de texte. Je vous conseille Quanta pour Linux ou EditPlus pour Windows.

Quanta : Si vous utilisez Quanta pour éditer vos fichiers SGML, vous pouvez ajouter des raccourcis vers les balises SGML grace à ces 2 fichiers actions.rc et quantaui.rc dont vous ajouter le contenu aux fichiers du meme nom dans votre dossier ~/.kde/share/apps/quanta/. Cela ajoute une barre d'outils SGML contenant les balises les plus fréquemment utilisées.

Le SGML est assez complexe, mais nous n'utilisons que des balises du système docbook (utilisé pour les documentations de logiciels sous linux) et nous choisissons un sous-ensemble du système docbook, il reste donc assez peu de choses à apprendre... Le SGML, une fois bati, est compilé pour donner 3 exemplaires de la documentation :

  1. Une version en HTML, avec 1 fichier html par section, pour etre consultable hors ligne

  2. Une version en HTML, 1 seul gros fichier html contenant toute la doc (pour téléchargement)

  3. Une version en PDF, pouvant etre lue et/ou imprimée sur n'importe quelle plateforme

Ainsi, il est possible de convertir cette documentation dans n'importe quel format connu (y compris .rtf .tex...)