# Anleitung, um die HTML-Hilfe zu schreiben:

      Beitraege sind sehr willkommen. Wenn Sie einen Beitrag fuer die
      HTML-Hilfe selbst erstellen wollen, kontaktieren Sie bitte den
      Hauptersteller:
        fritzdotmuelleratmaildotcom

## Die Struktur des \help Verzeichnisses:

      \help\index.htm
        Listet die auf dem System installierten Hilfedateien auf.
        Wird automatisch geladen, wenn 'LANG' nicht auf eine verfuegbare
        Sprache gesetzt ist und Englisch (EN) nicht installiert ist.
      \help\%LANG%\index.htm
        HELP wird diese Datei standardmaessig laden.
        %LANG% ist die durch Setzen der 'LANG' Umgebung gewaehlte Sprache.
        Wenn 'LANG' nicht gesetzt ist, wird EN vermutet (verwendet).
      \help\%LANG%\help.htm
        HELP wird diese Datei laden, wenn der Benutzer F1 drueckt oder
        auf "Hilfe ueber die Hilfe" klickt.
      \help\docinfo\bi\nls\%LANG%.bi
        Speichert Sprachlisten, zur Verwendung mit Aitor's Tool
        "bookshlf", um den den Sprachenindex (\help\index.htm) zu erstellen.

## Erzeugen von komprimierten Hilfeateien:

      Sie sollten fuer Ihren komprimierten Dateisatz einen Namen wie z.B.
        \help\...\[name]\[name].zip
      verwenden.
      Wenn Sie Ihre Hilfedateien komprimieren wollen, sollten sie im Zip-
      Format sein. Sie sollten den gleichen Dateinamen wie das Verzeichnis,
      in dem sie  gespeichert sind und die Zip-Dateiendung haben.
      Zum Beispiel:
        \help\en\myhelp\myhelp.zip
      Die index.htm kann innerhalb der Zip-Datei sein, aber help und
      bookshlf funktionieren besser, wenn sie ausserhalb sind.
      Verzeichnisstrukturen sind innerhalb der Zip-Datei zulaessig. Jedoch
      sollte auf Verschluesselung und auf andere Komprimierungsformate
      verzichtet werden, da sie nicht unterstuetzt werden.

## Modifizierte Versionen der Hilfedateien erzeugen:

      Verwenden Sie bei allen modifizierten Versionen einen eindeutigen Titel
      auf der Titelseite (oft index.htm). Dies vermeidet Verwirrung oder
      Konflikte, und, am allerwichtigsten, ist laut Teil 4A der
      GNU Free Documentation Lizenz auch erforderlich.
      Neben dem Aendern des Titels aktualisieren Sie bitte auch die History,
      Liste der Autoren usw. entsprechend der Sektion 4 der
      GNU Free Documentation Lizenz.
      Wenn der Datensatz ein neues oder modifiziertes Paket beschreiben soll
      oder der Datensatz einer grundlegenden Aenderung (z.B. einer Ueber-
      setzung) unterlegen soll, ist es am besten, einen abweichenden Unter-
      verzeichnisnamen zu verwenden, wie es oben unter "Die Struktur des
      \help Verzeichnisses" erklaert wurde.
      Dies ist einfach durch ein "Suchen und Ersetzen" in der index.htm des
      Unterverzeichnisnamens zu erledigen, und es ist es wert.
      Zum Beispiel koennte eine abgespeckte Version des "hhstndrd" Daten-
      satzes "hhmicro" genannt werden. Das waere dann auch der Name des
      Unterverzeichnisses und der Titel in der index.htm koennte sein:
        FreeDOS Hilfe (hhmicro 1.0)
      Es ist akzeptabel, nur die Versionsnummer (anstelle des Namens und des
      Verzeichnisses "hhmicro") zu veraendern, wenn Updates herausgebracht
      werden.

## Neue Dateien erzeugen oder hinzufuegen:

      Es wird empfohlen, dass die folgende Lizenzinfo an das Ende jeder neuen
      Hilfedatei geschrieben wird (ausser es handelt sich um eine allein-
      stehende Datei, die nicht in einer Hilfedokumentation enthalten ist):
        ...
        <hr>
        <address>

        <b>Copyright &copy; 2008
        <a href="mailto:meineemail@adresse.com">Mein Name</a></b><br>
        Diese Datei bildet einen Teil der FreeDOS HTML Hilfedokumentation
        und ist gedeckt durch ihre Bedingungen, siehe auch:
        <a href="../index.htm">index.htm</a>

        </address>
        </body>
        </html>

      Das Mitliefern einer Email-Adresse ist freiwillig; wenn Sie Ihre
      Hilfedateien auf eine Webseite laden, koennen Email-Adressen zu
      Spamzwecken verwendet werden.
      Die Bedingungen sind die GNU Free Documentation Lizenz.

## Dateien aus einer .zip-Datei bearbeiten:

      Vielleicht wollen Sie die html-Dateien entpacken, damit sie mit einem
      anderen Browser gelesen oder mit einem Editor bearbeitet werden koennen.
      Beachten Sie in diesem Fall bitte, dass die Zip-Dateien in der Rangliste
      vor den unkomprimierten Dateien stehen; wenn Sie sichergehen wollen,
      dass Help eine bearbeitete, unkomprimierte Version einer Datei liest,
      sollten Sie die Originalversion dieser Datei innerhalb der Zip-Datei
      ersetzen oder loeschen.

## Hilfedateien testen:

      Die Refernzbrowser um Hilfedateien zu testen sind:
        * der FreeDOS HTML Hilfe-Betrachter (help.exe),
        * der Netscape Navigator.

## Tables erzeugen:

      Ungluecklicherweise unterstuetzt Help keine Tabellentags.
      Verwenden Sie fuer Informationstabellen die vorformatierenden
      Tags <pre> </pre>

## Generelle Tipps:

      Druecken Sie F5 oder Strg+R um die von der Hilfe angezeigte Datei zu
      aktualisieren. Die Auswirkungen von Aenderungen an der Datei werden
      sofort angezeigt. Dies ist nuetzlich, wenn Hilfedateien in einer
      windowsartigen Umgebung editiert werden.
      Um den HTML Hilfeviewer bei Dateien zu verwenden, die noch nicht in
      die Hilfedateien integriert sind, kann der Schalter zum Umgehen des
      Hilfepfads verwendet werden:
        help /O[Laufwerk:][Pfad]Dateiname[.htm]
      oder, wenn relativ zum /HELP Verzeichnis:
        help /L[Unterverzeichnis]Dateiname[.htm]

## Siehe auch:

      Von der HTML Hilfe unterstuetzte Tags
      Quellen des Autors

#### [Hauptseite] [oben]