Cours DocBook accelere

2.4. Mon premier fichier DocBook

Premièrement, vous avez besoin d'un fichier DocBook pour convertir. Prenez un simple éditeur de texte et tapez (ou copiez-collez) les lignes suivantes :

Exemple 2-1. Fichier DocBook minimal


<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
  "/usr/share/xml/docbook/schema/dtd/4.4/docbookx.dtd">
<book>
 
<bookinfo>
<title>Hello, world</title>
</bookinfo>
 
<chapter>
<title>Hello, world</title>
 
<para>C'est mon premier fichier DocBook.</para>
 
</chapter>
</book>

Ensuite, pour l'enregistrer, faites, myfile.docbook. Si vous utilisez les SGML Tools, le chemin entre parenthèses sur la troisième ligne n'est pas nécessaire.

Pour convertir ce fichier du DocBook au format HTML, utilisez la commande :


$ docbook2html myfile.docbook
ou

$ xsltproc /usr/share/xml/docbook/stylesheet/nwalsh/current/html/docbook.xsl myfile.docbook -o myfile.html
selon votre boîte à outils (DocBook-tools ou XSLTProc).

Jade ou xsltproc vont s'exécuter et si votre document ne contient pas d'erreurs vous obtiendrez un ensemble de fichiers HTML. Utilisez un navigateur Web pour ouvrir le fichier principal, book1.htm.

Si vous obtenez des erreurs, lisez le journal d'erreur et corrigez les en commençant par le début. Souvent, il s'agit d'une balise non refermée qui cause des erreurs en cascade.