Eclipse Help System

[sirferguson]

Hallo miteinander!

Da wir bei unserem RCP Projekt mit der Eclipse Help arbeiten um dem User einfach die Programmfunktionen zu erläutern, wird eine Word Dokumentation geschrieben welche schliesslich durch Handarbeit in die Eclipse Help integriert wird.
Nun soll das ganze automatisiert werden und ich wurde dafür eingeteilt.
Ich wollte Nachfragen ob es solche Tools schon gibt, ob jemand Lösungsansätze oder eine ausführliche Eclipse Help Dokumentation kennt.

Grüsse

[Christian Marquardt]

Was könnte es für einen Sinn machen, die Hilfe erst in Word zu schreiben und dann in das Zielsystem zu bringen?

Die RCP-Hilfe basiert auf HTML mit Verknüpfungen zum Programmiersystem.

Wie soll da ein Export von Word aussehen? Wo sollten die Verknüpfungen angelegt werden?

[sirferguson]

Nun die Leute welche das Word Dokument schreiben sind gerade mal mit Word vertrau und alles andere ist für sie speziell, darin liegt das Problem.
Genau das ist mein Problem, ich habe nun verschiedene Lösungsansätze angeschaut, unter anderem hat ein Arbeiter eine Applikation geschrieben welche das ganze Konvertiert allerdings bringt diese viele Fehler mit sich.

[Flokle]

Soweit ich weiß, lässt sich ein Word Dokument als HTML exportieren. Gib den Leuten, die die Doku schreiben bestimmte Vorgaben zur Struktur, exportiere die Dokumente als HTML, entferne die im Header enthaltenen CSS Styles. Nebenbei fertigst du ein eigenes Stylesheet an, dass du in Eclipse für die Hilfe eurer Anwendung integrieren kannst. Schon hast du eine überall sowohl gleich strukturierte, als auch gleich ausschauende Hilfe.

P.S.: Für das Entfernen der CSS Styles im Header, könnte dir der andere "Arbeiter" sicherlich ein Tool basteln. Oder, um darüber hinaus zu gehen, gleich ein Tool, dass bei allen Dokumenten diesen Header entfernt, die Files in das passende Verzeichnis kopiert und diese direkt in die Hilfe integriert.

Grüße, Florian

[Christian Marquardt]

Hast du dir mal angesehen, was dabei rauskommt, DOC als HTML zu speichern?

Unten mal die Ausgabe von einer Zeile.

Da ist es nicht getan damit, nur die CSS zu entfernen. Wer soll das warten?

<p class=MsoToc3><span style='mso-no-proof:yes'>4.3.1</span><span
style='font-size:12.0pt;font-family:"Times New Roman";mso-no-proof:yes'><span
style='mso-tab-count:1'>      </span></span><span style='mso-no-proof:yes'>Das hier ist der Text<span style='display:none;mso-hide:
screen'><span style='mso-tab-count:1 dotted'>. </span></span></span><!--[if supportFields]><span
style='display:none;mso-hide:screen;mso-no-proof:yes'><span style='mso-element:
field-begin'></span> PAGEREF _Toc272927749 \h </span><span style='mso-no-proof:
yes'><span style='display:none;mso-hide:screen'><span style='mso-element:field-separator'></span></span></span><![endif]--><span
style='display:none;mso-hide:screen;mso-no-proof:yes'>5<!--[if gte mso 9]><xml>
 <w:data>08D0C9EA79F9BACE118C8200AA004BA90B02000000080000000E0000005F0054006F0063003200370032003900320037003700340039000000</w:data>
</xml><![endif]--></span><!--[if supportFields]><span style='display:none;
mso-hide:screen;mso-no-proof:yes'><span style='mso-element:field-end'></span></span><![endif]--><span
style='font-size:12.0pt;font-family:"Times New Roman";mso-no-proof:yes'><o:p></o:p></span></p>

[Flokle]

Wenn er jetzt noch die "style" Attribute inklusive Wert entfernt, sieht das ganze doch schon nicht schlecht aus. Okay, er hat ne Menge überflüssige "span" Tags dabei, aber lieber das, als alles von Hand zu überführen.

P.S.: Lässt sich in Word zu dem Export nichts konfigurieren?

[Christian Marquardt]

Wenn er jetzt noch die "style" Attribute inklusive Wert entfernt, sieht das ganze doch schon nicht schlecht aus. Okay, er hat ne Menge überflüssige "span" Tags dabei, aber lieber das, als alles von Hand zu überführen.

Das wäre Gefrickel, was einem über kurz oder lang auf die Füsse fällt