Re: Dokumentation
Joerg Hoh wrote:
Was wird den verwendet, um DocBook XML zu schreiben? Den Editor der Wahl
oder irgendwas spezielles?
Der Editor der Wahl. Die Manual-Dateien enthalten dabei jeweils
Konfigurationsblöcke für den Emacs psgml Mode und für vim.
Ich persönlich benutze XEmacs mit psgml Mode, der hat die nette
Eigenschaft DTDs zu 'verstehen' und kann so in jeder Situation
die im aktuellen Kontext zulässigen Tags per Kontextmenü anbieten.
Für einen Anfänger ist das sicherlich nicht
einfach, aus der Unmenge an Tags die richtigen für den aktuellen Zweck
rauszufinden.
Das ist bei LaTeX aber doch auch so?
Ich persönlich benutze LaTeX wenn ich reine Print-Dokumente oder
PDF-Präsentationen (pdfscreen) erzeugen möchte und DocBook wenn
neben Print auch noch andere Formate generiert werden sollen.
Beides erfordert zunächst einmal einen gewissen Lernaufwand,
beides hat seine 'Merkwürdigkeiten'. Insbesondere die Tücken
der DocBook Stylesheets (sowohl DSSSL als auch XSLT) habe ich
bei den Anpassungen für das PHP Manual gelegentlich auch hassen
gelernt.
Aber es sind auch die einzigen Formate die ich kenne die das
verteilte Arbeiten an einem Dokument ermöglichen.
(Zum PHP Manual und seinen Übersetzungen dürften mittlerweile
ca. 300 Personen weltweit direkt beigetragen haben).
--
Hartmut Holzgraefe, Senior Support Engineer .
MySQL AB, www.mysql.com
Are you MySQL certified? www.mysql.com/certification
Reply to: