Les entités (générales et paramètres) sont particulièrement utiles pour inclure un fichier dans un autre.
Supposons que le contenu d'un livre SGML soit découpé en fichiers,
à raison d'un fichier par chapitre, appelés
chaptitre1.xml
,
chapitre2.xml
, et ainsi de suite, et que le
fichier livre.xml
inclue ces chapitres.
Pour que vos entités aient pour valeur le contenu de ces fichiers,
vous les déclarerez avec le mot-clé SYSTEM
. Cela
indique à l'analyseur SGML qu'il doit utiliser le contenu du fichier
mentionné comme valeur de l'entité.
Quand vous vous servez d'entités générales pour inclure d'autres
fichiers dans un document, les fichiers inclus
(chapitre1.xml
,
chapitre2.xml
, et ainsi de suite) ne doivent
pas commencer par une déclaration DOCTYPE. Ce
serait une erreur de syntaxe.
Rappelez-vous que les entités paramètres ne peuvent être utilisées que dans un contexte SGML. Quand aurez-vous besoin d'inclure un fichier dans un contexte SGML ?
Vous pouvez vous en servir pour être sûr de pouvoir réutiliser vos entités générales.
Supposons que votre document comporte de nombreux chapitres, et que vous réutilisiez ces chapitres dans deux livres différents, chacun organisant ces chapitres de façon différente.
Vous pourriez donner la liste des entités en tête de chaque livre, mais cela pourrait rapidement devenit fastidieux à gérer.
Mettez, au lieu de cela, les définitions des entités générales dans un fichier, et utilisez une entité paramètre pour inclure ce fichier dans votre document.
Mettez d'abord les définitions de vos entités dans un fichier
séparé, appelé chapitres.ent
. Voici ce qu'il
contiendra :
Créez maintenant une entité paramètre qui fasse référence au contenu de ce fichier. Utilisez ensuite cette entité pour inclure le fichier dans votre document, vous pourrez alors y utiliser les entités générales. Ce que vous faites de la même façon que précédemment :
Créez trois fichiers, para1.xml
,
para2.xml
et
para3.xml
.
Mettez-y quelque chose qui ressemble à ceci :
Modifiez exemple.xml
de la façon
suivante :
Générez exemple.html
en normalisant
exemple.xml
.
%
sgmlnorm -d exemple.xml > exemple.html
Affichez exemple.html
avec votre
navigateur Web et vérifiez que les fichiers
para
ont
bien été inclus dans n
.xmlexemple.html
.
Vous devez d'abord avoir mis en pratique l'exemple précédent.
Modifiez comme ceci
exemple.xml
:
Créez un nouveau fichier, entites.xml
,
qui contienne :
Générez exemple.html
en normalisant
exemple.xml
.
%
sgmlnorm -d exemple.xml > exemple.html
Affichez exemple.html
avec votre
navigateur Web et vérifiez que les fichiers
para
ont
bien été inclus dans n
.xmlexample.html
.
Ce document, ainsi que d'autres peut être téléchargé sur ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/
Pour toutes questions à propos de FreeBSD, lisez la
documentation avant de contacter
<questions@FreeBSD.org>.
Pour les questions sur cette documentation, contactez
<doc@FreeBSD.org>.