From: dirk@kalium.physik.tu-berlin.de 
Subject: ONLINE-Hilfe in NS3.0: Oh Schreck!! ?
Keywords: ONLINE Hilfe Nextstep 3.0
Reply-To: dirk@kalium.physik.tu-berlin.de 
Organization: ZRZ/TU-Berlin
Date: Thu, 8 Oct 1992 21:29:34 GMT

Hallo,

da  das ON-LINE-Hilfssystem nicht auf deutsch vorhanden ist, habe ich ja  
schon verkraftet.
Da  es aber anscheinend auch nicht moeglich ist (ohne noch herauszufindene  
Tricks s.u.) , deutschsprachige Programme mit einem solchen zu versehen,  
finde ich schon ziemlich traurig!!!

Den wenigen Informationen bzgl. ONLINE-Hilfe zufolge, mu  man im  
ProjectBuilder "Add Help Directory" anwaehlen, damit dieser ein  
entsprechendes Verzeichnis anlegt und mit einer Index-Datei und einem  
Inhaltsverzeichnis versieht. Das funktioniert aber nur, wenn man sein  
Programm mit der Primaersprache Englisch entwickelt. Hat man stattdessen  
"German" eingestellt, funktioniert nach "Add Help Directory" nicht einmal  
mehr "make": "don't know how to make help".

Irgendwie verstehe ich das Konzept der ONLINE-Hilfe ohnehin nicht ganz. In  
/NextLibrary/Documentation/NextDev/GeneralRef/02_ApplicationKit/Classes/NX 
HelpPanel.rtf
steht:

"Adding the standard help system facilities to your application is easy.   
The Add Help Directory command in Project Builder supplies your  
application with a help directory and populates it with simple  
table-of-contents and index files.  Interface Builder's Menu palette  
offers a Info submenu containing a preconfigured Help command.  With this  
command and the two files, your application can display the generic help  
text that's available to all NeXTSTEP applications (for example, "Using  
the mouse" and "Sending a fax").  You can then add help information (as  
well as table-of-contents and index entries) that are specific to your  
application, and override any of the generic information your application  
inherits."

Demnach sollten alle Programme allgemeine Hilfe anbieten wie "Using the  
mouse" oder "Sending a fax". Stattdessen kommt immer die Meldung "Die  
Anwendung ... arbeitet nicht mit NeXTstep Hilfe". Mu  denn jedes Programm  
die allgemeinen Hilfsdateien explizit enthalten? Was passiert wenn NeXT an  
den Texten was ergaenzt? Geben dann die Programme mit ONLINE-Hilfe weiter  
die alten Texte aus, die zum Zeitpunkt der Programmierung in das Projekt  
Verzeichnis kopiert wurden? Die Datei "Help.store" in  
"/usr/lib/NeXTSTEP/Resources/language.lproj/Help.store" kann in spaeteren  
Versionen ja veraendert werden, was ist aber mit den Dateien "Index.rtf"  
und "TableOfContents.rtf", die ja nun bei jedem Programm veraendert  
wurden?
Von einen objekt-orientierten System hatte ich eigentlich eine  
geschicktere Vererbung erwartet!

Nun zu den schmerzlichen Tricks:
Eine Moeglichkeit ist z.B. die Dateien "Help.store" und "HelpTemplate/*"  
von "/usr/lib/NeXTSTEP/Resources/English.lproj" nach  
"/usr/lib/NeXTSTEP/Resources/German.lproj" zu linken. Dann muesste  
zumindest der Menuepunkt im ProjectBuilder wieder funktionieren.
Eine Loesung ist das aber nicht. Man hat dann ja immer eine Hilfsdatei mit  
gemischten Sprachen. Und das bleibt auch so, wenn spaeter mal deutsche  
System-Hilfsdateien existieren, denn der englische Index und das  
Inhaltsverzeichnis sind ja kopiert worden.

---------------------------------

Bin ich da irgendwie einem grossen Irrtum aufgesessen, oder ist alles  
wirklich so schrecklich, wie es mir gerade vorkommt?

Eine ausfuehrliche Diskussion koennte vielleicht mehr Licht ins Dunkel  
bringen.


Dirk Schwarzhans

Newsgroups: de.comp.sys.next