Cours DocBook accelere

4.2. Utiliser les entités pour inclure d'autres fichiers

La DTD est aussi le bon endroit pour inclure d'autres fichiers. La documentation tend habituellement à devenir très lourde, ainsi c'est une bonne idée de la diviser en plusieurs fichiers qui sont inclus dans un seul fichier principal comme ceci :

Exemple 4-2. Entités utilisées pour inclure d'autres fichiers


<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" [
  <!ENTITY introduction SYSTEM "introduction.docbook">
  <!ENTITY marketing SYSTEM "marketing-plan.docbook">
  <!ENTITY advertising SYSTEM "advertising-campain.docbook">
]>
 
<book id="marketing-study" lang="en">
 
<bookinfo>
<title>Marketing study about &cereals;</title>
</bookinfo>
 
&introduction;
&marketing;
&advertising;
&conclusion;

</book>

Bien sûr, vous devez créer les fichiers nommés introduction.docbook, marketing-plan.docbook, etc. qui contiendront vos chapitres, pour que cet exemple fonctionne.