Fragen zu DocBook

[Flocke]

Ich habe hier einige ältere Programme, bei denen eine Aktualisierung ansteht. In diesem Rahmen möchte ich auch die Hilfe von WinHelp auf CHM umstellen und am liebsten aus beiden Dokumentationen (Handbuch und Online-Hilfe) eine machen.

Dabei bin ich auf DocBook gestoßen.

Vom Prinzip her ganz toll - eine Quelle (noch dazu relativ universelles XML), und man kann HTML (eine/mehrere Dateien), CHM, RTF, TeX, PDF daraus generieren.

Die Konvertierung von DocBook nach HTML / CHM klappt auch ganz wunderbar , das geht mit den XSL-Stylesheets und einem xslt-Prozessor (sowohl msxsl als auch xsltproc funktionieren).

Was ich absolut nicht zum Laufen kriege ist Jade/OpenJade, um in Kombination mit den DSSSL-Stylesheets nach TeX zu konvertieren . Das möchte ich aber eigentlich, einfach wegen der extrem guten Qualität, die eine mit TeX erzeugte Druckvorlage hat. Zur "Not" könnte ich auch mit einer Konvertierung direkt nach PDF leben, aber den Weg über XSL-FO hab' ich noch nicht ausprobiert.

Jetzt meine Frage: hat einer von euch vielleicht schon (erfolgreiche) Erfahrungen mit DocBook gesammelt, nicht unbedingt nur in Hinsicht auf die Konvertierung nach TeX (obwohl mich das schon besonders interessiert)? Da ich gerade in der Entscheidungsfindungsphase bin, würde mir auch allgemeines Feedback zu DocBook helfen, sei es positiv oder negativ.

[sh17]

Mit welchem Editor/System schreibst Du denn die DocBooks? Da gibt es ja ziemlich viele Systeme.

[Flocke]

Zitat von sh17:

Mit welchem Editor/System schreibst Du denn die DocBooks? Da gibt es ja ziemlich viele Systeme.

Momentan mit einfachen Texteditoren (z.B. jEdit ist ganz gut dafür geeignet) - allerdings bin auch jemand, der HTML-Seiten gerne mit Notepad schreibt

Welche "vielen Systeme" meinst du denn?

[sh17]

z.B. hat

http://www.e-novative.de/software/ede.php

alles vorbereitet in einer Umgebung.

Docbook schreiben, batch aufrufen, fertig

[Flocke]

eDE hatte ich mir schon heruntergeladen und hab's mir jetzt auch mal angesehen (d.h. installiert und getestet).

Zunächst ist es eine recht - ich nenn' es mal so - "eingeschränkte" Umgebung, die zwingend unter C:\DocBook installiert werden muss (wird man bestimmt ändern können, man wird bei der Installation aber nicht gefragt). Die Befehle operieren alle auf einer festen Verzeichnisstruktur (unterhalb dieses Verzeichnisses), so dass eine vernünftige Einbindung in eine Sourcecodeverwaltung schwer fällt.

Auch finde ich Saxon als xlst-Prozessor nicht so toll, xsltproc läuft schneller (und runder).

Zur Ausgabe: HTML und CHM werden vernünftig erzeugt, PDF sieht ehrlich gesagt nicht gerade aus wie das Gelbe vom Ei - kann sein, dass es an den (Grund-)einstellungen liegt, aber von dem Weg über FO(P) bin ich qualitativ absolut nicht überzeugt.

Fazit: so weit war ich mit meiner Installationen von Hand auch schon, allerdings (m.M.n.) besser, da nicht so fest verdrahtet.


Das bringt mich auf meine ursprüngliche Frage zurück, ob Jemand vielleicht Jade/OpenJade unter Windows zum Laufen gebracht und auf diesem Weg TeX (und daraus PS/PDF) generiert hat.

[Flocke]

*Push*

Hat denn wirklich Niemand Erfahrung mit DocBook/[Open]Jade -> TeX?