Vor dem Erstellen von HTML Help zu beachten

Bevor eine CHM Datei erstellt wird sollten einige grundlegende Punkte beachtet werden. Hierdurch vermindert sich die Gefahr, dass Fehler beim Kompilieren der Hilfe oder später bei der Ausführung der Hilfe auftreten.

Zu beachten beim Erstellen einer HTML Help Hilfe:  

  • Keine Dateien in Verzeichnissen verwenden, die sich oberhalb des Projektverzeichnisses befinden oder auf derartige Dateien einen Link setzen
  • Zur Bezeichnung jeglicher Dateien die kompiliert werden, sollten nur folgende Zeichen Verwendung finden: a....z, A....Z, 0....9. In keinem Fall darf das # - Zeichen im Dateinamen enthalten sein.
  • Innerhalb des Dateinamens keine Punkte verwenden, z.B. bild.htm.gif
  • Innerhalb des Dateinamens keine Leerzeichen verwenden, besser mit Unterstrichen arbeiten, z.B.: "erste_datei.htm" anstatt "erste datei.htm"
  • Ausschließlich relative Pfadangaben verwenden
  • Bei den <title> Tags in den HTML Dateien niemals gleiche Einträge in mehreren Dateien verwenden, wenn die Funktion "auto sync" eingestellt ist.
  • Bei der Erstellung mit Frontpage darauf achten, dass keine _vti Ordner mitkompiliert werden.
  • Vor dem erneuten Kompilieren eine eventuell aktuelle Hilfedatei die noch geöffnet ist schließen. Ansonsten kann der Compiler die neue Hilfe nicht erstellen
  • Die Heading Tags der HTML Dateien dürfen keine Parameter enthalten, z.B.: <h1 align="center" >Überschrift</h1>
  • Bilddateien, Javascriptdateien und externe CSS Dateien müssen dem [FILES] Abschnitt der Projektdatei hinzugefügt werde. Näheres dazu siehe in den FAQ
  • Vor der Aktivierung eines binären Inhalts (binary TOC) sollten folgende Aspekte berücksichtigt werden:
    - Im Inhalt können nur die Buchsymbole und Seitenicons verwendet werden
    - Eigene Icons für den Inhalt werden nicht unterstützt
    - Die Verwendung von Informationstypen wird nicht unterstützt
    - Einträge im Inhalt können nicht angewiesen werden, das aufzurufende Thema in einem bestimmten Fenstertyp oder Frame zu öffnen
    - Das Aussehen von definierten Fenstern kann nicht verändert werden
    - Binäre TOC's können nicht in miteinander verbunden (merged) CHM's verwendet werden.