Online-Hilfe

[tosca]

Hallo allerseits,

ich weiß, dass das Thema Online-Hilfe hier schon einige Male zur Diskussion stand und ich habe mir auch einige der Beiträge dazu durchgelesen. Trotzdem bin ich mir noch nicht ganz schlüssig.

Also ich habe eine Web-Anwendung mit Java EE und Wicket und dafür soll sowohl eine Online-Hilfe als auch ein Benutzerhandbuch (PDF) erstellt werden. Nun ist meine Vorstellung die, dass ich die Hilfe nur ein Mal erstelle und damit spätere Änderungen auch nur an einer Stelle einpflegen muss und die Hilfe dann sowohl als verlinkte Online-Hilfe als auch als PDF bereitstellen kann.

Nun habe ich aus diesem Forum soweit herausgelesen, dass EclipseHelp JavaHelp vorzuziehen ist. Aber für EclipseHelp erstellt man im Endeffekt HTML-Seiten, richtig? Und die lassen sich dann wahrscheinlich nicht so ohne weiteres in PDFs umwandeln.

Außerdem habe ich noch ein bißchen was über DocBook und DITA gelesen, da kann man sowohl HTML-Seiten als auch PDFs generieren. Da bin ich mir aber nicht so sicher, wie gut man das in eine Web-Anwendung einbinden kann.

Hat jemand einen Tip? Oder vielleicht noch ein ganz anderes Framework? Oder einen Link, wo Hilfe-Frameworks verglichen werden?

 

[Gast2]

Ich würde die Texte in einem XML Format erstellen. Dann kannst du das z.B. mit XSLT in jedes beliebige Format exportieren, PDF, Word Dokument, Text Datei, HTML etc.

Natürlich kann man auch HTML Dateien in PDF umwandeln, HTML ist letzlich auch nur eine Markup Language (bei XHTML sogar valids XML). Ist immer als eine Frage wie aufwändig soetwas ist.

XML + XSLT ist immer ganz nett finde ich.

 

[tosca]

Sowohl DocBook als auch DITA basieren auf XML. Momentan tendiere ich dazu, DITA zu verwenden...

 

[Wildcard]

Wir verwenden dazu Daisy Wiki. HTML und PDF beherrscht Daisy out-of-the-box. Mit ein paar Handgriffen (XSLT, oder Java-Code) lässt sich der HTML Export so erweitern das er direkt Eclipse Help auswirft. Für uns funktioniert das wirklich sehr gut, auch weil Daisy sehr schöne Editier, Versionierungs und Diff Möglichkeiten bietet.