Dieses Programm ist FREEWARE. Es darf von jedem frei kopiert werden, solange keine Dateien verändert werden und keine Dateien, außer fremdsprachlicher Übersetzungen, hinzugefügt werden (insbesondere Viren sind verboten :-)
Die Benutzung ist frei.
Die Weitergabe über Public-Domain-Versender oder als Beilagen zu kommerziellen Produkten (Zeitschriften, Computer usw.) ist nur nach vorheriger Absprache gestattet.
Der Autor übernimmt keinerlei Haftung für Schäden, die direkt oder indirekt durch die Benutzung von 'HelpUpdate' oder 'HelpUpdate Frontend' entstehen.
Zweck:
======
StrongHelp-kompatible Hilfstexte updaten.
Mögliche Anwendungen:
- Bei umfangreichen Helpfiles können Updates herausgegeben werden, die nur die Änderungen beinhalten. Das spart Zeit und Geld, wenn diese mit Hilfe der DFÜ verteilt werden.
- Handgeschriebene Texte mit computererstellten Texten mischen. Computererstellt heißt dabei z.B., daß die Texte aus der Programmsource extrahiert werden.
Installation:
=============
HelpUpdate
----------
benötigt keine Installation.
HelpUpdate Frontend
-------------------
HelpUpdate sollte in einem Directory entlang des Run$Path zu finden sein.
Das Kommando, mit dem HelpUpdate gestartet wird, steht in der Datei Messages hinter dem Kürzel 'command'. Es ist standardmäßig gesetzt auf 'TaskWindow "HelpUpdateRun:HelpUpdate %0 %1 %2"'. Dieses kann geändert werden, z.B. um das Programm aus Gründen der Geschwindigkeit nicht im Taskwindow laufen zu lassen. Auch denkbar ist die Benutzung von !Virtual, die allerdings nicht getestet wurde. Die Parameter '%0 %1 %2' dürfen nicht verändert werden und müssen immer direkt hinter 'HelpUpdate' stehen. HelpDiffRun: ist auf "<Obey$Dir>.,<Run$Path>" gesetzt und sollte so benutzbar sein.
Die Sprache, die das Programm benutzt, kann installiert werden, falls die automatisch gewählte nicht ideal ist. Siehe dazu weiter unten den Abschnitt 'ResFind'.
Alle Parameter müssen Directories bezeichnen - im Falle des dritten Parameters braucht dieses noch nicht zu existieren -, die StrongHelp-Hilfstexte enthalten, also die Dateien 'HelpData' und 'Index'. HelpUpdate nimmt dann das <original> Directory, fügt alle Hilfeseiten aus dem <update> Directory hinzu und schreibt das Ergebnis in das <ausgabe> Directory. Ist dieses nicht angegeben, so wird das <original> überschrieben. Befinden sich im <original> und im <update> Hilfeseiten gleichen Namens, was die Regel sein dürfte, so wird natürlich die Hilfeseite aus dem <update> genommen.
HelpUpdate Frontend
-------------------
Das Frontend ist eine WIMP-Application. Sie wird durch Doppelklick gestartet und öffnet dann ein Fenster in der Mitte des Bildschirms. Die drei Zeilen entsprechen den Parametern von HelpUpdate. Original: und Update: können gesetzt werden, indem das enstprechende Directory auf das beschreibbare Icon gezogen wird. Durch Setzen von Original: wird auch Ausgabe: gesetzt, wenn dort noch kein Wert eingegeben wurde. Ausgabe: kann in der üblichen Weise mit einer Save-Box gesetzt werden, die erscheint, sobald SELECT über dem Pfeil zur rechten geklickt wird. Alle Werte können auch über die Tastatur eingegeben werden. Klicken auf das OK-Icon startet HelpUpdate (siehe Installation). Klicken auf das Löschen-Icon löscht alle eingetragenen Werte. Das Programm wird durch Schließen des Fensters oder über das Menü beendet.
!HelpUpd paßt sich automatisch an die Sprache des Rechners an, falls die Meldungen usw. in der Sprache vorhanden sind. Dazu befindet sich in der Application ein Directory Resources, in dem sich für jede Sprache ein Directory mit deren Namen befindet. Sollte Ihre Sprache dort nicht zu finden sein, können Sie gerne das Directory einer anderen kopieren und den Inhalt übersetzen.
Beim Starten des Programmes wird ein Utility namens ResFind aufgerufen, welches die konfigurierte Sprache ausliest und nachschaut, ob das passende Sprach-Directory zu finden ist. Anderenfalls läuft das Programm in englisch (UK). Durch ein paar Variablen, die am besten in der !Boot-Datei des Rechners gesetzt werden, kann die Sprachsuche Ihren eigenen Bedürfnissen angepaßt werden. Damit kann z.B. erreicht werden, daß ein Programm immer in einer bestimmten Sprache läuft (z.B., weil die Übersetzung in die Landessprache nicht so gelungen ist). Weiterhin ist es möglich, Sprachen anzugeben, nach denen gesucht wird, bevor Englisch an die Reihe kommt.
Die Steuerung erfolgt durch folgende drei System-Variablen, die am besten in der System-!Boot-Datei gesetzt werden sollten:
HelpUpdate$Language, ResFind$LanguagesPref und ResFind$LanguagesSuff.
Beim Aufruf der Application sucht ResFind nach der ersten Sprache, die unterstützt wird entlang folgender Liste von Sprachen:
1. Inhalt der Variablen HelpUpdate$Language
2. Inhalt der Variablen ResFind$LanguagesPref
3. Die konfigurierte Sprache
4. Inhalt der Variablen ResFind$LanguagesSuff
5. UK
Nehmen wir als Beispiel einen norwegischen User (weil von dort so viel gute Software kommt), der seine Maschine auf 'Norway' konfiguriert hat. Nun ist diese Sprache im restlichen Europa nicht sehr verbreitet, weswegen ein nicht norwegisches Programm üblicherweise keine passende Übersetzung anbieten wird. Unser User ist aber sehr sprachbegabt und spricht noch sehr gut deutsch und französisch, wohingegen das englisch nur für Notfälle ausreicht. Er möchte also, soweit möglich, vor der englischen Version lieber eine deutsche oder französische, falls vorhanden. Er schreibt demnach in seine System-!Boot-Datei die Zeile
*Set ResFind$LanguagesSuff Germany,France
Wird nun eine Application, die (wie diese) ResFind verwendet aufgerufen, läuft das Programm in der ersten angebotene Sprache aus der Liste 'Norway,Germany,France,UK'.
Hat dieser User z.B. eine Application !Otto, die die Sprache 'Humor' mit entsprechend amüsanten Meldungen bietet, dann genügt die Zeile
*Set Otto$Language Humor
in der !Boot-Datei, um sicherzustellen, daß !Otto humorvoll läuft - egal, was in den anderen Variablen steht.
