*******************************************
***             jGipfelbuch             ***
*******************************************

     
  jGipfelbuch ist ein Programm fuer Kletterer zum Erstellen und Verwalten
eines persoenlichen Gipfelbuches. Durch die hierarchische Gliederung der
Eintraege ist es sehr uebersichtlich und einfach zu bedienen. Weitere
Informationen finden sich im Verzeichnis 'doc'.


Voraussetzungen
---------------
  Da es sich um ein Java-Programm handelt, sollte es auf jedem Betriebsystem
laufen, fuer das es eine Java-Laufzeitumgebung (Java Runtime Environment,
JRE) gibt. Getestet wurde jGipfelbuch unter Linux und Windows 95/98/NT.

Seit der Version 2.0 des jGipfelbuchs wird Java2 ab Version 1.4 benoetigt 
(auch Java 1.4 genannt).

Aktuelle Java-Versionen fuer Windows und Linux werden unter der URL
'http://www.java.sun.com' kostenlos zum Download angeboten. Nicht-Entwickler
sollten sich nur das 'Java Runtime Environment' statt des kompletten JDK
herunterladen, es ist wesentlich kleiner (ca. 11 MB).


Installation und Start
----------------------
  Der einfachste Installations-Moeglichkeit ist die Benutzung von Java
WebStart. Wenn Java Webstart installiert ist, muss man nur noch den 
entsprechenden Link auf der Homepage anklicken.
Nach der Installation kann jGipfelbuch sehr einfach ueber den WebStart
Client gestartet werden (dieser kann auch Verknuepfungen erstellen).

Wenn Java WebStart nicht benutzt werden soll, kann auch ein ZIP-Archiv von
der Homepage geladen werden. Dieses Archiv packt man in einem beliebigen
Verzeichnis aus.

Der Start des Programmes erfolgt auf Windows-Systemen durch den Aufruf der
Datei 'run.bat'. Fuer Unix-Systeme gibt es analog die Datei 'run.sh'. Fuer
andere Systeme sollte die Startdatei leicht anpassbar sein. Der Aufruf muss
dabei aus dem jGipfelbuch-Verzeichnis erfolgen.

Die beiden Startdateien gehen davon aus, dass das Verzeichnis des
java-Programms ('java.exe' unter Windows oder nur 'java' unter Unix) in der
PATH-Variable enthalten ist. Ist dies nicht der Fall, sollte der Java-Aufruf
in der jeweiligen Startdatei um die volle Pfadangabe erweitert werden.

  Beispiel fuer 'run.bat': C:\J2SDK1.4.0\bin\java.exe -jar jcdiary.jar

In den aktuellen Java-Versionen fuer Windows wird das Verzeichnis der
'java.exe' bei der Java-Installation automatisch in den PATH aufgenommen.

Ausserdem kann von der Homepage auch ein ZIP-Archiv mit dem kompletten 
Sourcecode der Applikation geladen werden.


Datenuebernahme aus Versionen vor 2.0
-------------------------------------
  Seit der Version 2.0 werden die Gipfelbuch-Daten nicht mehr im Applikations-
verzeichnis gespeichert, sondern sie befinden sich im HOME-Verzeichnis im 
Unterverzeichnis ".jcdiary". So muss das Programm in Multi-User-Umgebungen
nicht mehrmals installiert werden. 

Unter Unix/Linux befinden sich die Daten im Verzeichnis "/home/USER/.jcdiary".
Je nach benutzter Windows-Version sind sie z.B. bei Windows 2000 im Verzeichnis
"C:\Dokumente und Einstellungen\USER\.jcdiary" zu finden. (USER ist der Name
des Benutzers.)

Um die bisherigen Gipfelbuch-Daten in die Version 2.0 (oder groesser) zu 
uebernehmen, muessen die Dateien "cldiary.xml" und "cldiary.dtd" aus dem alten
Installationsverzeichnis in das oben beschriebene Verzeichnis kopiert werden. 
Beim naechsten Start stehen die alten Daten wieder zur Verfuegung.


Internationalisierung
---------------------
  jGipfelbuch unterstuetzt Internationalisierung. Zur Zeit existieren eine
deutsche, eine englische und eine italienische Uebersetzung. Beim Programmstart 
ermittelt jGipfelbuch die eingestellte Sprachversion des Betriebsystems und 
benutzt diese.


Kontakt
-------
  Die Homepage von jGipfelbuch befindet sich unter folgender Adresse:

http://www.saring.de/jcd 

Da das Programm staendig weiter entwickelt wird, lohnt sich von Zeit zu Zeit
ein Blick auf diese Seite. Bei gefundenen Fehlern, Anregungen fuer neue
Features oder sonstigen Sachen schickt mir bitte eine Mail an:

projects@saring.de

Viel Spass !


Autor: Stefan Saring
       2002/07/07

Uebersetzer: Mario Moroni (italienisch)
