Welche Software um ein Handbuch zu erstellen?

[Codehunter]

Moin!

Welche Software nutzt ihr zum Erstellen von Handbüchern für Anwender? Ich rede jetzt nicht von Quellcodedokumentation sondern dem Benutzerhandbuch. Ich habe mir z.B. schon Papyrus Autor angeschaut, allerdings nicht dediziert für die Ausgabe von Hilfeformaten wie .CHM gedacht. Gefällt mir eigentlich sehr gut, vor allem wegen der im Vergleich zu Office-Lösungen besseren Layout- und Rechtschreibunterstützung. Allerdings scheint die Firma dahinter in Schwierigkeiten zu sein, denn es gelang mir über Wochen nicht, auf den gegebenen Wegen etwas zu bestellen oder Kontakt aufzunehmen.

Dann wäre da noch Help + Manual von EC Software. Das scheint sogar in Delphi geschrieben zu sein. Da macht die Webseite an sich schon den Eindruck, irgendwie veraltet zu sein (die Rede ist oftmals von Office 2013 oder Delphi XE6). Der Eindruck kann täuschen, deswegen ja die Frage nach eurer Meinung.

Was ich mir irgendwie nicht antun möchte ist LaTeX, zu viel Einarbeitungszeit, nicht intuitiv, schon gar nicht im Team mit handelsüblichen Büroangestellten.

Grüße
Cody

[haentschman]

Moin...

Ich stehe, wenn man nicht einen Online Platz hat, auf PDF. Mit Word etc. erstellt ist es "zeitlos".

[Ghostwalker]

Nun was mir noch einfällt ist HelpNDoc (https://www.helpndoc.com/de).

Das Teil ist recht Umfangreich, hat eine moderne UI und bietet verschiedenste Formate für die Ausgabe. Zum antesten kannst du dir das Teil auch über den GetIt-Manager holen.

Ansonsten wird in den Artikeln, die man so über Google findet, Help&Manual als der Marktführer in Sachen Help-Authoring aufgeführt.

Vor vielen Jahren hab ich mit der Version 4 (denk ich) von H&M gearbeitet. Es bot damals alle Möglichkeiten die ich brauchte. Inzwischen nutze ich HelpNDoc.

Die Frage ist halt, was du genau brauchst.

[hoika]

Hallo,
wir haben hier Help&Manual.

Das erstellt aus einer Vorlage diverse Formate (PDF, CHM, EPUB).

[Sherlock]

PDF ist das Format der Wahl. Wer will kann drucken, der Rest kann nach Stichworten suchen und im Prinzip alles tun. Dedizierte Hilfedateien sind, wenn man es richtig machen will (und sonst machen sie eh keinen Sinn), sehr unhandlich. Und mit Richtig meine ich kontextsensitive Hilfe. Also nicht so wie bei Delphi wo man manchmal auf einem Schlüsselwort steht und bei F1 eine Seite über den Quelltext-Editor aufgeht

Sherlock

[Codehunter]

Auf ein bestimmtes Format (PDF, CHM, Online, etc.) will ich mich gar nicht festlegen. Deshalb wären verschiedene Ausgabeformate sinnvoll, was eine vernünftige Aufbereitung des TOC und (vorallem!) Windows- bzw. Delphi-kompatibler Help-IDs einschließt. Deshalb erschien mir Help+Manual schon sinnvoll, ich kam nur ins Zweifeln als ich die Webseite sah. Helpndoc werde ich mir auch mal anschauen.

Nachtrag: Papyrus Autor hat einen sehr guten Ruf in der Autoring-Szene, ist aber eigentlich für einen anderen Einsatzzweck gedacht. Ohne Zusatzprogramme kommt man von PA nicht auf CHM. Dafür hat es aber andere Vorteile, die es so anderswo nicht gibt wie zB Duden Korrektor und Stilanalyse. Das hat schon auch seine Vorzüge. Nur was nützt das, wenn der Support/Vertrieb auf keine Anfragen reagiert und man sich auch im Forum nicht mehr anmelden kann, weil die Registrierungsseite mit ReCaptcha v1 realisiert wurde, das Google jüngst eingestellt hat und schlicht nicht mehr funktioniert?

[hstreicher]

PDF ist imho nicht so das richtige, (jedenfalls nicht allein)
da es eine festes Seitenformat vorgibt und damit auf Geräten mit kleinen Bildschirmen zur Scrollorgie verkommt



mfg Hannes

[jobo]

Da nicht ganz genau klar ist, wo die Schwerpunkt liegen, aber vermutlich Flexibilität gewünscht ist, ein vielleicht unkonventioneller Vorschlag.
Markdown
mit "Anschlussmöglichkeiten" an alle gängigen Textformate,
Konvertierung vorwärts / rückwärts nach Doc, Docx, OpenDocument und
letztlich oder direkt pdf via pandoc o.ä.

Die Konvertierungstools haben zwar ihre Grenzen und wirken im Detail etwas chaotisch (was auch am Zielformat .doc liegen mag). Aber man hat dennoch ein Quellformat, aus dem sich (fast) alles machen lässt.
Durch die Anreicherung reiner Textdateien kann man sicher gut skripten und sich u.U. auch workflows bauen, mit denen bspw. Screenshots halbwegs komfortabel angepasst werden können.
Die Tools (Bildverarbeitung) siedeln aber eher im Linuxumfeld an, zumindest stammen sie eher von dort.
Meine Anfänge damit haben noch nicht zu öffentlichen Handbüchern geführt und sind momentan pausiert, aber es geht für mich stark in die Richtung Trennung von Daten(haltung/Verarbeitung) und Visualisierung, wie es so gern beim Coding proklamiert wird.

Ist natürlich nicht gerade eine out of the box Lösung. Aber mit Docker o.ä. kommt man recht schnell zu Ergebnissen.

[bcvs]

Wieso meinst du, dass die Webseite nicht up to date ist. Der letzte Blog-Eintrag unter "Company" ist jedenfalls vom 26.03.2018.

Ich nutze Help&Manual, weil man damit verschiedene Formate aus einer einzigen Quelle erzeugen kann. CHM für kontextsensitive Hilfe und PDF für die Ausdruck-Freaks unter den Usern.

[Uwe Raabe]

Von mir auch ein klares Bekenntnis zu Help & Manual!

In meinem Anwendungsbereich muss ich fast identische Handbücher/Online-Hilfe für verschiedene Programm-Brandings erstellen. Da kommt mir die Variablen-Technik, das Handling der Screenshots und die Verwendung von Skins sehr entgegen.

Als weiteren Pluspunkt muss die Verwaltung mehrerer Sprachversionen des Handbuchs lobend erwähnt werden. Insbesondere das Synchronisieren von Änderungen und Ergänzungen ist schon sehr komfortabel.