Index anlegen

HTMLHelp bietet verschiedene Möglichkeit an, um einen Index zu erstellen. Die nachfolgenden Abschnitte erläutern die Möglichkeiten.
Wenn Sie bereits Schlüsselworte im <meta> Abschnitt der HTML Dateien mit ihrem HTML-Editor eingetragen haben ist die Benutzung des Programm KIT besonders zu empfehlen.

Index manuell erstellen

Die Schlüsselwörter werden den Themen mit dem Microsoft HTMLHelp Workshop manuell zugewiesen. Erstellen Sie eine neue Indexdatei z.B. index.hhk auf der Ebene ihres Projektes, wenn Sie hier mit einem Klick auf die Index Registerkarte beginnen.

 

Um eine Basis- (oder erste Ebene) Schlüsselwort zu einem lokalen Thema zu erstellen
1. Klicken Sie "Insert a Keyword". Die Indexeintrag-Dialogbox erscheint.
2. Geben Sie das Schlüsselwort in die Schlüsselwort-Eingabebox ein.
3. Klicken Sie "Add". Die Pfad- oder URL-Dialogbox erscheint.
4. Wählen Sie das Thema aus der Liste von Dateien und klicken Sie OK.
5. Klicken Sie OK.

 

 

Um ein sekundäres (oder mehrstufiges) Schlüsselwort zu einem lokalen Thema zu erstellen
1. Führen Sie Stufen 1 bis 5 von oben aus. Wenn die Nachricht "Do you want to insert this entry at the beginning of the index?" erscheint, klicken Sie "No".
2. Das Schlüsselwort erscheint auf der Indexregisterkarte hervorgehoben. Verwenden Sie die Aufwärts-und Abwärtspfeile, um das Schlüsselwort unter seinem Hauptschlüsselwort anzuordnen, und verwenden Sie dann den Pfeil "rechts" um einzurücken.


 

Dies ist eine Qual - benutzen Sie besser KIT dafür!

 

Index mit eingebettenen Schlüsselworten erstellen

Microsoft HTMLHelp Workshop kann Schlüsselworte auch als Objekt-Tag im HTML Quelltext einbetten. 

..
<object type="application/x-oleobject"
       classid="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
		<param name="Keyword" value="HTMLHelp">
		<param name="Keyword" value="Index">
		<param name="Keyword" value="Workshop">
</object>
..

Diese Schlüsselworte werden vom Compiler aus dem HTML-Quelltext herausgezogen. Man kann dies als Trick zum Schutz eines aufwändigen Index nutzen, da die Schlüsselworte bei einem Decompilieren nur noch im Index und nicht mehr im HTML Quelltext vorhanden sind. Sie müssen in den Projekteigenschaften "Include keywords from HTML Editor" auf der Registerkarte "Files" aktivieren.

Jedoch verursachen Kommas im "value" Attribut einen neuen Index Sub-level, wenn die Datei kompiliert wird.

Um Kommas in den Schlüsselwörtern des Index aufzunehmen ohne das diese als neuer Sub-level interpretiert werden , kann man den HTML Sonderzeichencode für Komma (&#44) im Schlüsselwortbegriff einschließen. Du mußt ein Leerzeichen nach dem Sonderzeichencode eingeben.

Beispiel:

..
<object type="application/x-oleobject"
       classid="clsid:1e2a7bd0-dab9-11d0-b93a-00c04fc99f9e">
		<param name="Keyword" value="fruits&#44; southern">
		<param name="Keyword" value="fruits&#44; southern,grapes">
		<param name="Keyword" value="fruits&#44; southern,orange">
     <param name="Keyword" value="fruits&#44; southern,pineapple">
</object>
..

Index mit einer undokumentierten Funktion erstellen

In einem HTMLHelp Projekt können Schlüsselwörter für den Index als Meta Statement im Abschnitt <head>  mit Hilfe einer undokumentierten Funktion integrieren werden. Die so angegeben Schlüsselworte werden bei einem kompilierten Hilfesystem in den Index eingebunden. Interessant ist auch die problemlose Übernahme nach MS Help 2.0.

Die Verbindung von thematischem Inhalt und Verschlagwortung kann hier unmittelbar hergestellt werden, wenn der Text erarbeitet wird. Eine Verschlagwortung bereitet im Nachgang oft viel Arbeit und wird deshalb vernachlässigt.

Beachten Sie, dass in einem nicht kompilierten (uncompressed) Hilfesystem keine Anzeige dieser Schüsselworte erfolgt!

<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<link rel="stylesheet" type="text/css" href="../design.css">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<meta name="keywords" content="Hilfefenster, Browser, Inhalt, Index">
<meta name="MS-HKWD" content="Browser">
<meta name="MS-HKWD" content="Inhalt">
<meta name="MS-HKWD" content="Index">
<meta name="ProgId" content="FrontPage.Editor.Document">
<title>Hilfefenster Browser</title>
</head>

Für mehrstufige Schlüsselwörter trennen sie mit Komma.

<META NAME="MS-HKWD" CONTENT="Browser, Optionen">

Wenn Sie ein Schlüsselwort "xxx, yyy" definieren, dann müssen Sie auch ein Schlüsselwort "xxx" irgendwo definieren, sonst könnte ein unerwartetes Ergebnis entstehen.

A-Schlüsselworte (ALinks) werden ebenso definiert, aber der Name ist "MS-HAID".

Hinweis: Der Vorteil dieser Schlüsselwortzeichen ist, dass diese während des Kompilierens nicht aus dem HTML Dokument entfernt werden.

Help 2.0 Index aus HTMLHelp konvertieren

Wenn Sie den HH 1.x -> H2 Konverter (Version: 2.1.2067.0) benutzen, werden die Tags mit den Schlüsselworten nach Help 2 gewandelt und als XML "data islands" in den umgebenden HTML-Code eingefügt. Dies funktioniert genauso für Compiled Help Module (CHM) wie auch für die entsprechende Projektdatei (HHP) Datei. 

<head>
<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
<link rel="stylesheet" type="text/css" href="../design.css">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<meta name="keywords" content="Hilfefenster, Browser, Inhalt, Index">
<meta name="ProgId" content="FrontPage.Editor.Document">
<title>Hilfefenster Browser</title>
<xml>
<MSHelp:Keyword index="K" term="Browser"/>
<MSHelp:Keyword index="K" term="Inhalt"/>
<MSHelp:Keyword index="K" term="Index"/>
</xml>
<LINK REL="stylesheet" TYPE="text/css" HREF="ms-help://Hx/HxRuntime/HxLink.css">
<LINK REL="stylesheet" TYPE="text/css" HREF="ms-help://Hx/HxRuntime/HxLinkDefault.css">
</head>


Top ...