3.2 Struktur des ZML-Verzeichnisses

tools

Kleine Helferlein im Umgang mit ZML. Davon sind allerdings nur zwei wesentlich:

zmltopdf.py ist ein Python-Skript, das aus einer Ausgabe deine PDF-Version macht. Der einzige Parameter ist die Nummer der Ausgabe. see Schritt 2 - das Print-Layout.

tbrplent und tbents.txt sind das tbrplent-Hilfsprogramm, das bei der Umwandlung von XHTML nach LaTeX nötig ist. Es wird daher von zmltopdf.py aufgerufen.

phpwiki2html.py wandelt (mehr schlecht als recht) PHP-Wiki-Artikel in ZMLs XHTML-Dateien um, see Schritt 1 - Erzeugen der XHTML-Dateien.

make-karman-website.py erzeugt die Webseiten, See make-Skript.

doc

Die Dokumentation, die du gerade liest, im Texinfo-Format.

xslt

Hier und in den Unterverzeichnissen befindet sich das Herz von ZML, programmiert in XSLT.

ausgaben-sammeln.xsl liest die Datei webseite.xml (insbesondere die Liste der ausgabe-*.xml-Dateien, die in Form der Entity &ausgaben; angehängt ist), um die (temporäre) Datei ausgaben.xml zu schreiben, in der alle Ausgaben und Artikel zusammengefaßt sind.

destilate-feed.xsl erzeugt den aktuellen Newsfeed im Atom-1.0-Format. See Newsfeeds, um umfassende Informationen dazu zu bekommen.

atom2rss10.xsl wandelt einen Atom-1.0-Feed in einen RSS-1.0-Feed um.

xslt/common

Hier befindet sich Code, der in mehreren XSLT-Dateien eingebunden wird. Das vermeidet Code-Verdoppelung, allerdings ist dieses Verzeichnis noch leer, weil der Code verdoppelt ist.

xslt/zml2html

zml2html.xsl wandelt sowohl Artikel als auch Snippets in Webseiten-fähige XHTML-Dateien um. Es handelt sich also um eine Umwandlung XHTML => XHTML. Dabei greift es auch auf ausgaben.xml und webseite.xml zu, um alle Querverbindungen korrekt zu erzeugen.

Es befinden sich außerdem noch einige Stil-Dateien in diesem Verzeichnis, welche für besondere Artikel-Typen zuständig sind.

xslt/zml2latex

zml2html.xsl wandelt eine ausgabe-nummer.xml-Datei in eine LaTeX-Datei um, die dann mit pdfLaTeX in den PDF umgewandelt werden kann. Das wird aber alles vom Skript zmltopdf.py erledigt.

Es befinden sich außerdem noch einige Stil-Dateien in diesem Verzeichnis, welche für besondere Artikel-Typen zuständig sind.