AurigaDoc Workshop: Vorbereitungen

Um mit AurigaDoc zu arbeiten müssen bestimmte Voraussetzungen erfüllt sein. Die JRE muss installiert und bestimmte Umgebungsvariablen müssen gesetzt sein. AurigaDoc selbst ist als ZIP-Datei erhältlich und muss nur ausgepackt werden.

Download und Installation der JRE

Die JRE kann bei "java.sun.com" heruntergeladen werden. Ich habe bei mir die Datei auf den Desktop gespeichert. Ihr müsst die (aktuellste) Version "J2SE v 1.4.2_08 JRE" herunterladen.

Nachdem man der Lizenz der JRE zugestimmt hat, kann man mit dem Download der Datei für Windows ("j2re-1_4_2_08-windows-i586-p.exe, 15,06MB") beginnen.

Der Download kann aufgrund der Größe ein wenig dauern. Sobald die Datei fertig heruntergeladen ist, kann man durch Doppelklick die Installation starten. Ich habe die die Option "Standard" verwendet.

Wenn die Installation dann erfolgreich durchgeführt wurde, sollte auf dem Desktop das Symbol "Java Web Start" erscheinen. Durch Doppelklick auf das Symbol sollte das Java-Programm "Java Web Start-Anwendungsmanager" gestartet werden. Wenn dieses Fenster erscheint, dann ist die JRE erfolgreich installiert.

Download und Installation von AurigaDoc 1.3

Auf der Homepage von AurigaDoc ist ein Hyperlink für den Download von AurigaDoc angegeben. Dieser Link führt zur Übersicht der verfügbaren Dateien und danach auf die Mirrors von "sourceforge.net". Die Datei ist als einzelne ZIP-Datei erhältlich. Ich habe AurigaDoc auf meinen Desktop abgespeichert. "aurigadoc.zip" kann an einen beliebigen Ort entpackt werden. Ich entpacke es immer nach "c:\tools\aurigadoc".

Damit AurigaDoc funktioniert müssen allerdings noch zwei Einstellungen gemacht werden. Unter WindowsXP
"Einstellungen - Systemsteuerung - System"
gibt es einen Register "Erweitert" und dort einen Button "Umgebungsvariablen". Hier kann die Umgebungsvariable "Path" abgändert werden. Vorgehen:

• "Path" bearbeiten
• Unter "Wert für Variablen" am Ende "c:\tools\aurigadoc\bin" hinzufügen (siehe Screenshot unten)
• den neuen Wert mit "OK" abspeichern

Die nächste Einstellung muss im Verzeichnis "c:\tools\aurigadoc\bin" gemacht werden. Hier müsst Ihr die Datei "aurigadoc.properties" mit einem beliebigen Editor öffnen. Die Zeilen

# path of aurigadoc home
# for unix specify like this
aurigadoc.home=/home/kshaikh/projects/au/aurigadoc
#for windows specify like this
#aurigadoc.home=c:\\software\\aurigadoc

bitte ändern auf

#for windows specify like this
aurigadoc.home=c:\\tools\\aurigadoc

Danach sollte AurigaDoc funktionieren, da es aber noch einen Bug (für MHTML) in AurigaDoc 1.3 gibt, machen wir den ersten realen Test mit richtigen Daten im nächsten Kapitel. Ihr könnt aber das untenstehende Beispiel gerne schon mal ausprobieren:

Ctoolsaurigadocbinaurigadoc -html -XML ../samples/nested-sections/nested.xml
-OUT ../samples/nested-sections/test.html
22 Apr 05 194236,353 INFO Converting to HTML..
22 Apr 05 194236,353 INFO Applying XSL..
22 Apr 05 194237,124 INFO XSL Transformation done in 771 msecs.
22 Apr 05 194237,124 INFO Conversion done in 941 msecs.

Ctoolsaurigadocbin

Wichtig zu erwähnen ist noch, dass ich mal Probleme mit zusätzlichen Kommentaren vor "aurigadoc.home=c:\\tools\\aurigadoc" hatte. Wichtig ist auch, das hinter dem Pfad keine Whitespaces (Tabulatoren, Leerzeichen) kommen. Am besten Ihr macht es genauso wie ich.