vishia - Das Format XhtmlPre

Ein XSchema für das XhtmlPre-Format ist zwar versprochen, im Moment aber noch nicht vorhanden (TODO). Am XSchema kann man genau sehen, welche XHTML-Bestandteile unterstützt werden. Im Moment gibt es nur zwei Konvertierungen aus dem XhtmlPre heraus: XmlDocu_xsl/Pre2Xhtml.xsl und XmlDocu_xsl/Pre2Word.xsl. Beide Scripts sind parallel gepflegt. Alles was diese Scripts ins Zielformat konvertieren, ist quasi im XhtmlPre als gültig definiert. Für eine ordentliche Arbeit gehört es sich aber, das zuerst ein XSchema vorhanden ist, das verbindlich gilt dafür, was die Konvertierungsroutinen zu leisten haben. Da es aber auch ohne geht, ist das also ein wichiges TODO aber nice to have.

<pre:Chapters>

Das ist das Top-Element des XhtmlPre-Formates.

Attribute:

• title= Das ist der Titel des Dokumentes. In der HTML-Ausgabe soll er im head-Bereich als title erscheinen (Kopfzeile im Browser).

Elemente:

• <pre:chapter> Kapitel des Dokumentes.

Etwas anderes ist als Inhalt derzeit nicht vorhanden. Auf der obersten Ebene können aber weitere Eigenschaften des gesamten Dokumentes aufgeführt sein wie Autor, Dokumentennummer, Datum und ähnliches.

<pre:chapter>

Das ist ein Kapitel.

Attribute:

• id= Eindeutiger Identifikator. Diese Zeichenkette kann als Anker für Hyperlinks verwendet werden. In HTML wird er entweder nach <a name=...> vor den Kapiteltitel gesetzt (klassisch) oder ebenfalls als id zum <h.. id=...> hinzugesetzt.

• chapternr= Dieses Attribut wird während der Nachverarbeitung nach der eigentlichen XSL-Transformation des Inhaltes mit CorrectHref erzeugt und enthält die Kapitel-Durchnumerierung im klassischen Stil. Das Attribut wird intern benötigt für die numerierte Benennung von Kapiteltiteln für automatisch erzeugte Rückwärtsverweise und Register. Es bleibt zu Kontrollzwecken hier stehen und kann auch für die Kapitelnummernangabe im HTML verwendet werden.

Elemente, als Sequenz

• <pre:title> muss als erstes angegeben werden. Der Titel des Kapitels steht innerhalb des Elementes als text(). Er darf aber keine weiteren Auszeichnungen haben wie etwa kursive oder fette Bestandteile im Titel. Das ist nicht vorgesehen weil es meist auch nicht gut wirkt. Ein Kapiteltitel soll klar und einfach gesetzt sein. Es ist aber denkbar, dass man hier doch erweitern will und innerhalb des Titel XHTML-inzeilige Formatierungen vorsehen will.

• <pre:TestOutput> Es ist möglich, pro Kapitel einen Testoutput anzugeben, der im Enddokument meist nicht dargestellt werden soll. Das kann die Quelle der Konvertierung sein, oder auch Text-Style-Angaben.

• <xhtml:body> Falls ein Kapiteltext erscheinen soll, muss er in dieser Reihenfolge angegeben werden.

• <pre:chapter> Unterkapitel innerhalb dieses Kapitels.

<xhtml:body>

Alle textuellen Bestandteile werden jeweils als ein solches Element angegeben. Innerhalb des <xhtml:body> dürfen wie folgend angegeben XHTML-Blockelemente stehen. Bei allen Elementen ist das Attribut id= und class= zulässig. id= ist ein Anker für Querverweise, class= dient hier ausschließlich der Bestimmung der indirekten Formatierung. Der Attributwert ist der Name einer Formatvorlage (Word) bzw. eines CSS-Styleelements.

• <xhtml:p> Ein Absatz. Der Absatz enthält die inzeiligen XHTML-Elemente.

• <xhtml:ul> Eine einfache Liste. Enthält Elemente <xhtml:li>, siehe gesonderte Erläuterung.

• <xhtml:ol> Eine numerierte Liste. Enthält Elemente <xhtml:li>, siehe gesonderte Erläuterung.

• <xhtml:dl> Eine Definitionsliste. Innerhalb sind zulässig in gegebener Reihenfolge:

  • <xhtml:dt> Definitionstext. Dieser enthält einen inzeiligen Inhalt.

  • <xhtml:dd> Definitionsdaten. Diese können alles enthalten, was auch innerhalb <xhtml:body> zulässig sind, Blockelemente.

• <xhtml:table> Eine Tabelle, siehe gesonderte Erläuterung.

TODO... erläuterung table, li, weitere Elemente.