Glossardatenbank

(Auszug aus "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" von Thomas Schraitle)

Um eine Glossardatenbank für verschiedene Dokumente gemeinsam zu nutzen, gehen Sie wie folgt vor:

  1. Erstellen Sie eine Glossardatenbank
    Erstellen Sie eine separate Datei, die als Wurzelelement glossary enthält. Jeder Glossar-Eintrag ist ein glossentry.

    Datei glossary.xml:
<glossary> 
    <!-- ... --> 
    <glossentry> 
        <glossterm baseform="XML">Extensible Markup Language</glossterm> 
        <acronym>XML</acronym> 
        <glossdef>...</glossdef> 
    </glossentry> 
</glossary>
  1. Anpassen Ihres Dokuments
    Verwenden Sie in Ihrem Dokument die Elemente firstterm oder glossterm. Erstere verwenden Sie, wenn Sie das erste Auftreten Ihres Glossareintrages besonders auszeichnen möchten.
<para>Dies ist das erste Auftreten von <firstterm baseform="XML">eXtensible Markup Language</firstterm>. Weitere <glossterm baseform="XML">XML</glossterm>-Einträge ... </para>

Achten Sie besonders darauf, dass Sie das Attribut baseform verwenden, wenn Ihr Glossareintrag länger ist.

  1. Anlegen einer Anpassungsdatei
    Erstellen Sie eine Anpassungsdatei wie in Anlegen einer Anpassungsdatei gezeigt.
  2. Einfügen des Parameters glossary.collection
    Fügen Sie folgende Zeilen in Ihre Anpassungsdatei ein. Der Parameter glossary.collection enthält den Pfad zu Ihrer Glossardatenbank:
<xsl:param name="glossary.collection">glossary.xml</xsl:param> 
<xsl:param name="firstterm.only.link" select="1"/> 
<xsl:param name="glossterm.auto.link" select="1"/>
  1. Transformieren Ihres Dokuments
    Transformieren Sie Ihr Dokument mit Hilfe der Anpassungsdatei.

Es gibt einige Einschränkungen, wenn Sie eine Glossardatenbank verwenden:

  • Querverweise zwischen Glossareinträgen mittels glosssee, glossseealso oder glossterm sind momentan nicht unterstützt. Weitere Hinweise gibt es zum Parameter glossary.collection.
  • Rückverweise von einem Glossareintrag in Ihr Dokument sind nicht möglich. Das liegt daran, dass es sich bei Ihrem Dokument und Ihrer Glossardatenbank um separate Dateien handelt, die nur innerhalb ihres eigenen Kontextes verarbeitet werden. Da es keinen gemeinsamen Kontext gibt, sind Rückverweise nicht möglich weil sie gewissermaßen "ins Leere laufen".

  

<< zurück vor >>
Tipp der data2type-Redaktion:
Zum Thema DocBook bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an:

Copyright © 2009 Millin Verlag
Für Ihren privaten Gebrauch dürfen Sie die Online-Version ausdrucken.
Ansonsten unterliegt dieses Kapitel aus dem Buch "DocBook-XML: Medienneutrales und plattformunabhängiges Publizieren" denselben Bestimmungen, wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.

Millin Verlag, Siebengebirgsring 36, 53797 Lohmar, info(at)millin.de