Advanced.Help

Dieses Werkzeug ermöglicht die Einbindung benutzerdefinierter Hilfedateien in SciTE (z.B. AD.CHM für die Active Directory UDF).
Mit der bestehenden Hilfe-Taste wird entweder die AutoIt-Hilfe oder die entsprechende benutzerdefinierte Hilfe aufgerufen. 
Abhängig davon, auf welchem Schlüsselwort der Cursor gerade steht. Für AutoIt oder unbekannte Schlüsselworte wird die AutoIt-Hilfe aufgerufen.
Für AutoIt wird ein eigenes Fenster und für die benutzerdefinierten UDFs ein weiteres Fenster geöffnet, so dass bequem
mit beiden Hilfen gleichzeitig gearbeitet werden kann.

VORAUSSETZUNGEN

* Die Hilfe-Dateien müssen vom Typ CHM (Compiled HTML Help) sein (z.B. AD.chm) 
* Alle Funktionen einer UDF müssen mit derselben Kennung beginnen (z.B. "_AD_")
* Die entsprechende UDF Datei muss ebenfalls verfügbar sein (z.B. AD.au3)

INSTALLATION / KONFIGURATION

Anzupassende Werte sind in spitzer Klammer (<>) geschrieben oder als Beispiele gekennzeichnet.

* Datei "advanced.help.properties" im selben Verzeichnis ablegen in dem auch in die Datei "SciTEUser.properties" liegt.
  Dies ist üblicherweise das Verzeichnis "C:\Benutzer\<Ihr Benutzername>\AppData\Local\AutoIt v3\SciTE".
* In diesem Verzeichnis fügen Sie in die Datei "SciTEUser.properties" am Anfang folgende Zeile ein:
    import advanced.help
* Kompilieren Sie die Datei "call.advanced.help.au3" zu "call.advanced.help.exe". 
* Kopieren Sie die Dateien "call.advanced.help.exe" und "advanced.help.lua" in ein beliebiges Verzeichnis (Beispiel C:\AutoIt\Advanced.Help\Code)
* Kopieren Sie die zu verwendenden CHM Hilfedateien in ein Verzeichnis (Beispiel: "C:\AutoIt\Advanced.Help\HelpFiles")
* Passen Sie die Datei advanced.help.properties wie folgt an:
  * In Zeile 
      "command.help.$(au3)=" 
    geben Sie den vollständigen Pfad zu "call.advanced.help.exe" und "advanced.help.lua" an.
    Mit dieser Änderung überschreiben Sie den Standardhilfeeintrag!
      Beispiel: command.help.$(au3)="C:\AutoIt\Advanced.Help\Code\call.advanced.help.exe" "C:\AutoIt\Advanced.Help\Code\advanced.help.lua"
  * In Zeile 
      "chm.mainfolder="
    können Sie das Verzeichnis angeben, in dem sich alle CHM Hilfedateien befinden. 
      Beispiel: chm.mainfolder=C:\AutoIt\Advanced.Help\HelpFiles
  * In Zeile 
      "udf.mainfolder="
    können Sie das Verzeichnis angeben, in dem sich alle UDF Dateien (z.B. AD.au3) befinden. 
      Beispiel: udf.mainfolder=C:\AutoIt\Include

    Sie können den Pfad aber auch für jede CHM und UDF Datei einzeln angeben.
  * Definieren Sie alle Pfade für die CHM und UDF Dateien im Format: "chm.path.<Kennung>=<Pfad>".
    Die Kennung definiert die ersten Zeichen einer UDF Funktion (Beispiel: "_AD_" für die Active Directory UDF).
    WICHTIG! Der Pfad zu den CHM Dateien darf keine Leerzeichen enthalten!
    
    Wurde "chm.mainfolder" definiert, so kann für die CHM Datei die Pfadangabe wie folgt aussehen:
      chm.path.<Kennung>=$(chm.mainfolder)\<Name der UDF>.chm
      Beispiel: chm.path._AD_=$(chm.mainfolder)\AD.chm
    Ansonsten muss der komplette Pfad angegeben werden.
      Beispiel: chm.path._AD_=C:\AutoIt\Advanced.Help\HelpFiles\AD.chm

    Dies gilt analog für die UDF Datei.  
    Wurde "udf.mainfolder" definiert, so kann für die UDF Datei die Pfadangabe wie folgt aussehen:
      udf.path.<Kennung>=$(udf.mainfolder)\<Name der UDF>.au3
      Beispiel: udf.path._AD_=$(udf.mainfolder)\AD.au3
    Ansonsten muss der komplette Pfad angegeben werden.
      Beispiel: udf.path._AD_=C:\AutoIt\Include\AD.au3
    Wurden die Funktionen einer UDF mit derselben Kennung auf mehrere Dateien aufgeteilt, so müssen diese durch | getrennt angegeben werden.
      Beispiel: udf.path._OL_=$(udf.mainfolder)\OutlookEX.au3|$(udf.mainfolder)\OutlookEX_Base.au3

    Beispiele für die AD und OutlookEX UDF:

      chm.mainfolder=C:\AutoIt\Advanced.Help\HelpFiles
      udf.mainfolder=C:\AutoIt\Include

      #~ Active Directory UDF
      chm.path._AD_=$(chm.mainfolder)\AD.chm
      udf.path._AD_=$(udf.mainfolder)\AD.au3

      #~ OutlookEX und OutlookEX_Base
      chm.path._OL_=$(chm.mainfolder)\OutlookEX.chm
      udf.path._OL_=$(udf.mainfolder)\OutlookEX.au3|$(udf.mainfolder)\OutlookEX_Base.au3