Volker B. Duetsch: Womit wurde SELFHTML erstellt?

Hallo,

mich würde interessieren mit welchem System die SELFHTML-Dokumentation erstellt wurde/wird. Infos zur Versionierung (Subversion, CVS) verwendetes Dokumentationsframework (Docbook?) etc. würden mich sehr interessieren.

Gruß
Volker

  1. Moin!

    mich würde interessieren mit welchem System die SELFHTML-Dokumentation erstellt wurde/wird. Infos zur Versionierung (Subversion, CVS) verwendetes Dokumentationsframework (Docbook?) etc. würden mich sehr interessieren.

    Wir haben erst mit dem Beginn zur Arbeit an Version 8.1 SVN zur Versionskontrolle eingesetzt (da waren erstmals mehrere Autoren parallel an der Arbeit), vorher war das gesamte SELFHTML pure Handarbeit im Texteditor von Stefan Münz. Und außer SVN wird auch jetzt noch keine weitere Automatik eingesetzt.

    Wir planen, Version 9 nicht mehr als HTML, sondern als XML zu schreiben, und die HTML-Seiten dann per XSLT zu generieren, um die lästigen Arbeiten wie Inhaltsverzeichnisse künftig automatisch erstellen zu lassen. Da ist aber noch kein Byte Code zu geschrieben worden.

    - Sven Rautenberg

    --
    My sssignature, my preciousssss!
    1. Moin!

      mich würde interessieren mit welchem System die SELFHTML-Dokumentation erstellt wurde/wird. Infos zur Versionierung (Subversion, CVS) verwendetes Dokumentationsframework (Docbook?) etc. würden mich sehr interessieren.

      Wir haben erst mit dem Beginn zur Arbeit an Version 8.1 SVN zur Versionskontrolle eingesetzt (da waren erstmals mehrere Autoren parallel an der Arbeit), vorher war das gesamte SELFHTML pure Handarbeit im Texteditor von Stefan Münz. Und außer SVN wird auch jetzt noch keine weitere Automatik eingesetzt.

      Wir planen, Version 9 nicht mehr als HTML, sondern als XML zu schreiben, und die HTML-Seiten dann per XSLT zu generieren, um die lästigen Arbeiten wie Inhaltsverzeichnisse künftig automatisch erstellen zu lassen. Da ist aber noch kein Byte Code zu geschrieben worden.

      • Sven Rautenberg

      Vielen Dank für die Information - habt ihr schon einmal über Docbook (Infos unter: http://www.itwdb.de/index.php?cat_id=1) nachgedacht?
      Dort gibt es bereits umfangreiche XSL-Stylesheets für die Transformation (ich habe ein anderes Projekt (http://www.linuxsource.de) mit der Website.dtd des Docbook-Frameworks und den enstprechenden XSLT-Files erstellt). Die Toolchain ist sowohl für Windows als auch GNU/Linux-Systeme verfügbar.

      Volker

      1. Moin!

        Vielen Dank für die Information - habt ihr schon einmal über Docbook (Infos unter: http://www.itwdb.de/index.php?cat_id=1) nachgedacht?
        Dort gibt es bereits umfangreiche XSL-Stylesheets für die Transformation (ich habe ein anderes Projekt (http://www.linuxsource.de) mit der Website.dtd des Docbook-Frameworks und den enstprechenden XSLT-Files erstellt). Die Toolchain ist sowohl für Windows als auch GNU/Linux-Systeme verfügbar.

        Docbook ist unseren XML-Spezialisten bekannt, es hat unseren speziellen Anforderungen aber nicht genügt. Wir schreiben ja keine allgemeine Dokumentation, sondern müssen beispielsweise so spezielle Informationen wie "funktioniert im Browser X, Y und Z ab Version 1, 2 und 3" unterbringen.

        - Sven Rautenberg

        --
        My sssignature, my preciousssss!
      2. Hallo,

        Vielen Dank für die Information - habt ihr schon einmal über Docbook (Infos unter: http://www.itwdb.de/index.php?cat_id=1) nachgedacht?
        Dort gibt es bereits umfangreiche XSL-Stylesheets für die Transformation (ich habe ein anderes Projekt (http://www.linuxsource.de) mit der Website.dtd des Docbook-Frameworks und den enstprechenden XSLT-Files erstellt). Die Toolchain ist sowohl für Windows als auch GNU/Linux-Systeme verfügbar.

        Sven hat schon das Wesentliche gesagt.
        Ich habe nicht nur Docbook oder TEI, sondern auch andere Standards in Betracht gezogen. Aber keiner war bzw. bot das, was wir wirklich brauchten. Deshalb wurde daraus eine eigene XML-Sprache.
        (Es gibt einige Dokumentationsprojekte im Internet, die Docbook verwenden. Aber du kannst dabei deutlich sehen, wie lineal diese Dokumente aufgebaut sind. Sie sind eigentlich nicht fürs Web geeignet.)

        Grüße
        Thomas

  2. Hallo Volker,

    mich würde interessieren mit welchem System die SELFHTML-Dokumentation erstellt wurde/wird. Infos zur Versionierung (Subversion, CVS) verwendetes Dokumentationsframework (Docbook?) etc. würden mich sehr interessieren.

    Die Frage hatten wir vor kurzem: </archiv/2005/10/t117355>

    Grüße
     Roland