Nummerieren von Zeilen

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

Möchten Sie in Ihren Listing jede Zeile nummerieren, ist dies gegenwärtig nur mit Saxon oder Xalan möglich, nicht jedoch mit xsltproc.

Zum Nummerieren einzelner Zeilen wird das linenumbering-Attribut verwendet:

<programlisting linenumbering="numbered">#!/usr/bin/python -u
  ...
</programlisting>

Standardmäßig startet die Zeile mit 1, durch das optionale Attribut startinglinenumber lässt sich eine beliebige Startnummer angeben. Wenn Sie von einem früheren Listing weiterzählen möchten, geben Sie continuation mit dem Wert continues an.

Damit die Zeilen nummeriert werden, müssen Sie in den DocBook-Stylesheets die beiden Parameter use.extensions und linenumbering.extension auf den Wert 1 setzen. Wenn Sie weitere Eigenschaften wie den Zählabstand, die Breite und den Trenner individuell beeinflussen möchten, benötigen Sie Verarbeitungsanweisungen. Das folgende Beispiel zeigt Ihnen den Code.

Beispiel: Beeinflussen von Zählabstand, Breite und Trenner durch Verarbeitungsanweisungen

<programlisting linenumbering="numbered"
><?dbhtml
  linenumbering.everyNth="2"   
  linenumbering.separator=" |" 
  linenumbering.width="2"     
?><?dbfo
  linenumbering.everyNth="2"   
  linenumbering.separator=" |" 
  linenumbering.width="2"       
?>#!/usr/bin/python -u
  ...
</programlisting>

Zeile 1: Fügen Sie das Attribut linenumbering ein und platzieren Sie die Verarbeitungsanweisung(en) so, dass kein zufälliger Leerraum eingefügt wird.
Zeile 2: Diese Verarbeitungsanweisung hat als Ziel (X)HTML.
Zeile 3: Zählabstand, hier jede zweite Zeile.
Zeile 4: Trenner zwischen Zeilennummer und Zeilentext
Zeile 5: Breite der Spalte
Zeile 6: Diese Verarbeitungsanweisung hat als Ziel XSL-FO. Die Parameter sind die selben wie bei Zeile 2.

Weitere Informationen zu den obigen Verarbeitungsanweisungen finden Sie in Endformat mit Verarbeitungsanweisungen justieren.

  

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