Glossare

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

Ein Glossar, also eine Liste von Worterklärungen, entsteht durch das Element glossary. Strukturieren können Sie es über glossdiv. Innerhalb dieses Elements werden die jeweiligen Einträge über glossentry angesprochen. Der Terminus wird mit glossterm und die zugehörige Definition durch glossdef ausgezeichnet. Ein Verweis auf einen anderen Glossareintrag kann über die Elemente glossseealso oder glosssee erfolgen (siehe folgendes Beispiel).

Beispiel: Aufbau eines Glossars (glossary.xml)

<glossary SPRACHE="de">
    <title>Beispiel eines Glossars</title>
    <!-- ... -->
    <glossdiv>
        <title>D</title>
        <glossentry ANKER="g.docbook">
            <glossterm>DocBook</glossterm>
            <glossdef>
                <para>DocBook ist eine Markupsprache, basierend auf XML.</para>
                <glossseealso otherterm="g.xml"/>
            </glossdef>
        </glossentry>
    </glossdiv>
    <!-- ... -->
    <glossdiv><title>X</title>
        <glossentry ANKER="g.xml">
            <glossterm>Extensible Markup Language</glossterm>
            <acronym>XML</acronym>
            <glossdef>
                <para>XML ist die Extensible Markup Language.</para>
            </glossdef>
        </glossentry>
    </glossdiv>
</glossary>

Ersetzen Sie den Platzhalter SPRACHE durch lang in DocBook 4 und xml:lang in DocBook 5.
Ersetzen Sie den Platzhalter ANKER durch id in DocBook 4 und xml:id in DocBook 5.

Zeile 1: Sprache des Glossars
Zeile 4: Strukturierung durch glossdiv
Zeile 6: Einleitung eines Glossareintrags mit glossentry; für Referenzierungen wird das id-Attribut verwendet. Für DocBook 5 verwenden Sie xml:id.
Zeile 7: Glossarbegriff
Zeile 8: Erklärung des Begriffs
Zeile 10: Querverweis auf einen anderen Glossareintrag
Zeile 16: Auf diesen Begriff wird vom vorigen Punkt verwiesen.
Zeile 18: Falls der Glossareintrag ebenso unter einem Akronym oder Abkürzung bekannt ist, lässt sich acronym bzw. abbrev verwenden. Über den Stylesheet-Parameter glossentry.show.acronym kann diese zusätzlich zum Glossareintrag angezeigt oder unterdrückt werden.

  

<< 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