mDoc-Dokumentenerstellung ========================= mDoc wandelt ein Docbook-XML in ein beliebiges anderes Format anhand eines gleichfalls in XML vorliegenden Templates. Dabei gelten folgende Regeln: - Das Template hat den Namen .tpl - Der oberste Knoten des Templates hat folgendes Format: - Soll ein Knoten des Docbooks zu einer Ausgabe im Zielformat führen, muss das XML-Tag im Template gefunden werden. Das Template hat zwei Sektionen: x : Hier finden sich Definitionen, die in jeder XML-Tiefe auftreten dürfen x Hier finden sich Definitionen in derselben hierarchischen Ordnung wie im Docbook - XML-Tags unter können das "position"-Attribut haben: x position="first" positioniert den tpl-Wert vor die weitere Verarbeitung x Ohne Attribut wird mit der Ausgabe des Docbookinhalts fortgefahren. Bei der Weiterverarbeitung wird zuerst der (allfällige) Wert des Docbook-Tags ausgegeben, dann weitere Untertags verarbeitet. x position="last" positioiniert den Wert nach die Verarbeitung - kann jeder Stelle verwendet werden. Falls "format" das aktuelle Ausgabeformat ist, wird der Inhalt wörtlich übernommen. - Vorne im Template können Funktionen definiert werden. x Input: Sie können direkt auf die Variablen value (der Wert des tags) und source (das XML- Dokument) zugreifen. x Output: Der Wert der Variablen out wird in die Zieldatei kopiert - mDoc-spezifische Tags (Docbook-Erweiterung) x : Einzelne Zeilen innerhalb eines Paragraphen x : Definition von Testbausteinen, wenn im Paragraphen auch Hervorhebungs-Tags (wie ) vorkommen.