Zum Hauptinhalt springen
AixTrust logoAixTrust logo

Übersicht

DocBook ist eine SoftwareSuite zur Erstellung von Büchern, Artikeln und Dokumentationen im technischen Umfeld, wie z.B. Release Notes, Benutzerhandbücher als PDF-Datei und Online-Hilfe im HTML-Format. Ein besonderes Merkmal ist das Single-Source Prinzip. Hier reicht eine Datenquelle um daraus verschiedene Zielformate (z.B. HTML, PDF) generieren zu können. Ein weiteres Merkmal ist die Verwendung von XML und SGML als Datenbasisformate, so dass Dokumentationen automatisiert erstellt werden können.

Installation auf z.B. Ubuntu-Systemen

  • apt-get install docbook5-xml
  • apt-get install xmlstarlet
  • apt-get install fop
  • apt-get install xsltproc
  • apt-get install xmlto

Das erste Dokument - docbook5.xml

<?xml version="1.0" encoding="UTF-8"?>

<book xmlns='http://docbook.org/ns/docbook'>
  <title>Das ist der Titel des Buches</title>
  <titleabbrev>Titel Kurzbeschreibung</titleabbrev>
  <info>
    <legalnotice><para>Eine Notiz</para></legalnotice>
    <author><personname>
      <firstname>Guido</firstname><surname>Frohn</surname>
    </personname></author>
  </info>

  <dedication>
  <para>
      Dieses Buch ist für Sie bestimmt.
  </para>
  </dedication>

  <preface>
    <title>Vorwort</title>
    <para>
        Ein Vorwort ist obligatorisch.
    </para>
  </preface>

  <chapter>
    <title>Das ist der Titel des erste Kapitels</title>
    <para>
        Das ist der Inhalt des ersten Kapitels.
    </para>
  </chapter>

  <appendix>
    <title>Anhang</title>
    <para>
        Das ist der Inhalt des optionalen Anhangs.
    </para>
  </appendix>
</book>
 

XML Validierung und Transformation nach PDF

echo "PDF Generierung..."
echo "Validierung mit JING (Input RNG (RELAX NG) und XML)..."
wget docbook.org/xml/5.0/rng/docbook.rng
wget docbook.org/xml/5.0/rng/docbook.rnc
jing -f ./docbook.rng ./docbook5.xml
echo "Validierung mit XMLSTARLET (Input XSD, XML)..."
xmlstarlet val --err --xsd /usr/share/xml/docbook/schema/xsd/5.0/docbook.xsd ./docbook5.xml
echo "XSLPROC (Input XSL, XML) -> FO..."
xsltproc /usr/share/xml/docbook/stylesheet/docbook-xsl-ns/fo/docbook.xsl ./docbook5.xml > ./docbook5.fo
echo "FOP (Input FO) -> PDF..."
fop -fo ./docbook5.fo -pdf ./docbook5.pdf

Links