Anpassen mittels gentext-Template

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

Um Querverweise für Ihr gesamtes Dokument anzupassen, müssen Sie Sprachdateien anlegen und bearbeiten (was Sprachdateien sind, klärt Anpassen von Sprachdateien). Für Querverweise gibt es drei verschiedene Arten eines l:context-Elements:

<l:context name="xref">

Enthält Querverweise auf Elemente, die nicht nummeriert werden. Kapitel werden ebenfalls aufgenommen, wenn der Parameter chapter.autolabel auf den Wert Null gesetzt wurde. Dasselbe gilt für appendix, part, preface und section und ihren entsprechenden Parametern.

<l:context name="xref-number">

Enthält Querverweise auf Elemente, die nummeriert werden wie appendix, chapter, figure und table. Dasselbe gilt, wenn Abschnitte ebenfalls nummeriert werden, wenn xref.with.number.and.title=0 ist.

<l:context name="xref-number-and-title">

Querverweise auf Elemente, die nummeriert werden, inklusive Elementnamen, Nummer und Titel, wenn xref.with.number.and.title=1 ist (Voreinstellung).

Die Datei common/de.xml besitzt beispielsweise folgende Einträge:

Beispiel: Auszug aus der deutschen Sprachdatei relevant für Querverweise

<l:context name="xref">
    <l:template name="appendix" text="%t"/>
    <l:template name="chapter" text="%t"/>
    <l:template name="example" text="%t"/>
    ...
</l:context>
<l:context name="xref-number">
    <l:template name="appendix" text="Anhang&#160;%n"/>
    <l:template name="chapter" text="Kapitel&#160;%n"/>
    <l:template name="example" text="Beispiel&#160;%n"/>
    ...
</l:context>
<l:context name="xref-number-and-title">
    <l:template name="appendix" text="Anhang&#160;%n, %t"/>
    <l:template name="chapter" text="Kapitel&#160;%n, %t"/>
    <l:template name="example" text="Beispiel&#160;%n, „%t“"/>
    ...
</l:context>

Hierbei steht &#160; für ein nichtumbrechbares Leerzeichen (non-breakable space). Dadurch bleiben Wort und Nummer immer zusammen. Um Querverweise anzupassen, gehen Sie wie folgt vor:

  1. Entscheiden Sie sich, wie Sie Ihre Sprachdatei referenzieren: entweder direkt im Stylesheet (Anpassen von lokalisiertem Text) oder separat (Hinzufügen eigener Einträge).
  2. Bestimmen Sie die Querverweisdarstellung:
    • Hat der Parameter xref.with.number.and.title den Wert 1 (Standardwert) ist der Kontext xref-number-and-title für Sie relevant.
    • Hat der Parameter xref.with.number.and.title den Wert 0 benötigen Sie den Kontext xref-number.
    • Hat beispielweise der Parameter chapter.autolabel den Wert 0 (schaltet die Kapitelnummerierung ab), benötigen Sie den Kontext xref.
  3. Passen Sie den entsprechenden Kontext an Ihre Anforderungen an.

  

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