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)
