DocBook ist ein Standard für das Markup strukturierter Texte. Technisch handelt es sich um eine SGML- oder XML-Anwendung, ähnlich wie HTML bzw. XHTML. DocBook eignet sich vor allem für technische Dokumentation, aber auch andere Anwendungen sind möglich. Das LinuxDoc Projekt verwendet mittlerweile DocBook als Standardformat, es ersetzt das ältere LinuxDoc/SGML, welches einfacher und wesentlich weniger mächtig ist.
Referenzdokumentation und Tutorial zugleich ist "DocBook, The Definitive Guide", verlegt von O'Reilly und unter der GNU Free Documentation License lizenziert. Die Online-Version liegt auf http://docbook.org/tdg, der Quellcode des Buchs, natürlich in !DocBook/XML, ist ebenfalls einsehbar: http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/docbook/defguide/en/. Der Quellcode taugt durchaus als gutes Beispiel für DocBook-Code.
Links
Fragen
Schade, dass !DocBook/SGML offiziell abgelöst wird. SGML ist leichter zu editieren, weil der Parser mitdenkt, und die Werkzeuge sind weit ausgereifter als ihre XML-Äquivalente. Besonders druckreife Ausgabe funktioniert derzeit praktisch nur mit SGML-Werkzeugen, die zum Glück auch XML verstehen. Imho arbeitet man effizienter, wenn man in SGML schreibt und bei Bedarf nach XML konvertiert.
- Druckreife Ausgabe erzeugen kann man zum Beispiel mit dem Paket
DocBookToConTeXt Eine andere Möglichkeit ist PassiveTex. 2024-11-02 21:41:40 Johannes
Frage: gibt es einen Konverter von DocBook (SGML und/oder XML) nach (MoinMoin-)Wiki-Markup? Es ist ausreichend, wenn dabei der Doku-Inhalt brauchbar übersetzt wird (Text, Überschriften, Aufzählungen, Links, ...) - einige der Meta-Informationen können evtl. in einen Wiki-Markup-Kommentar umgeformt werden.
Dann könnte man nämliche div. Doku ins Wiki übernehmen. Den umgekehrten Weg kann man (== der DocBook-Doku-Maintainer) dann manuell über die Diff-Anzeige zur urspr. Version machen, da eine automatische Übersetzung von einem einfacheren Markup wie Wiki auf ein mächtigeres wie DocBook ja kaum möglich ist (bzw. dann eben das Wiki.Markup ähnlich verkomplizieren oder durch Zusatzinfos aufblähen würde).
Hat sich quasi erledigt, schreibe grad selbst einen. 