Re: Dokumentation
Joerg Hoh wrote:
On Fri, Jan 21, 2005 at 07:13:42PM +0100, Hans-Peter Prenzel wrote:
* bernd <bernd.grah@sternverteiler.de> [050121 19:00]:
[...]
Kann mir jemand ein Programm empfehlen, mit dem ich diesen "Spagat"
hinbekomme ??
>
XML Docbook wäre auch noch eine Alternative, aber das ist im Moment eher
eine riesige Arbeit denn für den Enduser brauchbar.
Docbook erst einmal aufzusetzen ist tatsächlich etwas aufwendiger,
die Ergebnisse können sich aber durchaus sehen lassen.
Im Gegensatz zu LaTeX ist das Format allegmein gehalten und alle
Ausgabeformate werden mehr oder weniger gleich gut unterstützt.
Bei LaTeX und latex2html hat man ja immer das Problem das bei
der Konvertierung nach HTML nicht alle TeX-Packete 'verstanden'
werden.
Bei der Druckausgabe wird i.a. als Zwischenformat dann wieder
auf TeX zurückgegriffen, der Schriftsatz bietet somit weiter
die gewohnte Qualität. Die direkte Verarbeitung mit XSL-FO
dagegen ist noch nicht wirklich brauchbar.
DocBook "in Aktion" kann man z.B. beim PHP Manual sehen, hier
werden alle Ausgabeformate bis hin zur bunten Online-Version
aus den gleichen DocBook Quellen erzeugt. Auch die Einbindung
der verschiedenen Übersetzungen wird damit gemanaged.
Näheres zum Aufbau des PHP Documentation Projects gibt es hier
http://www.php.net/manual/howto/
Alle im PHP Manual Source enthaltenen Tools sind entweder unter
der PHP Lizenz (entspricht der 'alten' Apache Lizenz) oder der
GPL lizensiert, können also ohne Probleme auch für eigene
Dokumentationsprojekte eingesetzt werden.
--
Hartmut Holzgraefe, Senior Support Engineer .
MySQL AB, www.mysql.com
Are you MySQL certified? www.mysql.com/certification
Reply to: