WinHelp, WebHelp, HTML Help

OnlineForum ´99
WinHelp, WebHelp, HTML Help
Referent
Martin Moselage
Technischer Redakteur
Tanner Dokuments Reutlingen
WinHelp, WebHelp, HTML Help
1
OnlineForum ´99
Inhalt
Hilfesysteme unter Windows
Vom Dokument zur HTML Help
Übersicht Online-Hilfen
Vorbereitende Maßnahmen
Unterschiede WinHelp - HTML Help
Dokument konvertieren
Online-Hilfe-Editoren/HTMLKonverter
HTML Help erzeugen
Ergebnis
Vergleich der einzelnen Online-Hilfen
Verbindung
Anwenderprogramm - Online-Hilfe
WinHelp, WebHelp, HTML Help
2
OnlineForum ´99
Übersicht über verschiedene Hilfesysteme
Hilfe frei programmierbar mit
• Visual Basic
•
•
•
•
C++
Visual C++
Tool Book
usw.
WinHelp, WebHelp, HTML Help
Hilfesysteme (WinHelp) für
• Windows 3.xx
• Windows 95/98/NT
Hilfesysteme, die einen Browser
benötigen
• HTML Help
• WebHelp
3
OnlineForum ´99
Online-Hilfe, programmiert mit Visual Basic
WinHelp, WebHelp, HTML Help
4
OnlineForum ´99
Online Hilfe unter Windows 3.xx
WinHelp, WebHelp, HTML Help
5
OnlineForum ´99
Online-Hilfe unter Windows 95/98/NT
WinHelp, WebHelp, HTML Help
6
OnlineForum ´99
HTML Help
WinHelp, WebHelp, HTML Help
7
OnlineForum ´99
Unterschiede WinHelp - HTML Help
Compiler
WinHelp
HTML Help
HCP.EXE/HCW.EXE
(Help Workshop)
HHC.EXE
(HTML Help Workshop)
Compilerformat RTF
Rich Text Format
Datei-Endung
*.hlp
HTML
Hyper Text Mark-up
Language
*.chm
Anzeige
Winhelp.exe bzw.
Winhlp32.exe
Internet Explorer 4.0
(hh.exe)
WinHelp, WebHelp, HTML Help
8
OnlineForum ´99
Online-Hilfe-Editoren/HTML-Konverter
RTF-Editoren
HTML-Konverter
Basierend auf Winword
Webworks Publisher
Balise
Omnimark
• DocToHelp
• RoboHelp
Mit eigenem Text-Editor
• ForeHelp
• Help Magician
WinHelp, WebHelp, HTML Help
9
OnlineForum ´99
Vergleich der einzelnen Online-Hilfen
3.xx
Hierarchisches Inhaltsverzeichnis
Gleichzeitiges Anzeigen von
Inhaltsverzeichnis und Hilfethema
Synchronisiertes Inhaltsverzeichnis
Schlüsselwort-/Volltextsuche
Tabellenränder
Assoziative Verknüpfungen
Informationstypen
Kontextsensitiv
Popup-Fenster
Benutzerdefinierte Schaltflächen
Mehrere Fenster
WinHelp, WebHelp, HTML Help
Win 95/98/NT
HTML Help
nein
nein
ja
nein
ja
ja
nein
nein
ja
nein
ja
ja
nein
nein
ja
nein
ja
ja
nein
nein
ja
ja
ja
ja
ja
ja
ja
Ja
ja
ja
ja
ja
ja
10
OnlineForum ´99
Gegenüberstellung der Inhaltsverzeichnisse
Win 95/98/NT
HTML Help
Win 3.xx
WinHelp, WebHelp, HTML Help
11
OnlineForum ´99
Verbindung Anwenderprogramm und Online-Hilfe
Die Online-Hilfen können aufgerufen werden:
durch Anklicken von Menüeinträgen
durch Drücken der Funktionstaste F1
(kontextsensitiv)
durch Klicken auf Hilfe-Knöpfe
(kontextsensitiv)
kontextsensitive Hilfe
(What‘s This Help)
WinHelp, WebHelp, HTML Help
12
OnlineForum ´99
Aufruf der Online-Hilfe über einen Menüeintrag
Beispiele für den Aufruf einer HTML Help
Visual C++
Visual Basic
HtmlHelp(AfxGetMainWnd() Call HtmlHelp(Me.hWnd,_
->GetSafeHwnd(),
”Myhelp.chm”,_
”Myhelp.chm”,
HH_DISPLAY_TOPIC, ByVal 0&)
HH_DISPLAY_TOPIC, 0)
HtmlHelp
AfxGetMainWnd()
->GetSafeHwnd()
Myhelp.chm
HH_DISPLAY_TOPIC
0
WinHelp, WebHelp, HTML Help
Funktionsaufruf
Handle (Zeiger) auf Anwendungsfenster
Aufzurufende Hilfe-Datei
Auszuführende Aktion (API-Befehl)
Zusätzliche Daten zum API-Befehl
13
OnlineForum ´99
Aufruf einer beliebigen Hilfetafel (kontextsensitiv)
Beispielcode für C++
HtmlHelp(AfxGetMainWnd()->GetSafeHwnd(),
”Myhelp.chm”, HH_DISPLAY_CONTEXT, HIDD_TopicAdress)
HH_DISPLAY_CONTEXT
HIDD_TopicAddress
WinHelp, WebHelp, HTML Help
API-Befehl
Objektadresse/Adresse der Hilfetafel
14
OnlineForum ´99
Vom FrameMaker-Dokument zur Online-Hilfe
Projektablauf
Dokumentation erstellen
mit FrameMaker
HTML-Dateien erzeugen
GIF-Bilder erzeugen
HTML Help erzeugen
mit Webworks Publisher
mit Paint Shop Pro
mit HTML Help Workshop
WinHelp, WebHelp, HTML Help
15
OnlineForum ´99
Vorbereitende Maßnahmen
FrameMaker
• Inhalts- und Stichwortverzeichnis (Buch) generieren
• Conditional Text für Online-Hilfe setzen
Webworks Publisher
• FrameMaker-Buch aufnehmen
• Zielverzeichnisse anlegen
• Einstellungen für HTML Help Workshop aufnehmen
(Titel, Fenstergröße und -aussehen, usw.)
• HTML-Formate (Styles) erstellen
• Zuordnen der FrameMaker-Formate zu den HTML-Formaten (Mappen)
WinHelp, WebHelp, HTML Help
16
OnlineForum ´99
HTML-Formate (Styles) erstellen
WinHelp, WebHelp, HTML Help
17
OnlineForum ´99
Zuordnen der Formate (Mappen)
WinHelp, WebHelp, HTML Help
18
OnlineForum ´99
Konvertierung des FrameMaker-Dokuments
Bei der Konvertierung werden folgende Dateien erzeugt:
mehrere HTML-Dateien
*.htm
eine Projekt-Datei
eine Inhaltsverzeichnis-Datei
eine Indexverzeichnis-Datei
*.hhp
*.hhc
*.hhk
WinHelp, WebHelp, HTML Help
19
OnlineForum ´99
Online-Hilfe mit HTML Help Workshop erzeugen
WinHelp, WebHelp, HTML Help
20
OnlineForum ´99
Ergebnis der Kompilierung
WinHelp, WebHelp, HTML Help
21