Parameter-Entities – Auf Entity-Deklarationsdateien verweisen
Bei einer Parameter-Entity handelt es sich um eine Datei mit Entity-Deklarationen, Notationsdeklarationen und Verweisen auf andere Dateien mit Entity- und Notationsdeklarationen. Eine Parameter-Datei-Entity, die in einer Dokumentinstanz deklariert wird, ermöglicht einen Verweis auf gängige Text-Entities aus einer externen Datei, ohne dass der Autor der DTD konsultiert werden muss. Solche Verweise waren früher nur in der DTD möglich.
Sie müssen Parameter-Datei-Entities mit SGML in einem ASCII-Editor oder durch Bearbeitung des Dokuments mit der Methode edit –current –untagged deklarieren. Auf diese Weise wird Ihr Dokument in SGML angezeigt. Oben im Dokument befindet sich die interne Untermenge, die sämtliche Entity-Deklarationen enthält.
So deklarieren Sie eine Parameter-Datei-Entity:
1. Speichern Sie Ihr Dokument.
2. Klicken Sie auf die Befehlszeile, und geben Sie Folgendes ein: edit -current -untagged. Drücken Sie die EINGABETASTE.
Wechseln Sie zum Dialogfenster > , wenn die Befehlszeile nicht angezeigt wird. Wählen Sie die Kategorie Fenster, und aktivieren Sie die Einstellung Befehlszeile.
Das Dokument wird im SGML-Format angezeigt. Beachten Sie die Entity-Deklarationen in der internen Untermenge oben im Dokument (zwischen der öffnenden und der schließenden Klammer). Ein Beispiel für eine interne Untermenge mit zwei allgemeinen Entity-Deklarationen wird unten angezeigt:
<!DOCTYPE BOOK PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
<!--Arbortext, Inc., 1988-1999, v.xxx-->
<!ENTITY prodname "Arbortext Editor">
<!ENTITY release "9.0">
]>
<book>
Sie könnten die beiden allgemeinen Entity-Deklarationen ("prodname" und "release") in einer Datei speichern, auf die von mehreren Dokumenten aus verwiesen werden könnte. Die Entity-Deklarationen im Beispiel oben würden durch eine Parameter-Entity-Deklaration und einen Verweis ersetzt. Die Parameter-Entity verweist auf die Datei mit den allgemeinen Entity-Deklarationen. Siehe folgendes Beispiel:
<!DOCTYPE BOOK PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
<!--Arbortext, Inc., 1988-1997, v.xxx-->
<!ENTITY % parament PUBLIC “-//Arbortext//ENTITIES common entdecls//EN">
%parament;
]>
<book>
Die Zuordnung der Public-ID zur tatsächlichen Datei mit Entity-Deklarationen nehmen Sie in einer Katalogdatei vor.
3. Sie können eine Parameter-Entity-Deklaration an jeder beliebigen Stelle in der internen Untermenge zwischen der öffnenden und schließenden Klammer hinzufügen.
4. Speichern Sie das Dokument, und wählen Sie anschließend Beenden.
5. Wenn Sie das nächste Mal das Dokument öffnen, stehen die hinzugefügten Entities zur Verfügung.