Markierungslisten (calloutlist)

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

Verwenden Sie diesen Listentyp, um wichtige Stellen in einem Text oder einer Grafik zu markieren. In der Markierungsliste (calloutlist) beschreiben Sie nacheinander die referenzierten Stellen. Um eine Markierungsliste sinnvoll einzusetzen, benötigt sie immer eines der Elemente screen, programlisting, graphicco (veraltet), oder mediaobjectco.

Beispiel: Aufbau einer Callout-Liste

<programlisting>#!/bin/bash <co ANKER="co.bash"/>echo $PATH <co ANKER="co.path"/></programlisting>
<calloutlist>
  <callout arearefs="co.bash">
    <para>Jedes Shell-Skript benötigt diese Zeile.</para>
  </callout>
  <callout arearefs="co.path">
    <para>Durch <command>echo</command> wird die Variable <envar>PATH</envar> ausgegeben.</para>
  </callout>
  <callout arearefs="co.bash co.path">
    <para>Referenziert zwei Markierungen.</para>
  </callout>
</calloutlist>

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

Wichtig ist, dass ein korrekter Anker gesetzt wurde, auf die mit dem Attribut arearefs von callout verwiesen wird. Beachten Sie, dass der Typ von arearefs ein IDREFS ist, das heißt, Sie dürfen mehrere ID-Werte durch Leerraum getrennt angeben (wie im letzten callout-Element zu sehen).

  

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