AurigaDoc - XML, Webseiten, PDF und Tutorials

Einige von Euch werden in ihrer täglichen Arbeit Installationsanweisungen, Dokumenationen, Tutorials oder HowTos schreiben. Wenn diese Dokus im Internet oder Intranet abgelegt werden müssen, bleibt oft die Frage nach dem Format. HTML bietet sich an, ist aber nicht 100% als Printmedium geeignet. Bei einem großen PDF brauchen langsamere Modems schon mal, bis sie runtergeladen sind.

Deswegen bietet es sich an, gerade größere Dokumentation in nur einem Format abzuspeichern und dieses dann in das gewünschte Zielformat zu konvertieren. AurigaDoc ist in der Lage genau das zu tun. Ich benötige meine Dokumentation sowohl im HTML, als auch im PDF-Format und nur eine Datei zu pflegen hat hat schon was.

Fazit: AurigaDoc ist eine Software, die aus einer einzigen XML-Datei (für Dokumentation, Tutorials, Tagebücher und andere Webseiten) verschieden Ausgabeformate erstellen kann:

• HTML
• PDF
• CHM
• DHTML
• JavaHelp (externer Hyperlink)

(Screenshot von der JavaHelp)

Inhalt des Workshops:

• Installation unter Windows
• Erster Test mit einem einfachen Test-XML-Dokument
• Strukturen
• Verschiedene Output-Formate

Für mich ist der Mehrwert von AurigaDoc, der geringe Aufwand zur Pflege bestehender Dokumentation und die Vielfalt der Ausgabeformate. Die Formatanweisungen erfolgen in XHTML, dessen Tags vielen Webdesignern und Homepage-Betreibern eh bekannt sind. Beispiel:

<p>Unser erstes Beispiel zeigt (...)</p>
<div class="php_skript_kopf">PHP-Skript</div>
<div class="php_skript_inhalt">
<pre>  require_once tbs/tbs_class.php;
(...)

(Quelle: TBS-Doku: Erstes Beispiel mit zwei Templatevariablen)

Die Vorbereitungen beschäftigen sich mit der Installation von der JRE, AurigaDoc, sowie den verschiedenen Einstellungen unter Windows.