HTML-Help-Projekt erstellen

Allgemeines ,
Seiten / Projekt erstellen lassen , Seiten einbinden ,
Projektdatei erstellen , Contentsfile erstellen ,
HTML-Seiten erstellen , Index erstellen ,
Compilieren , Testen

vorige Seite

nächste Seite

 

Nach oben   Allgemeines:

   

      Um eine Hilfedatei zu erhalten, müssen Sie diese erstellen lassen. Hierzu müssen je nach gewünschter Funktion außer den HTML-Seiten noch verschiedene andere Dateien erstellt werden. Diese werden letztendlich vom Helpcompiler in eine einzelne Hilfedatei vereint.
      Auch zur Erstellung dieser weiteren Dateien benötigen Sie mit HTML-Help Projects keine besonderen Kenntnisse.

      Die folgenden Hintergrundinformationen reichen für die meisten Hilfeprojekte aus:
      Das
      Hilfefenster besteht aus zwei Teilen, in der rechten Hälfte finden Sie die HTML-Seiten. In der linken Hälfte die Navigationshilfe, bestehend aus einem oder mehreren der folgenden Funktionsmöglichkeiten.

      HTMLHelpSite

      Funktion

      Bedeutung

      Wird angezeigt wenn

      Contents

      Inhaltsverzeichnis zum direkten Navigieren zu bestimmten Seiten.
      (in obigem Bild nicht vorhanden)

      Index

      Stichwortliste zum auffinden von Seiten anhand von Ihnen angegebener Stichwörter.

      Suchen

      Volltextsuche über alle Seiten hinweg durch Eingabe eines Suchbegriffs.

      In Fenstereinstellung aktiv.
      Hierbei kann der Wortindex
      schon beim compilieren erstellt werden. Ansonsten muß der Benutzer diesen selbst erstellen.

      Favoriten

      Benutzer kann Textstellen zu Favoriten hinzufügen und leicht wieder auffinden.

      In den Fenstereinstellungen wird außerdem angegeben, welche Buttons angezeigt werden sollen, wie groß das Hilfefenster beim öffnen sein soll etc.

      Das ganze Projekt oder Teile davon können Sie über die Hilfe-Projektvorschau CreateHelpProj im Projektnavigator erstellen lassen. Hierbei werden Sie Schritt für Schritt an Ihre Hilfe herangeführt.
      Sie können jederzeit einen oder mehrere Schritte vor oder zurückgehen, Änderungen vornehmen und die entsprechende Datei jeweils durch Knopfdruck erstellen lassen.
      Über F1 erhalten Sie zu jedem Schritt bei Bedarf eine entsprechende Hilfe.
      Am Ende wird Ihre
      Hilfedatei compiliert und automatisch aufgerufen.
      Direkt in HTML-
      Help-Projects können Sie die erstellte Hilfe daraufhin bei Bedarf testen.

Nach oben   Seiten / Projekt erstellen lassen:

   

    Bei aktiviertem Projektnavigator kann nach Anwahl von CreateHelpProj das komplette Projekt oder auch nur Teile davon erstellt werden.
    HTML-Help Projects verwaltet innerhalb des aktuellen Projektes beliebig viele Einstellungen zum erstellen von
    Hilfedateien aus Seiten Ihres Projekts.
    Somit ist es Ihnen bei Bedarf möglich, verschiedene Versionen von
    Hilfedateien mit unterschiedlichen Seitenzusammenstellungen zu erzeugen.

    Projekterstellung:
    Wählen Sie entweder aus der Liste einen Namen aus, oder geben Sie einen neuen Namen für Ihre Projekterstellung ein.
    Bitte beachten Sie hierbei, dass Ihre
    Hilfedatei diesen Namen erhält, Sie können diese nach der Erstellung jedoch beliebig umbenennen.

html-help

html-helpeinst

    Hinweis Ein neuer Name erscheint erst in der Liste, nachdem tatsächlich Seiten erstellt wurden.

    Erstelle Info-Seite:
    Wählen Sie an, ob eine Infoseite erstellt werden soll. Diese kennen Sie bereits vom erstellen einzelner Seiten aus dem Editor heraus. Hier erhalten Sie jedoch eine Gesamtübersicht über alle erstellten Seiten.

    HTML-Help:
    Wählen Sie diese Funktion und "Compilierte Hilfe" an.


Wählen Sie "Weiter"

Nach oben   Seiten einbinden / Inhaltsverzeichnis definieren:

   

    Sie erhalten eine Liste, in der genau wie im Projektnavigator alle Gruppen und Seiten eingetragen sind. Mit Hilfe dieser Liste bestimmen Sie, welche Seiten compiliert werden sollen, außerdem stellt diese Liste auch das spätere Inhaltsverzeichnis der HTML-Hilfe dar.

    Sie können hier wie gewohnt Gruppen aufklappen.
    Außerdem können Sie Gruppen verschieben und Seiten z.B in eine andere Gruppe ziehen.
    Sie Können eine Gruppe auch in eine andere hineinschieben und so eine ganz individuelle Gliederung des Inhaltsverzeichnisses erreichen..

    Über die rechte Maustaste können außerdem die Bezeichnungen geändert werden.
    Auch zusätzliche Gruppen können Sie über die rechte
    Maustaste anlegen.
    Für
    Profiuser, die mehrere Hilfedateien zusammenführen möchten kann über die rechte Maustaste eine Scriptfunktion eingefügt werden, die z.B eine Include Anweisung enthält.

html-liste

    Nicht Einbinden:
    Wenn Sie eine Gruppe oder eine Seite angewählt haben, können Sie diese über F5 vom compilieren auss
    chließen.

    Alle Seiten erstellen:
    Wenn Sie diesen Punkt anwählen, werden alle Seiten der Liste erstellt, unabängig davon, ob diese auf "Nicht Einbinden" gestellt sind oder nicht.

    In nebenstehender Abbildung sind z.B alle Seiten in der Gruppe Standard, Poppig und Winhelp über F5 vom erstellen ausgeschlossen worden. Außerdem die Seite "Neue Seiteb" in der Gruppe "Modern" .

    Alle anderen Seiten werden erstellt.
    Sollten in den Seiten, die erstellt werden Verweise zu den ausgeschlossenen Seiten definiert sein, dann werden diese Verweise nicht erstellt und Sie erhalten einen Warnhinweis.

    TipSie erstellen und verwalten mehrere Hilfedateien?
    Dann wäre es denkbar, jeweils ähnliche in ein und dem selben Projekt anzulegen. Sie erstellen also im Projektnavigator lediglich eine Gruppe für ein neues Projekt.
    Für jede
    Hilfedatei legen Sie dann eine Projekterstellung an, in der Sie die jeweils anderen Gruppen einfach ausschließen.

html-listeb

In den meisten Fällen werden Sie keine Seiten vom Erstellen ausschließen.
Unter Umständen erstellen Sie jedoch verschiedene Hilfedateien aus einem Projekt heraus, dann wird Ihnen diese Funktion sehr nützlich sein. Außerdem haben Sie bei sehr großen Projekten so die Möglichkeit nur die Kapitel und Seiten zu compilieren, die Sie gerade testen wollen.

    Standard Anzeigefenster:
    Ein
    Hilfeprojekt benötigt zum compilieren eine Fenstereinstellung in der die Hilfeseiten standardmäßig angezeigt werden sollen. Ziehen Sie also aus dem Projektnavigator aus der Liste Fenster eine Fenstereinstellung in dieses Feld. Achten Sie darauf, dass in dieser Fenstereinstellung auch die Angaben für die HTML-Hilfe gemacht wurden. Sie definieren hier also Fensterhintergrundfarbe, Verweisfarbe, die Buttons etc.

html-listefenster

    Nicht im Inhaltsverzeichnis:
    Sie können nun für jede Gruppe und auch für jede Seite wählen,
    ob diese überhaupt im Inhaltsverzeichnis der erstellten Hilfedatei erscheinen soll. Wählen Sie Hierzu die entsprechenden Gruppen und Seiten einzeln an und wählen Sie diese Option.

html-nichtinh

    Für jede Seite können Sie eine ID und ein Anzeigefenster angeben.
    Wählen Sie hierzu eine Seite in der Liste an.
    ID der Seite:
    HTML-Help-Projects hat bereits den Namen der Seite als ID eingetragen.
    Sie können diese hier bei Bedarf ändern. Anhand dieser
    Id ist es Ihnen später möglich die Seite direkt aus einer Anwendung heraus aufzurufen.

    Anzeige in Fenster:
    Soll die Seite nicht in dem vorher definierten Standardanzeigefenster angezeigt werden, dann ziehen Sie aus dem Projektnavigator ein Anzeigefenster für diese Seite in dieses Feld.

    Hilfedatei:
    Dieses Feld benötigen Sie nur, wenn sich diese Seite gar nicht in der aktuellen Hilfedatei befindet. Geben Sie in diesem Fall hier den Namen der Hilfedatei ein, in welcher sich die Seite befindet z.B hilfe2.chm.


html-listeseite
HTML-
Help-Projects erstellt automatische ID's und Aliasnamen mit Kontextnummern für jede Seite. Die ID können Sie hier bei Bedarf ändern.

Auszug aus der erstellten Projektdatei.
[ALIAS]
IDH_Index=Index.htm

[MAP]
#define IDH_Index   1040

Die Seite kann (auch abhängig von der verwendeten Programmiersprache) nach belieben über
Index.htm
IDH_Index oder
1040

aufgerufen werden

    Images definieren:
    Solange diese Option angewählt ist, kann für jede Gruppe und jede Seite über F5 das Anzeigeicon für das Inhaltsverzeichnis geändert werden.
    Über F8 kann die Markierung "Neu"
    ein und ausgeschalten werden.

    HinweisWenn Sie Images definieren wieder abwählen, werden die ursprünglichen Buch und Seitenicons angezeigt. Ihre definierten Icons werden beim erstellen jedoch berücksichtigt.

html-images

html-imagesei
Liste mit geänderten
Anzeigeicons.
Die Seite "Neue Seite" wurde über F8 als neu markiert.


Wählen Sie "Weiter"
(Images definieren muß abgewählt sein)

Nach oben Grafiken überschreiben:

   


    Vorhandene Grafikdateien überschreiben:
    Nicht angewählt (Vorwahl):
    Beim späteren erstellen der Seiten erfolgt vor überschreiben von bereits vorhandenen Grafikdateien und sonstigen Files, die Sie über die Liste Objekte hinzugefügt haben eine Abfrage.

    TipIn den meisten Fällen müssen Sie die Dateien nicht erneut ins Zielverzeichnis kopieren lassen.
    Wenn IntelliSaveFile
    aktiviert ist, werden nur Dateien kopiert, die entweder neu sind, oder die tatsächlich Änderungen aufweisen.
    Sie werden in diesem Fall die D
    ateien also Vermutlich immer ins Zielverzeichnis kopieren lassen.  

    Angewählt:
    Es erfolgt später keine Abfrage vor dem Überschreiben.

e-html3
Sie erhalten folgenden Dialog.

e-html-grafexist

Sie können wählen, ob nur die aktuelle Datei überschrieben werden soll, alle weiteren auch, oder auch keine. Im Normalfall werden Sie die Dateien überschreiben lassen.

    HinweisHTML-Help Projects kopiert alle benötigten Dateien für Ihr HTML-Hilfe Projekt in das Zielverzeichnis.

Wählen Sie "Weiter"

Nach oben Projektdatei erstellen:

   


    Projektdatei erstellen:
    In diesem Schritt wird die HHP Projektdatei für den Helpcompiler erstellt.
    Betätigen Sie hierzu "
    Projektdatei erstellen"
    HTML-
    Help-Projects fügt automatisch alle nötigen Informationen zur Projektdatei hinzu.
    Vor dem ersten erstellen müssen Sie lediglich die weiter unten unter
    "Einstellungen zur Projektdatei"
    Beschriebenen Einstellungen vornehmen.

    Projektdatei anzeigen:
    Öffnet die erstellte Projektdatei in Ihrem Texteditor. Sie können sich hier bei Bedarf Kontextnummern, Aliasnamen und sonstige Informationen zum aufrufen aus Ihrer Anwendung entnehmen.
    Wenn Sie direkt zu einem Anker auf einer Seite verweisen wollen, benötigen Sie noch den
    Ankernamen, den Sie erhalten, wenn Sie diesen auf der entsprechenden Seite anklicken.

    Nur geänderte ..:
    Speichert die Projektdatei immer nur dann, wenn auch tatsächlich Änderungen stattgefunden haben. (IntelliSaveFile)

htmlproja
Sie erhalten folgenden Dialog.

    Popup Texte..Whats This Hilfe:
    Wenn Sie zusätzlich eine Whats-This-Hilfe für ihre Anwendung planen, können Sie über diesen Button die Texte hierzu editieren. HTML-Help-Projects erzeugt automatisch die zugehörige C-Konforme Kennung in der Projektdatei.
    Beim ersten öffnen sind bereits 5
    Popups definiert, die Ihnen lediglich das Format nahebringen sollen, Sie können diese Einträge also Überschreiben, halten Sie sich aber an das folgende Format.

      .topic 20000
      Dies ist ein Popup Text, der auch über Whats-This-Help aufgerufen werden kann.
      .topic 20010
      Allen .topic IDs die Sie hier anfügen wird beim erstellen der Projektdatei automatisch eine C-Konforme Kennung IDH_POPUP_xxx vergeben.
      .topic 20020
      Editieren Sie diese Texte mit einem beliebigen Editor. Diese Datei wird nicht von HTML-Help Projects überschrieben.
      .topic 20030
      Die Ids werden jedoch eingelesen und in der Projektdatei C-Konform gemappt
      .topic 20040
      Allgemein werden für Popups ID`s ab 20000 verwendet. Bitte halten Sie sich wenn möglich daran.

    Einstellungen zur Projektdatei:
    Die folgenden Einstellungen sollten Sie auf jeden Fall vornehmen.
    Titel:
    Den Titel Ihrer Hilfedatei. Dieser erscheint als Fenstertitel.
    Seite die beim..:
    Ziehen Sie die Seite aus dem Projektnavigator in dieses Feld, die Standardmäßig beim öffnen der Hilfedatei angezeigt werden soll, sofern keine spezielle Seite angegeben wird.
    Language:
    Wählen Sie aus der Auswahlliste bei Bedarf
    eine Sprache aus. Wenn Sie
    "
    Language Neutral" (empfohlen) wählen wird der aktuelle Zeichensatz des Benutzers verwendet.
    Schrift für Navigationsfenster:
    Wählen Sie hier optional eine andere Schrift für das Navigationsfenster.
    Ansonsten lassen Sie dieses Feld frei (empfohlen).

htmlprojektaa

    Compiler Optionen:
    Kompatibilität:
    Wir verwenden den neuesten Compiler, deshalb hier V1.1 und später wählen.
    Natürlich können Sie sich auch einen älteren Compiler installieren, wählen Sie dann V1.0.
    Wir weisen aber darauf hin, dass ältere Compiler nicht alle Funktionen unterstützen und häufiger
    abstürzen.


html

    Alle weiteren Optionen sollten Sie nur mit entsprechenden Kenntnissen anwenden.
    Keine Verzeichnisse:
    Alle Seiten Grafiken etc. werden ohne Verzeichnisstruktur compiliert.
    Dies kann zu Problemen führen, wenn Sie gleichnamige Files in verschiedenen Quellverzeichnissen hatten.
    Kann aber
    z.B bei nicht funktionierenden Java Class Funktionen hilfreich sein.

    Kompiliere Volltextsuche:
    Dies kann der Benutzer auch nachträglich noch durchführen. Wenn Sie diese Option anwählen wird Ihre Hilfedatei größer und der Compiliervorgang dauert länger.

    Erstelle Binären Index:
    Nur bei großen Hilfesystemen empfohlen.
    Jedoch zwingend notwendig, wenn Sie später Hilfedateien zusammenführen wollen. Also eine übergeordnete Hilfe haben, die mehrere externe Hilfen in sich vereinen soll.

    Erstelle Binären TOC (Inhaltsverz.):
    Nur bei großen Hilfesystemen empfohlen.
    Jedoch zwingend notwendig, wenn Sie später Hilfedateien zusammenführen wollen. Also eine übergeordnete Hilfe haben, die mehrere externe Hilfen in sich vereinen soll.
    Achtung!
    wenn Sie einen binären TOC erstellen lassen, bleiben die weiter unten Beschriebenen Einstellungen zum gestalten individueller Inhaltsverzeichnisse ohne Wirkung.

    Merge Files:
    HTML-Help-Projects trägt in der Projektdatei unter [FILES] alle benötigten Dateien automatisch ein, sofern diese eingetragen werden müssen. Sollten Sie weitere Dateien in die Hilfe hineincompilieren wollen, dann tragen Sie diese hier ein.
    Achtung! Diese Dateien müssen Sie von Hand in das gleiche Verzeichnis hineinkopieren, in welchem sich auch die
    Projektdatei befindet.

    Map-Section:
    HTML-Help-Projects erstellt die Map-Section in folgendem Format automatisch.

      [ALIAS]
      IDH_Index=Index.htm
      [MAP]
      #define IDH_Index   1040

    Sie können also um ein Thema aus einer Anwendung aufzurufen, die Kontextnummer, den Alias Namen oder direkt den Filenamen der Seite verwenden. (Je nachverwendeter Programmiersprache)
    Sollten Sie ein anderes bzw. weiteres Format verwenden wollen, oder
    z.B eine bestimmte Seite über eine weitere Kennung erreichen wollen, dann können Sie in dieser Liste beliebig viele Einträge vornehmen.

    Makros:
    Makros die beim starten aufgerufen werden gibt es in HTML-Help im Gegensatz zu Winhelp nicht.
    Die
    Makrofunktion wurde hier beibehalten um auch bei HTML-Help über Scripts einfluss auf die Projektdatei nehmen zu können.
    So ist es Ihnen bei bedarf möglich, ein oder mehrere Scripts zu definieren,
    welche Einträge in folgende Sektionen der Projektdatei vornehmen.
    [OPTIONS] , [FILES] , [Config] .
    Da es sich hierbei um eine HTML-
    Help-Projects spezifische Rückwärtskompatibilität zu WinHelp handelt, müssen die Einträge im Scripteditor auch unter Hilfe-Makro und nicht unter HTML-Script vorgenommen werden.
    Hierbei wird der Text vom Feld Makro in den [OPTIONS] Bereich eingetragen.
    Der Text vom Feld "Eventuelle
    Init.." in den [Config] Bereich.
    Der Text vom Feld "Benötigte Dateien Baggage"
    in den [Files] Bereich.

Wählen Sie "Weiter"

Nach oben Contentsfile erstellen:

   

    Contentsdatei erstellen:
    (Inhaltsverzeichnis)

    In diesem Schritt wird die HHC Contentsdatei für den Helpcompiler erstellt.
    Betätigen Sie hierzu "
    Contentsfile erstellen"
    HTML-
    Help-Projects erstellt anhand der bereits im ersten Schritt erstellten Liste das Inhaltsverzeichnis für Ihre Hilfedatei.
    Sie müssen hierzu keine weiteren Einstellungen vornehmen.

    Contentsfile im Editor anzeigen:
    Öffnet die erstellte Contentsdatei in Ihrem Texteditor. Bei Bedarf für erfahrene Benutzer um eventuell weitere Verweise direkt einzutragen.

    Contentsfile im Workshop bearbeiten:
    Öffnet die erstellte Contentsdatei im Help-Workshop (sofern dieser installiert ist). Ebenfalls bei Bedarf für erfahrene Benutzer um eventuell weitere Einstellungen vorzunehmen.

helpprojcontents
Sie erhalten folgenden Dialog.

    Nur geänderte ..:
    Speichert die Contentsdatei immer nur dann, wenn auch tatsächlich Änderungen stattgefunden haben. (IntelliSaveFile)

    Contentsfile Einstellungen:
    Sie können hier dem Inhaltsverzeichnis ein völlig individuelles Erscheinungsbild geben.
    Bitte beachten Sie jedoch, dass diese Einstellungen nur dann wirksam sind, wenn Sie keinen "Binären TOC" erstellen lassen.
    Manche Einstellungen führen eventuell zu unschönen grafischen Effekten. Wenn Sie diese Funktionen nutzen, dann prüfen Sie also Ihr Inhalstverzeichniss genau.

    Fenster:
    Sie können aus der Liste Fenster im
    Projektnavigator einen Eintrag in dieses Feld ziehen um die Hintergrundfarbe etc. festzulegen.

    Verzeichnis Grafiken:
    Nicht angewählt,
    dann erscheint für die Gruppen das Buch-Symbol.
    Angewählt,
    dann erscheint für die Gruppen das Folder Symbol, bzw. die Grafik, die Sie beim Images definieren angegeben haben.

helpprojcontentsopt

    Hintergrund:
    Sie können die
    Hintergrundfarbe angeben.
    (
    Doppelklick auf dieses Feld löscht diese wieder)

    Imagelist:
    Sie können eine eigen
    Imagelist angeben. Wählen Sie in diesem Fall "eigene verwenden" und ziehen Sie aus dem Projektnavigator aus der Liste Objekte die Imagelist in dieses Feld.

    HinweisHTML-Help Projects kopiert auch diese Datei für Ihr HTML-Hilfe Projekt in das Zielverzeichnis.

    Schrift:
    Sie können eine spezielle Schrift auswählen, die Größe und Farbe angeben und bei Bedarf den Code für einen speziell zu verwendenden Zeichensatz angeben.
    Standardframe:
    Sollte Ihr
    Hilfeprojekt in Frametechnik aufgebaut sein, können Sie hier das Frame angeben, in welches die Seiten Standardmäßig geladen werden sollen.

    Style:
    Mehrere Schalter um das
    Erscheinungsbild und verhalten des Inhaltsverzeichnisses zu beeinflussen.
    Die Punkte erklären sich alle alle von selbst.

    TipSie möchten in Ihrer Hilfedatei kein Inhaltsverzeichnis? dann gehen Sie wie folgt vor.
    Lassen Sie über "Contentsfile erstellen" ein Contentsfile erstellen. Öffnen Sie dieses über "Contentsfile im Editor bearbeiten" und löschen Sie dort den gesamten Text. Speichern Sie den leeren Text.

Wählen Sie "Weiter"

Nach oben HTML-Seiten erstellen:

   

    In diesem Schritt werden die HTML-Seiten für die Hilfedatei erstellt. Betätigen Sie hierzu
    "HTML-Seiten aktualisieren"
    HTML-
    Help-Projects erstellt alle Seiten, die in der bereits im ersten Schritt erstellten Liste, nicht vom Erstellen ausgeschlossen wurden. Alle benötigten Dateien werden im Zielverzeichnis bereitgestellt.
    Sie müssen hierzu keine weiteren Einstellungen vornehmen.

help-htmlsites
Sie erhalten folgenden Dialog.

    IntelliSaveFile
    Es werden immer alle gewählten Seiten erstellt, aber
    nur dann gespeichert, wenn tatsächlich Änderungen vorliegen. Dies bringt Ihnen beim erstellen einer Hilfedatei lediglich den Vorteil, dass Sie nochmals eine Rückmeldung erhalten, welche Seiten Änderungen aufweisen.

    HTML-Datei anzeigen
    Öffnet einen Dialog zum Öffnen der erstellten Seiten in einem Editor.

    HTML ab Byte Offset
    Zeigt den Inhalt
    einerHTML-Datei ab einem bestimmten Byte Offset an.
    Kann der Helpcompiler eine Seite nicht korrekt übernehmen, zeigt dieser eine Fehlermeldung mit einem Byteoffset an. Sie können in diesem Fall herausfinden, um welche Stelle auf der HTML-Seite es sich handelt, und entsprechend Änderungen vornehmen.

    HinweisSowohl "HTML-Datei anzeigen", als auch "HTML ab Byte Offset" werden Sie mit dem aktuellen Helpcompiler kaum benötigen. Die Funktionen wurden beibehalten, da diese Funktionen beim erstellen einer Win-Hilfe und dort natürlich RTF-Dateien doch ab und zu gebraucht werden.

Wählen Sie "Weiter"

Nach oben Index erstellen:

   

    In diesem Schritt wird das Indexfile erstellt. Betätigen Sie hierzu "Indexfile erstellen".
    HTML-
    Help-Projects liest die Stichwörter aller eingebundenen HTML-Seiten ein und erstellt die Verweise zu den entsprechenden Seiten.
    Nach kurzer Zeit erscheint eine Liste mit allen im Indexfile angelegten Stichwörtern.
    Sie müssen hierzu keine weiteren Einstellungen vornehmen.

help-htmlindex
Sie erhalten folgenden Dialog.

    Indexfile im Workshop bearbeiten
    Bei Bedarf können erfahrene Benutzer weitere Stichwörter über den Workshop hinzufügen. Auch Untergruppen können dort gebildet werden.

    Indexfile im Editor anzeigen
    Öffnet das
    Indexfile im Editor. Auch hier können erfahrene Benutzer bei Bedarf Einträge von Hand vornehmen.

    HinweisManuell bearbeitetet Indexfiles werden bei betätigen von "Indexfile erstellen" überschrieben.  

Wählen Sie "Weiter"

Nach oben Compilieren:

   

    In diesem Schritt wird die Hilfedatei compiliert. Alle Infos zum Compiler finden Sie hier.

    Betätigen Sie hierzu "Helpcompiler starten".
    HTML-
    Help-Projects öffnet den Helpcompiler mit der erstellten Projektdatei.
    Der Fortschritt wird in einem extra Fenster angezeigt.
    Nach kurzer Zeit wir die erstellte Hilfe automatisch geöffnet.

help-htmlcompile
Sie erhalten folgenden Dialog.

    Compiler Meldungen anzeigen
    Während dem Compilieren werden Status und Fehlermeldungen ausgegeben. Diese können auch hinterher jederzeit über diesen Button angezeigt werden.
    Warnungen sollten Sie beachten und wenn möglich die Ursache beseitigen.
    Fehler müssen Sie auf jeden Fall beseitigen.
    Solange ein F
    ehler vorliegt wird die Hilfedatei im Normalfall nicht erstellt. Korrigieren Sie also je nach Meldung die Projekteinstellungen, die HTML-Seite oder das Contentsfile. Lassen Sie die entsprechende Datei neu erstellen und compilieren Sie erneut.

    Projektverzeichnis
    Öffnet das
    Zielverzeichnis im Explorer. Sie finden dort Ihre erstellte Hilfedatei.
    D
    ie Projektdatei, das Contentsfile das Indexfile und die Textdatei mit den Popups. sind nur zum erstellen der Hilfe nötig. Sie müssen diese nicht mit ausliefern.

    Tip Im Projektverzeichnis finden Sie das Unterverzeichnis NetKlasse, welche je nach Einstellungen
    eine
    C# oder VB-Net Klasse beinhaltet, die Sie zum einfachen aufrufen der Hilfe in Ihren Quellcode einfügen können.


    HinweisHaben Sie Multimedia oder sonstige Files auf einer Seite eingefügt, und "File intern verwalten" abgewählt, dann finden Sie diese Dateien ebenfalls hier, diese sind für die Funktion der Hilfedatei nötig, und müssen mit dieser mitgeliefert werden.  

Nach oben Testen:

   

    Im Dialog Compilieren können Sie über das Menü "Erstellte Hilfe manuell testen" Ihre erstellte Hilfe auf verschiedene Arten aufrufen.

    Standardmäßig ist "Direkt" angewählt, HTML-Help-Projects öffnet in diesem Fall bei betätigen von F11 oder dem Button
    "Hilfe aufrufen" die
    Hilfedatei so als würde diese im Explorer über doppelklick geöffnet.

    Schlüsselwort:
    Eingabe eines A-Link Schlüsselwortes ruft die entsprechende Seite auf. Dieses Schlüsselwort muss definiert sein.

    Suchfenster:
    Öffnet die Hilfe mit angewähltem
    "Suchen Tab". Es kann vorab ein
    Suchbegriff eingegeben werden.

    Pop-UP-Hilfe:
    Blendet die Popup Hilfe mit einer bestimmten Nummer ein. Die Popups definieren Sie in den Projekteinstellungen.

    Multikey:
    Aufruf über A oder Klink Stichwort.

help-htmltesten