Installation
Java installieren
Unix, Linux
Windows
Zaurus

Programmstart
Unix, Linux
Windows
Zaurus
Generell

Problemlösungen
Schreibzugriff benötigt
Java 1.1
Anwendungsfenster zu klein oder zu groß
Multi-User Computer und voctrain.cfg
In Windows stört mich die Dosbox
In Windows funktioniert das "SendTo"-Kommando nicht immer
In Windows startet das Programm nicht


Installation



Java installieren
Vocabulary Trainer läuft auf einer Java virtual machine. Wenn Sie noch kein Java installiert haben, bekommen Sie es von JavaSoft.

Sie können sich das Java Runtime Environment JRE downloaden, oder gleich das etwas größere Java Development Kit JDK, falls Sie in Java programmieren möchten. Halten Sie auf JavaSoft's Webseiten zunächst Ausschau nach J2SE, weil die aktuellen JRE und JDK dort als "Java 2 Standard Edition" überschrieben sind.

Um Java zu installieren, befolgen Sie die Installations-Anleitung die Sie zusammen mit dem Java-Download bekommen.

Um zu testen, ob die Installation erfolgreich war oder Sie Java schon haben, geben Sie an einer Kommandozeile "java" ein. Sie sollten daraufhin einige Zeilen Informationen über die installierte Virtual Machine sehen.


Unix, Linux
Speichern Sie das Zip-Archiv an geeigneter Stelle, zum Beispiel /user/local/java/application/, und entzippen Sie es. Sie erhalten ein Verzeichnis "voctrain", in dem alle Dateien von Vocabulary Trainer enthalten sind. Wenn Sie keinen Root-Zugriff haben, entpacken Sie den Vokabeltrainer irgendwo in Ihrem Home-Verzeichnis.


Windows
Wählen Sie ein Verzeichnis für Vocabulary Trainer, zum Beispiel "C:\Program Files\java\application". Kopieren Sie das Archiv "voctrain_1.0-1.zip" mit dem Explorer in das gewählte Verzeichnis oder speichern Sie Ihren download gleich dort ab. Entpacken Sie die Zip-Datei mit einem geeigneten Tool, zum Beispiel "FreeZip", und löschen Sie das Zip-File anschließend. In Ihrem Zielverzeichnis gibt es nun ein Directory "voctrain", in dem alle von Vocabulary Trainer benötigten Dateien enthalten sind.
Ziehen Sie nun die Datei "voctrain.bat" mit dem rechten Mausknopf aus dem Dateimanager (Explorer) auf den Desktop oder in eine Programmgruppe und erstellen Sie eine Verknüpfung. Windows sollte der neuen Verknüpfung automatisch das Icon "voctrain.ico" zuordnen und eine Pif-Datei erstellen, die Sie über das Eigenschaften-Menü des neuen Icons bearbeiten können.


Zaurus
Zaurus Anwender sollten zuerst Jeode installieren, das Java Version 1.1.8 entspricht und standardmäßig vorinstalliert ist oder im Falle eines geflashten Custom ROMs nachinstalliert werden kann. Benutzen Sie für die Installation des i-Package nun das "Add/Remove Software"-Tool, oder geben Sie als Root das Kommando:

ipkg install voctrain_1.0-1_arm.ipk

Starten Sie nun das "Tab Setting"-Tool. Sie finden das neue Icon in der Gruppe "Applications". Verschieben Sie es in die gewünschte Tab, und drücken Sie Ihren Stylus auf "OK" und "Yes".

Nachdem der Tab-Manager seine Konfiguration gesichert hat, können Sie Vocabulary Trainer starten, worauf die Beispieldatei "example.voc" geladen wird.

Die voreingestellte Konfigurationsdatei ist nicht beschreibbar. Kopieren Sie die Datei  /usr/local/java/voctrain/voctrain.cfg  in ein lokales Verzeichnis in  /home/zaurus  und ändern Sie das Startscript  /usr/local/java/voctrain/voctrain  so ab, daß die entsprechende Programmzeile auf das neue  voctrain.cfg  verweist. Nun können Sie voctrain.cfg  einfacher bearbeiten, und Vocabulary Trainer kann sich die zuletzt geöffnete Vokabeldatei darin merken.




Programmstart


Unix, Linux
Um Vocabulary Trainer von einer Kommandozeile aus zu starten, begeben Sie sich in das Installationsverzeichnis von Vocabulary Trainer und tippen Sie dort "./voctrain". Alternativ fügen Sie das Installationsverzeichnis Ihrer Pfad-Variable hinzu, oder begeben Sie sich in ein Verzeichnis, das sich bereits in Ihrem Systempfad befindet, und erzeugen Sie dort einen symbolischen Link auf voctrain - nun können Sie voctrain aus einem beliebigen Verzeichnis heraus aufrufen.
Wenn Sie lieber mit einem einzigen Knopfdruck starten, dann erzeugen Sie ein neues Desktop- oder Panel-Icon und verweisen Sie als Startkommando auf voctrain.

Windows
Klicken Sie das Icon, daß Sie sich bei der Installation mit einer Verknüpfung erzeugt haben. Sie können Vocabulary Trainer auch in einer Dosbox oder mit einem eigenen Batch-Programm über das Kommando "voctrain.bat" starten , wobei Sie die Kommandozeilen-Parameter zur Verfügung haben.

Zaurus
Drücken Sie Ihren Stylus auf das Icon in der jeweiligen Tab-Gruppe.

Generell

Wenn Sie Vocabulary Trainer das erste Mal starten, wird Ihnen in einem Datei-Browser eine Beispiel-Vokabeldatei angeboten. Lesen Sie die Anwender-Dokumentation, um zu erfahren, wie man eigene Vokabeldateien erstellt.




Problemlösungen


Schreibzugriff benötigt
Vocabulary Trainer benötigt schreibenden Zugriff auf die Datei "voctrain.cfg". Ausserdem muß das Programm in dem Verzeichnis, in dem sich die Vokabeldateien befinden, Dateien für die Verwaltung Ihres Lernfortschritts erzeugen und aktualisieren, wofür ebenfalls Schreibzugriff erforderlich ist. Überprüfen Sie in einem Fehlerfall, ob der Schreibzugriff für das Programm erlaubt ist. Wenn Sie keinen Root-Zugang haben und sich deshalb keinen Schreibzugriff geben können, dann kopieren Sie sich voctrain.cfg in ein persönliches Datenverzeichnis, was im einzelnen in der Anwender-Dokumentation erklärt wird.


Java 1.1
Die JDK-Versionen bis zu JDK 1.1.8 werden sämtliche als "Java 1.1" bezeichnet. In dieser Version muß man Java bei einem Programmstart mitteilen, wo sich die Bibliotheksdatei "classes.zip" befindet, wenn das zu startende Programm in einem Archiv abgelegt ist. Wenn Sie die folgende Fehlermeldung erhalten, dann haben Sie möglicherweise eine Virtual Machine von Java 1.1 installiert: "Unable to initialize threads: cannot find class java/lang/Thread". In diesem Fall öffnen Sie das Startskript voctrain (voctrain.bat für Windows) mit einem Text-Editor und aktivieren Sie die auskommentierte Zeile unterhalb der Kommentarzeile "Path to classes.zip". Ändern Sie den Pfad dann so, daß er auf die classes.zip-Datei Ihrer Java-Installation verweist.

Sollten Sie Probleme damit haben Ihre classes.zip-Datei zu finden, dann suchen Sie am besten mit dem Explorer oder Konqueror Search Tool danach, oder tippen Sie "which java" in einer Kommandozeile und wechseln Sie in das ausgegebene Verzeichnis um dort "cd ..; cd lib; pwd" zu tippen - als Ergebnis sollten Sie den Pfad zu Ihrer classes.zip-Datei sehen, den Sie nun in die besagte Zeile von voctrain oder voctrain.bat eintragen können.


Anwendungsfenster zu klein oder zu groß
Das vorgegebene Anwendungsfenster ist so dimensioniert, daß es problemlos auf den Zaurus VGA-Bildschirm passt. Wenn Sie allerdings Vokabeln mit vielen möglichen Übersetzungen lernen möchten, kann es sein, daß nicht alle Übersetzungen zu sehen sind (Java 1.1), oder daß die abgefragte Vokabel von den vielen Übersetzungen weggescrollt wird. In diesem Fall ist es am einfachsten, das Fenster mit der Maus größer zu ziehen. Wenn Sie die Fenstergröße dauerhaft ändern möchten, dann ändern Sie entsprechend die Parameter
x_size und y_size in Vocabulary Trainer's Konfigurationsdatei voctrain.cfg. Sind Sie stolzer Besitzer eines Sharp Zaurus SL-5x00 oder eines Java-fähigen Handhelds mit kleinerem Display, dann möchten Sie das Anwendungsfenster oder die Fontgröße vermutlich eher verkleinern. Verändern Sie neben x_size und y_size zusätzlich die Parameter length_Inputfield und fontsize, bis Sie mit dem Ergebnis zufrieden sind. Sämtliche Parameter werden in der Anwender-Dokumentation erklärt.


Multi-User Computer und voctrain.cfg
Wenn Sie Vocabulary Trainer in einer Multi-User Umgebung installieren, dann sollte jeder Anwender sein eigenes
voctrain.cfg haben. Setzen Sie in diesem Fall die Zugriffsrechte des voctrain.cfg im Verzeichnis der systemweiten Vocabulary Trainer Installation auf nur-lesen. Anwender erfahren im Abschnitt "Vokabeldateien laden", wie sie ihre eigene Konfigurationsdatei verwenden.


In Windows stört mich die Dosbox
Öffnen Sie über dem VocTrain-Icon mit dem rechten Mausknopf das Icon-Menü und wählen Sie "Eigenschaften". Aktivieren Sie hier die Checkbox "Beim Beenden schließen", und stellen Sie die Select-Liste "Ausführen" auf den Eintrag "Als Symbol". Jetzt sollte die Dosbox nur kurz als Symbol in der Startleiste auftauchen und wieder verschwinden, sobald Vocabulary Trainer gestartet ist.


In Windows funktioniert das "SendTo"-Kommando nicht immer
Sie haben eine Verknüpfung zu Vocabulary Trainer (voctrain.bat) in Windows "SendTo"-Verzeichnis angelegt, um das Programm mit der "SendTo"-Auswahl im Icon-Popupmenü über den Icons von Vokabeldateien zu starten. Jedoch, wenn die Vokabeldatei etwas tiefer in Ihrer Verzeichnis-Hierarchie liegt, bekommen Sie eine Fehlermeldung "Kein Speicherplatz mehr im Umgebungsbereich".

Fügen Sie folgende Zeile in Ihrer "System.ini"-Datei hinzu, die Sie in Ihrem "Windows"-Verzeichnis finden:

[NonWindowsApp]
CommandEnvSize=1024

Fügen Sie die Zeile zur "NonWindowsApp"-Sektion dazu, wie es oben gezeigt wird, und nach einem Neustart sollte Windows genügend Umgebungsspeicher für den "SendTo"-Befehl bereit haben.


In Windows startet das Programm nicht
Das liegt womöglich daran, daß Ihr Java nicht gefunden wird. Im Startscript "voctrain.bat" ist das Java Runtime-Environment mit dem Kommando "jrew" voreingestellt, wenn Sie aber ein JDK installiert haben, müßte Vocabulary Trainer mit "javaw" oder "java" gestartet werden. Eventuell muß in "voctrain.bat" der Pfad zu "javaw" eingetragen werden, weil es nicht in Ihrem Systempfad steht. Öffnen Sie dazu "voctrain.bat" mit einem Texteditor und ändern Sie die entsprechenden Zeilen.