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 1.1 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 1.1.
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 © 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 1.1.
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),
* ein Chromium Derivat.
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
Copyright © 2003-4 Robert Platt, aktualisiert 2008 und 2020
von W. Spiegl
Diese Datei bildet einen Teil der FreeDOS HTML Hilfedokumentation
und ist gedeckt durch ihre Bedingungen, siehe auch: index.htm