Installieren und loslegen

semAuth2 installieren:

ZIP-Datei herunterladen, entpacken
in den Ordner semAuth2/pub wechseln

Die Mindmap test.mm in html übersetzen:

Windows:

ZIP-Datei entpacken, z.B. auf den Desktop; als Ergebnis liegt auf dem Desktop der Ordner semAuth2.
In einer Eingabeaufforderung ("CMD") in den Ziel-Ordner wechseln, in dem die html-Dateien abgelegt werden sollen. Bei uns ist das auf dem Desktop der Ordner pub im semAuth2-Ordner, also
- cd C:\Users\jb\Desktop\semAuth2\pub
Im Ziel-Ordner semAuth starten, z.B.
- java -classpath ..\xslt\saxon9he.jar net.sf.saxon.Transform ..\mm\test.mm ..\xslt\semAuth2.xsl t=../templates/semAuth2.html
Man beachte die Unterschiede von "\" (Backslash) und "/" (Slash) in den Beispielen. Die Pfade aus den Java-Parametern enthalten windows-unübliche "/", da diese erst zur Laufzeit in Java ausgewertet werden.

Linux:

ZIP-Datei in den gewünschten Ziel-Ordner entpacken, z.B. in den Ordner ~/a/l/lib
z.B. in einer bash in den Ziel-Ordner wechseln, in dem die html-Dateien abgelegt werden sollen, in unserem Beispiel:
- cd ~/a/l/lib/semAuth2/pub
Das folgende mehrzeilige Kommando einfach in eine bash-Shell kopieren:
- java -classpath ../xslt/saxon9he.jar \ net.sf.saxon.Transform \ ../mm/test.mm \ ../xslt/semAuth2.xsl\ t=../templates/semAuth2.html

Kommandozeilen-Parameter für Anwender

Parameter	Beispiel	Effekt
t	`t=../xslt/semAuth2.html`	Verwendet die angegebene html5-Datei als nutzerspezifisches Template. Die Datei muss als XML interpretierbar und daher well-formed sein. ACHTUNG Windows: Der Pfad zur Template-Datei wird nicht von der Windows Eingabeaufforderung, sondern zur Laufzeit von Java ausgewertet. Er muss daher auch in Windows mt "/" (statt mit "\") angegeben werden, Bsp: `java` -classpath ..\xslt\saxon9he.jar net.sf.saxon.Transform ..\mm\semAuth2.mm ..\xslt\semAuth2.xsl `t=../xslt/semAuth2.html`
p	`p = /home/mustermann/public_html/`	Schreibt die Dateien in den angegebenen Pfad. Der Pfad wird mit "/" angegeben und sollte mit einem "/" enden.
build	"build=`date`" (nur Linux; mit Anführungszeichen!)	Übergebe dem Skript über die Kommandozeile Build-Informationen (hier: automatisch generierter Zeitstempel). Wird im html-Template vom Attribut semauth="build" ausgewertet.
OOo	`OOo=yes`	Bug-Workaround für OpenOffice: fügt vor jeder Section (h1..h6) einen leeren Absatz ein. Wenn man dann die erzeugte html-Seite mit Copy & Paste in OpenOffice / LibreOffice einfügt, stimmen auch die Überschriftsnummern wieder.
Moodle	`Moodle=yes`	Erzeugt eine quiz-Datei im Format MoodleXML, falls in der Vorlage Moodle-Quizfragen enthalten sind.

Ein Aufruf des Skriptes, der relative und absolute Pfade mischt, sieht z.B. so aus:

java -classpath ../xslt/saxon9he.jar net.sf.saxon.Transform\ 
 
	~/a/l/m/berlioz2016.mm \ 

	../xslt/semAuth2.xsl \ 

	t=/home/ubuntu/a/public_html/jbusse.de/templates/hdaw-mint.html \ 

	p=/home/ubuntu/a/public_html/jbusse.de/berlioz2016 \ 

	build="`date`"

Hallo Web-Berater: Für die Betreuung eines Endanwenders könnte es derzeit (Stand Feb 2016) sinnvoll sein, einem nich IT-affinen Endanwender ein .BAT-Skript auf den Desktop zu legen, in dem o.a. Pfade hart codiert sind?

Kommandozeilen-Parameter für Entwickler

Parameter

Beispiel

Effekt

verbose

verbose=1

0: silent, serious warnings only

1: show that systems are working fine

2: develper information

o=html

Debug: gebe aus der Bearbeitungs-Pipeline Zwischenstand aus. Erlaubte Werte: siehe semAuthLite.xsl: test="$o = 'html'"