Utilisez SGML pour vos documentations

Yves Mettier

Creative Commons License
Cette création est mise à disposition sous un contrat Creative Commons.

L'article original se trouve sur http://ymettier.free.fr/articles_lmag/.

Article publié dans le numéro 60 (avril 2004) de GNU/Linux France Magazine


Table des matières

1. Compilation d'un fichier sgml
2. Création du fichier de documentation sgml de base
3. Quelques rudiments de docbook
3.1. L'organisation du document
3.2. <bookinfo>
3.3. <chapter>
3.4. Tags utiles
4. Le contenu de votre documentation
5. Conclusion
6. Références

Résumé

Votre projet contient une arborescence assez classique avec un répertoire doc. Et votre documentation est en texte, voire html, et vous souhaiteriez produire du postscript ou du pdf, ou même du html avec ce bon vieux aspect qu'on retrouve en particulier dans les HOWTOs. Pour cela, il s'agit en fait de partir d'un fichier sgml, qui sera le code source de votre documentation.

création est mise à disposition sous un contrat Creative Commons