Womit wurde SELFHTML erstellt?
Volker B. Duetsch
- sonstiges
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
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
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
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
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
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