Marc Haber <[EMAIL PROTECTED]> writes: > auf der Suche nach einem Format, in dem ich unsere firmeninterne > Dokumentation leicht verarbeiten und daraus automatisch HTML-Seiten > und PDF-Dokumente erzeugen kann, bin ich endlich dazu gekommen, mich > mal aus der Nähe mit Docbook zu beschäftigen.
Gute Idee. Wie hast Du denn die Doku vorher gemacht? > docbook gibt es sowohl SGML- als auch XML-basierend. Mir scheint, als > sei die XML-Form "moderner". Habe ich diesen Eindruck zu recht > bekommen, und ist es eine schlaue Entscheidung, die XML-Form zu > verwenden? Ja, die XML-Form ist "moderner". > (2) > Welche Debian-Packages verwendet man am besten, um aus docbook-Sources > HTML-Seiten (kapitelweise, aber auch "das ganze Dokument in einer > grossen Seite") und PDF-Dokumente zu erzeugen? Ich würde mal annehmen, dass Du mit docbook-xml* und libxml2 ziemlich weit kommst. Ich glaube die KDE und GNOME-doc Leute benutzen genau diese Kombination. > Hat jemand ein makefile, um diese Prozesse zu automatisieren? Hier ist ein snippet, dass Dir ein html erzeugt: XSLTPROC = xsltproc # Debian seems to put the xsl somewhere slightly different # STYLESHEET = /usr/share/sgml/docbook/xsl-stylesheets/html/docbook.xsl STYLESHEET = /usr/share/sgml/docbook/xsl-stylesheets-1.29/html/docbook.xsl TARGETS = foo.html .PHONY: all %.html: %.xml $(XSLTPROC) -o $@ $(STYLESHEET) $< all: $(TARGETS) > Gibt es einen Editor, der das Erstellen von XML-Sources vereinfacht, > dass man nicht immer die ganzen <em>Tags</em> manuell schreiben muss? > Hat emacs vielleicht einen dazu passenden Modus Natürlich hat Emacs einen dazu sehr gut passenden Mode. apt-cache show psgml. > ... oder bin ich vielleicht völlig auf dem Holzweg und $TOLLES_TOOL > ist viel besser zum Schreiben interner Dokumentation geeignet? Viele Leute behaupten, dass Docbook zu kompliziert sei. All die vielen Tags seien zu viel des Guten. Mit einem anständigen Editor (siehe oben) ist das ganz erträglich. -- Christian Egli wyona: research & development http://www.wyona.com -- Zum AUSTRAGEN schicken Sie eine Mail an [EMAIL PROTECTED] mit dem Subject "unsubscribe". Probleme? Mail an [EMAIL PROTECTED] (engl)