copyright (c)  2003   usegroup
docuML

Jochen Staerk
docuML
Kompilieren von docuML-Artikeln

nach untenXSLT-Prozessor
nach untenProjekt-Shell-Script
nach untenDie Transformation

XSLT-Prozessor

nach obenXSLT-Prozessor 

Zum Übersetzen von docuML-Dokumenten jagen Sie diese einfach durch einen XSLT-Prozessor wie Saxon von Michael Kay. Ich persönlich habe ein kleines Shell-Script in /usr/bin mit Namen Saxon, das ungefähr so aussieht

#!/bin/sh
/usr/java/j2re1.4.1_01/bin/java -cp /usr/local/saxon/saxon.jar com.icl.saxon.StyleSheet -a $1 $2 $3
. Lässt es Ihr Betriebssystem zu, können Sie sich ein solches Script u.U. durch Einsatz von Instant Saxon sparen.


Projekt-Shell-Script

nach obenProjekt-Shell-Script 

Normalerweise schreibe ich mir ein kleines Script project.sh, das alle Dateien durch Saxon jagt, beispielsweise

saxon -o index.html index.xml
saxon -o kompilieren.html kompilieren.xml
. Allerdings habe ich da auch schon schönere Shell-Scripts gesehen, die Saxon bspw. alle .xml-Dateien eines Verzeichnisses übergeben. Dabei sollten Sie beachten dass die Projektdatei project.xml die Transformation unterstützt, aber selbst nicht transformiert werden sollte.


Die Transformation

nach obenDie Transformation 

Die Transformation gibt vor, wie die docuML-XML-Dokumente in die XHTML-Ausgabe umgewandelt wird (i.e. wie die Ausgabe aussehen soll), ist also das Kernelement von docuML.

Die Transformation liegt zum kleinen Teil in xhtmlxsl.xsl (Einbindung von XHTML), und zum großen Teil in documl.xsl. Wenn Sie diese Dateien ändern möchten, und noch nicht verstehen, empfehle ich Ihnen das Buch XSLT Programmer's Reference von Michael Kay, 777 Seiten, Englisch, 34,99$US von Wrox, ISBN 1-861003-12-9 und das XSLT-Tutorial.


copyright (c)  2003   usegroup