Autor Beitrag
Vera
ontopic starontopic starontopic starontopic starontopic starontopic starontopic starhalf ontopic star
Beiträge: 82

WinXP Home
Delphi 2005 Personal
BeitragVerfasst: Fr 03.03.06 08:58 
Hallo liebes Forum! ;-)

Wir in der Firma sind bald so weit und müssen eine CHM Hilfe für unser Programm estellen. Das schreiben der Hilfe ist zum Glück nicht unsere Aufgabe sondern die übernimmt ein Technischer Redaktuer. Allerdings muss ich mich um die technische Umsetzung kümmern. Also die entsprechenden Tools bereits stellen, den Prozess definieren, etc.

Wichtig für mich ist, dass das Handbuch (welches gedruckt werden soll) auf den gleichen "Sourcen" wie die CHM Hilfe basiert (um doppelte Arbeit zu ersparen).

Meine Frage ist also recht allgemein gehalten: Wie erzeugt Ihre Eure CHM Hilfe Dateien? Welche Tools benutzt Ihr? Womit erstellt Ihr Eure Handbücher?

Vielen dank!!

Bye, Vera!
chrisdrury
ontopic starontopic starontopic starontopic starontopic starontopic starontopic starhalf ontopic star
Beiträge: 184

WinXP
D5 Prof
BeitragVerfasst: Fr 03.03.06 09:54 
Hallo,
zum Erstellen der CHM-Dateien verwende ich den Microsoft HTML Help Workshop, allerdings momentan eine sehr veraltete Version (1.2).
Schau doch mal auf www.microsoft.com vorbei, dort müßte es doch eibentlich eine aktuelle Version zum Download geben.
Alpha_Wolf
ontopic starontopic starontopic starontopic starontopic starontopic starontopic starofftopic star
Beiträge: 297

Ubuntu, Win XP, Win Vista
C#, Delphi 6 Prof, Delphi 2007 Prof, Java
BeitragVerfasst: Fr 03.03.06 10:11 
Wir benutzen FastHelp (www.fast-help.com/)

Ich bin damit sehr zufrieden.. guck dir einfach mal den link an.

Für Dokumentationen kommts immer drauf an was man dokumentiert.. wenn ichs aus UML raus mach benutz ich den Enterprise Architect.. oder eben direkt aus Delphi mit DelphiDoc 1.5.0.255.

_________________
Diskutiere nie mit einem Irren - er zieht dich auf sein Niveau und schlägt dich mit seiner Erfahrung.
Jailbird
ontopic starontopic starontopic starontopic starontopic starontopic starhalf ontopic starofftopic star
Beiträge: 127

Windows XP Pro SP2
Delphi 7 Professional
BeitragVerfasst: Fr 03.03.06 10:37 
Da's für die Firma ist, wird's wohl auch etwas kosten dürfen...deshalb mein Vorschlag: "Help & Manual"

Erlaubt Export in die gängisten Formate (chm, hlp, html, pdf) und ist meiner Meinung nach relativ einfach in der Handhabung. Einfach mal die Testversion ansehen :)

www.helpandmanual.com/
MSCH
ontopic starontopic starontopic starontopic starontopic starontopic starontopic starhalf ontopic star
Beiträge: 1448
Erhaltene Danke: 3

W7 64
XE2, SQL, DevExpress, DevArt, Oracle, SQLServer
BeitragVerfasst: Fr 03.03.06 10:46 
Was hälst du von Helpmaker (www.vizacc.com/gen_download.php)
very simple, very gratis, very good.

grez
msch

_________________
ist das politisch, wenn ich linksdrehenden Joghurt haben möchte?
digi_c
ontopic starontopic starontopic starontopic starontopic starontopic starhalf ontopic starofftopic star
Beiträge: 1905

W98, XP
D7 PE, Lazarus, WinAVR
BeitragVerfasst: Fr 03.03.06 13:06 
Wir haben Dok-o-matic hier im Betrieb. Schaut sehr brauchbar as für Klassendokus, man kann auch damit Handbücher machen. Man kommentiert den Source und er sucht sich das dann zusammen.
Handbücher machen wir als statische HTML Dateien die in der Software verlinkt werden *ohneWorte*

Privat bin ich bei Helpmaker gelandet da OSS, die Bedienung ist aber nicht sehr prall :(
Aber Robohelp und einige andere die ich getestet hatte waren teuer und auch nicht wirklich überzeugend.

Wichtig bei sowas IMHO das ihr eure wertvolle Arbeit hinterher wieder raus kriegt und nicht alles manuell eintragen müsst. Richtig kompliziert wird es aber wenn ihr das Programm erweitert,übersetzt,... und die Doku synchron halten sollt, da habe ich noch nichts vernünftiges gesehen. Oder wenn man zusätzlich noch fürs web entwickelt.

Auch das einbinden von der .CHM ist per se nicht so einfach wie eine .HLP, von HTML würde ich die Finger lassen, der Aufwand steht in keinem Verhältnis. Überlegt euch vorher genau was ihr einsetzen wollt(aufrufen von Programmfenstern durch Hilfe,... und wie das zu machen ist)

Für das Handbuch würde ich einfach OpenOffice nehmen und eine .PDF generieren. Da habt ihr die besten Möglichkeiten mit(Vorlagen,Zusammenarbeit,Überarbeitung,...).
Jailbird
ontopic starontopic starontopic starontopic starontopic starontopic starhalf ontopic starofftopic star
Beiträge: 127

Windows XP Pro SP2
Delphi 7 Professional
BeitragVerfasst: Fr 03.03.06 13:16 
@digi_c...schau dir selber mal Help & Manual an...du kannst da Anhand einer Master-Sprache relativ einfach in eine weitere Sprache übersetzen sowie auch zu späteren Zeitpunkten synchronisieren.
digi_c
ontopic starontopic starontopic starontopic starontopic starontopic starhalf ontopic starofftopic star
Beiträge: 1905

W98, XP
D7 PE, Lazarus, WinAVR
BeitragVerfasst: Fr 03.03.06 15:09 
Hatte ich auch schon, war in der Tat nicht schlecht aber ebend kommerziell.
digi_c
ontopic starontopic starontopic starontopic starontopic starontopic starhalf ontopic starofftopic star
Beiträge: 1905

W98, XP
D7 PE, Lazarus, WinAVR
BeitragVerfasst: Sa 04.03.06 14:42 
Bin gerade auf [url=www.doxygen.org]Doxygen [/url](in Zusammenspiel mit pas2dox) gestoßen. Sieht sehr leistungsfähig aus, zumindest für Klassendokumentation
digi_c
ontopic starontopic starontopic starontopic starontopic starontopic starhalf ontopic starofftopic star
Beiträge: 1905

W98, XP
D7 PE, Lazarus, WinAVR
BeitragVerfasst: Do 18.05.06 13:14 
Doxygen habe ich nicht hinbekommen. Auch ESSModel(OSS)unterstützt auch den Export nach HTML. DelphiDoc ist aber meine Empfehlung, trennt auch Benutzer und Systemdoku, erlaubt Mehrsprachigkeit...

Moderiert von user profile iconmatze: Link korrigiert.
ralph
ontopic starontopic starontopic starontopic starontopic starontopic starontopic starhalf ontopic star
Beiträge: 57

openSUSE 10.3 mit Crossover Linux 6.2
Delphi 3 Pro, Freereport 2.32
BeitragVerfasst: Sa 17.06.06 06:00 
Titel: Helpmaker
Hallo,

ich habe bei meinem RG Base Projekt (Datenbank) ertmalig Helpmaker eingesetzt. Helpmaker war früher kommerziell und ist nun Freeware. Bin damit sehr zufrieden. Übersichtlich, es fehlt nichts. Er kann unter
www.vizacc.com/gen_download.php heruntergeladen werden. Also meine Empfehlung ist Helpmaker.

Ralli
Holgerwa
ontopic starontopic starontopic starontopic starontopic starontopic starofftopic starofftopic star
Beiträge: 325

WIN XP Pro, Vista Business
Delphi 7 Pro, BDS 2006 Pro
BeitragVerfasst: Sa 17.06.06 08:23 
Hallo,

ich verwende HelpScribble von JGSoft. Das kann alles was man benötigt, ist relativ preiswert und einfach zu bedienen (man will ja nicht "nur" für die Dokumentation stundenlange Einarbeitungszeiten).
www.helpscribble.com/

Holger
nullplan001
ontopic starontopic starontopic starontopic starontopic starhalf ontopic starofftopic starofftopic star
Beiträge: 212

Win 2000 Professional, Debian Linux 4.0 (Etch,Stable)
Pascal (FreePascal 2.0.2, TurboPascal 7.0), C(++) (G++/GCC 3.4.2 + MinGW), Java (JDK 1.5.0_07), PHP (PHP 5.1.4)
BeitragVerfasst: Sa 17.06.06 09:19 
Hi,

ich verwende die gute alte .txt-Datei. Für den Bildschirm reicht ja PlainText. Und für's Handbuch das ganze noch mit tex etwas aufpeppen und ans Druckwerk geben. Tadaa! Fertig sind Help & Manual. Ich überlege aber, ob ich die Hilfen nicht besser mit HTML schreibe und dann per Subcompiler das ganze nach Tex zu übertragen. Den Subcompiler müsste ich allerdings erst noch schreiben... (Subcompiler deshalb, weil der ja nur für den Tex-Compiler die Vorarbeit macht)
Naja,
tschö,
nullplan

_________________
Ich fahr' nicht selber, weil ich festgestellt habe: ich fahre zu emotional. Bin 180 gefahren wo 30 erlaubt war... -- Jürgen von der Lippe