Dokumentation mit DocBook

Dokumentation mit DocBook

Posts 1-1 of 1
  • User photo
    Karsten Krumrück    Premium Member   Group moderator
    The company name is only visible to registered members.
    Docbook als Basis für automatisierten Dokumentationsprozess
    Hallo,

    wir haben in unserer Firma einen langen Prozess durchgemacht von der Erstellung der Doku mit Word hin zu einem automatisierten Dokumentationsprozess auf Basis von Docbook. Mit der alleinigen Umstellung des Formats ist es nämlich meist nicht getan, es ist nur der Anfang.

    Wenn man erstmal mit der Optimierung des Dokumentationsprozesses beginnt, kommt eins zum anderen. Würde mich interessieren, welche Erfahrungen andere Redakteure gemacht haben. Bei uns hat der ganze Prozess ca. 1,5 Jahre gedauert. Bedauert haben wir den Schritt nicht, Word fasse ich jetzt nur noch an, wenn es unbedingt sein muss. Unser System besteht jetzt aus folgenden Komponenten:

    - Subversion (Versionsverwaltung)
    - DocBook XML (XML Schema)
    - Syntext Serna (graphischer XML Editor)
    - Saxon (XSL-Prozessor)
    - Apache FOP (PDF-Generierung)
    - Apache Forrest (Dokumentations-Framework für Online-Portal)
    - Apache (Webserver)
    - Hyper Estraier (Suchmaschine für Online-Portal)
    - Python (Scriptsprache für Steuerungsscripts)

    Kleine Anmerkung: Alle Tools sind Open Source

    Bin gerade dabei, meine Erfahrungen in unserem Blog niederzuschreiben. Also wen es interessiert: http://www.saperionblog.com/2009/10/technische-dokumentation...


    Viele Grüße
    Karsten Krumrück
    • 09 Oct 2009, 3:11 pm