XML-Schema – DocBook XML im Detail

Die Möglichkeit, ein Dokument zu schreiben und es dann in vielen verschiedenen Ausgabeformaten zu erstellen, war im Laufe der Jahre ein Traum vieler Entwicklungsteams. Dies kann durch DocBook XML erreicht werden, das nicht nur das semantische Markup beibehält, sondern auch die Kontrolle über die Datenformatierung und -ausgabe behält. Die Kontrollsemantik kann die Kapitel und Absätze angeben, aus denen das Dokument besteht. Die enthaltenen Elemente können im Absatz näher spezifiziert werden. Beispielsweise war es im Laufe der Jahre ein Traum vieler Entwicklungsteams, ein Dokument schreiben und es dann in verschiedenen Ausgabeformaten erstellen zu können. Dies kann durch DocBook
XML erreicht werden, das nicht nur das semantische Markup beibehält, sondern auch die Kontrolle über die Datenformatierung und -ausgabe behält. Kontrollsemantik kann die Kapitel und Absätze angeben, aus denen das Dokument besteht. Die enthaltenen Elemente können im Absatz näher spezifiziert werden. Beispielsweise können Sie die Befehls- und
Funktionsnamen in separate Tags einfügen, wie in Listing 8 gezeigt.
Listing 8. Befehle und Funktionen in separate Tags einschließen ​                                                                                                                                                                                                                                                                

<para>The <command>compile</command> takes the source code of the 

material and builds a new class based on the filename. For example, if the filename is

<filename>HelloWorld</filename> then the name of the class generated will be

<classname>HelloWorld</classname>.

Bei der Anzeige verschiedener Elemente können Sie verschiedene Ausgabestile und -formate oder denselben Stil auswählen. Noch wichtiger ist, dass semantische Informationen zurückgegeben werden (das Dokument kann beispielsweise eine

Referenz auf einen Klassennamen enthalten) und beim Schreiben des Index zum Generieren einer Liste verwendet werden können, die alle enthält Klassennamen, die in der Dokumentation aufgeführt sind). Zusätzlich zum semantischen Markup können Abschnitte und verschiedene Teile eines Dokuments mit speziellen IDs markiert werden, und diese IDs können verwendet werden, um Verknüpfungen zwischen verschiedenen Teilen des Dokuments zu erstellen. Einige Typen können
automatisch vervollständigt werden (Kapitel, Abschnitte und andere Typen, die ein Inhaltsverzeichnis generieren), andere müssen explizit Links zu anderen Abschnitten einrichten. Diese Links können bei der Konvertierung in das Zielformat automatisch in das entsprechende Format umgewandelt werden. Der Link wird beispielsweise in die entsprechende HTML-Seite umgewandelt oder auf einen Anker innerhalb der Seite verlinkt. Wenn Sie eine PDF-Datei erstellen, können Sie die Seitenzahl des Zielkapitels angeben.
Diese Konvertierung erfolgt durch das
XSLT-Stylesheet. Vorhandene Standard-DocBook-XSLT-Stylesheets unterstützen die Konvertierung in Standard-HTML, XHTML, PDF (über den FO-Standard), Texinfo, Java™-Hilfe und Manpages. Mithilfe von Standard-Stylesheets können Daten auch in eine Vielzahl unterschiedlicher Größen und Stile, Bücher, A4-Seiten und Folien umgewandelt werden. Die Flexibilität verschiedener Ausgabeformate und Markups bedeutet, dass beim Erstellen von Dokumentationen derselbe Dokumentationsquellcode verwendet werden kann, um gedruckte Handbücher, eingebettete Hilfe, Manpages sowie Online- und kontextbezogene Informationen bereitzustellen. Mit dem traditionelleren
Modell können diese Elemente separat geschrieben werden. DocBook
XML ist in der Fachartikel-Community weithin anerkannt und alle Dokumente vieler Unternehmen übernehmen den DocBook XML-Standard (oder eine Teilmenge davon).                                                                                                                                                

Das obige ist der detaillierte Inhalt vonXML-Schema – DocBook XML im Detail. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!