Markierungspunkte ("Callouts")

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

"Callouts" sind nummerierte Markierungen, um markante Stellen auszuzeichnen, beispielsweise in Programmcode. Verwenden Sie eine Callout-Liste (siehe Markierungslisten (calloutlist)), um die Markierungen zu beschreiben. Im gesamten Buch wurden die Beispiele auf diese Art gestaltet. Die Markierung lässt sich auf zwei Arten einfügen:

  • Direkt: Ihr Code und die Markierungspunkte liegen innerhalb von screen oder programlisting gemischt vor. Dies ist nur praktikabel, wenn der Code unverändert bleibt. Ansonsten müssen Sie ständig Code und die Platzierung der Markierungen anpassen.
  • Indirekt: Ihr Code und die Markierungspunkte sind getrennt, wobei die Markierungen im Verarbeitungsschritt hinzugefügt werden. Verwenden Sie diese Methode, wenn sich Ihr zu kommentierender Text häufig ändert, oder Sie den Text nicht direkt kommentieren können oder wollen. Der Text kann sowohl direkt innerhalb von screen oder programlisting vorhanden sein, oder auf eine externe Datei zeigen, die im Verarbeitungsschritt eingelesen wird.

Beachten Sie, dass Markierungspunkte auch für Grafiken über mediaobjectco (theoretisch) möglich sind, jedoch sind diese zum Zeitpunkt der Bucherstellung noch nicht unterstützt. (Anmerkung: Ein Beispiel finden Sie im Subversion Repository von DocBook.)

  

  

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