Betrachten wir zuerst das Zitieren mit jeweiliger textueller Angabe der Quelle über das Attribut @src und der Zählen Nummerierung der zugehörigen Fußnoten.

<Cite src="die Quelle" page="die Seitennummer" footnote="Nummer der Fußnote">

das Zitat

</Cite>

Also sind 'src','page' und 'footnote' optionale Attribute, da sie nicht mit einem Stern * gekennzeichnet sind.

So sieht es dann aus: Dies ist ein Zitat. Dies ist ein Zitat. Dies ist ein Zitat. Dies ist ein Zitat.

Es ist zu beachten, dass die angegebene Nummer der Fußnote für den Modus des Zählens von Fußnoten benutzt wird. Beim automatischen Zählen wird mittels des Zitatkataloges automatisch eine entsprechende Fußnote kreiert, die als Zitatnachweis im Anhang aufgeführt werden kann.

Wenn man in einem Zitat Auslassungen hat, sollte man, anstatt die Punkte im Code zu machen, den CBr-Tag oder CDot verwenden. Oftmals gibt es verschiedene Vorgaben für die Formalien und so ist es besser, einem zentralen angepassten XSL-Stylesheet die Darstellung zu überlassen.

Oftmals sind in Zitaten Hervorhebungen des Autors selbst, und man will aber auch eigene Hervorhebungen machen. Im Augenblick sind die des Autors als <i>kursiv</i> gekennzeichnet und damit nicht sichtbar, da das Zitat selbst in HTML in Gänze kursiv gesetzt ist. Der Tag für das Kursivsetzen ist in HTML der Italic-Tag, daher das 'i'. Eigene Hervorhebungen sollten mit dem Bold-Tag, d. h. <b>Fettschrift</b> gekennzeichnet sein, mit dem Hinweis '[Herv. v. XXX]'.

Das Zitat hat ein weiteres Attribut bekommen @em. Damit wird gesagt, dass im Zitat eigene Hervorhebungen sind. Da dies auch verschiedenen Formalien unterliegt, wurde die Darstellung dieser Angabe auch dem zentralen Stylesheet überlassen.

Den Zitatkatalog kann man einfach als komfortable Aufzählung der zitierten Werke verwenden. Die zweite Möglichkeit ist, pro Zitat oder automatischer Fußnote eine Fußnote in der Reihenfolge wie im Quelltext fortaufend erzeugen zu lassen.

Der Zitatkatalog CiteCatalog enthält die Beschreibung für in Zitaten verwendete Literatur. Pro Werk existiert genau ein CiteCatalogItem, welches ein Abstract enthält, mit der vollständigen Beschreibung. Jeder dieser Einträge enth&auuml;lt notwendigerweise eine im Zitatkatalog eindeutige Zeichenkette als Identifikation und Referenz, das Attribut @cid.

• CiteCatalog
  • CiteCatalogItem cid="Referenzzeichenkette"
    • Abstract author="Nachname" title="Titel" ...
  • ...
  • CiteCatalogItem

Hier nun unser Testkatalog.
<CiteCatalog">

<CiteCatalogItem cid="nudel"">
<Abstract
authorsfirst="First"
author="Name"
title="Der Titel des Werkes"
edition="2.Aufl."
date="1840"
location="Zumbelstadt"
volume="Band 2"
/">
</CiteCatalogItem">

<CiteCatalogItem cid="popo"">
<Abstract
authorsfirst="First"
author="Name"
title="Der Titel des zweiten Werkes"
/">
</CiteCatalogItem">
</CiteCatalog">

Infolge sind ein paar Zitate definiert, mit welchem die Wirkungsweise deutlich gemacht werden soll. Die Zitate benutzen anstatt dem Attribut @src, in welchem die Quelle textuell angegeben wird einen Verweis in den Zitatkatalog, um die Quelle zu bestimmen. Dieses Attribut heißt @cref und korrespondiert dem @cid der ausgewählten Zitatquelle.

<Cite cref="Verweiskürzel" page="Nummer der Seite">

das Zitat

</Cite>

Ein @cref-Eintrag muss im Katalog eindeutig sein. In unserem Falle verwenden wir die Kürzel "nudel" und "popo" als die Einträge.

<Cite cref="nudel" em="P.H." page="5f">
Der Inhalt des Zitates mit Hervorhebung '@em="P.H."' und Seitenangabe '@page="5f"' </Cite>

<Cite cref="popo">
Der Inhalt des Zitates
</Cite>

<Cite cref="nudel">
Der Inhalt des Zitates
<Cite>

Und das sieht nun so aus:

Es gibt also zwei Versionen, wie mit dem Katalog gearbeitet werden kann. Dafür gibt es den Hilfstag CiteCatalogRef, welcher den Ort und die Art der Ausgabe bestimmt.

• CiteCatalogRef style="strict|compact"

Feste Nummerierung ist vorgesehen, wenn man z.B. Originale in XML-Form überträgt und die Nummerierung der Fußnoten beibehalten will. Dann ist man selbst verantwortlich, wo die Fußnoten erscheinen werden. So macht man zuerst einen Link, auch Refernz gennannt, und dann die eigentliche Fußnote, wo man sie hinhaben möchte. Eine Fußnote allgemein hat folgende Form:

<Footnote number="Nummer der Fußnote" class="Klasse der Fußnote" >

der Inhalt

</Footnote>

Eine Fußnote ist keine Endnote, jedenfalls muss sie es nicht sein. D. h., dass man den Inhalt der Fußnote dorthin setzen kann, wo man ihn haben will, und nicht nur an das Ende des HTML-Files. Dazu benötigt man 2 Fußnoten Tags.

1. Referenzfußnote ist ein Tag zum Festlegen der Verlinkungsstelle. Hier muss die 'class' nicht angegeben werden, sie ist automatisch 'class="ref"', welches bedeutet, dass dieser Fußnoten Tag nur die Referenz auf den eigentlichen Inhalt darstellt. Der Inhalt dieses Tags kann das letzte Wort des mit der Fußnote versehenden Textes sein.
2. Inhaltsfußnote Der Tag zum Darstellen des Inhaltes der Fußnote selbst. Dieser Tag hat die 'class="noref"' und er umschließt den darzustellenden Inhalt.

Die Nummer der Fußnote sollte fest gegeben werden, oder man verlässt sich auf eine interne Zählung. Beide Zählungen sollten sich nicht überschneiden. Intern gezählten wird ein Unterstrich nachgestellt.

Wird keine Klasse angegeben, dann ist die Fußnote automatisch ein Verweis und das ist gleichbedeutend mit der Angabe @class="ref". Soll hingegen der Inhalt der Fußnote beschrieben werden, so hat der Tag die Angabe @class="noref".

Die Referenzfußnote selbst muss keinen Inhalt haben, man kann sie all einen einzigen Tag in verkürzter Form darstellen.

Dies ist die Referenzfußnote mit fester Nummerierung

<Footnote number="255">
Das Ende dieses Texte wird mit der Fußnotenreferenz versehen.
<Footnote>.
Und nun eine mit automatischer Nummerierung.

Hier habe wir einen Text mit einem einfachen Fußnotentag als Referenz. <Footnote class="ref" number="88" /> Das heißt, eine Referenzfußnote muss selbst nicht noch Text als Tag mit öffnendem und schließendem Tag einfasse.

Dies ist die 2. oder eigentliche Fußnote.

<Footnote number="255" class="noref">
Das ist nun der Inhalt oder Text der Fußnote selbst.
<Footnote>

Aber natürlich kann man die Fußnoten auch gerne im Pagefoot Tag sammeln am Ende einer Seite.

Bei dieser Art der Fußnoten erspart man sich das Nummerieren und umständliche Auseinanderziehen der Fußnote in zwei separable Tags. Wir brauchen also nur einen Tag pro Fußnote, welcher durch die 'class="auto"' gekennzeichnet ist.

<Footnote class="auto" >

der Inhalt

</Footnote>

Aber die Fußnoten werden gesammelt am Ende des Dokumentes, bzw. wo CiteCatalogRef mit @style="strict", in der vorkommenden Reihenfolge dargestellt und an dieser Stelle ihr Inhalt mit der fortlaufenden Nummer indiziert.

Weiterer Vorteil ist, diese Nummerierung fügt sich in die der Zitate ein, welche auf den Zitatkatalog verweisen, falls es solche gibt. D. h. dort, wo der Tag CiteCatalogRef im Seitenquelltext steht, das sollte das Ende des Dokumentes sein, dort werden auch die automatischen Fußnoten dargestellt.

Manchmal gibt es geschachtelte Abstract. Weshalb der 2. Abstract-Tag? Wenn man als Typ 'excerpt' einträgt, so geht der Prozessor davon aus, dass es einen zweiten Abstract-Tag gibt. Im ersten Abstract stehen die Daten vom Exzerpt selbst, d. h. sein eigener Titel usw.

Im inneren Abstract, dem 2. stehen dagegen die Daten des Originalfiles, sein Titel und Autor usw. Man hat in den seltensten Fällen das Original selbst in unserer XML-Form, wo soll man sonst die Daten über das Original herbekommen. Liegt das doch mal in unserer Form vor und hat somit einen eigenen Abstract, dann wird der Prozessor mit einem Schalter bei seinem Aufruf darauf aufmerksam gemacht und er holt sich die Daten dann aus dem Originalfile selbst.

Die Originalfiledaten verwende ich übrigens auch für die Anzeige in der Übersicht-HTML-Seite, der so genannten Indexseite.
<Abstract ...>
Daten für das Exzerpt

<Abstract ...> Daten des Originals </Abstract>

Der andere Typ ist im Moment 'original', wobei nur ein Abstract erwartet wird. Wenn ihr kein 'type' Attribut im Abstract angebt, wird automatisch davon ausgegangen, dass ihr 'original' gewählt habt.

Diese File hat folgenden alleinigen Abstract, da es ein Original ist:

<Abstract

authorsfirst="Peter"
author="Heilbronn"
title="Beschreibung des internen XML-Formates"
description="Dieses Dokument beschreibt die grundlegenden Tags unseres internen Exzerpt-Formates um eigene Dateien einbinden zu können."
date="07/2003"

Eine Beschreibung ist grundsätzlich im Abstract untergebracht. Falls eine Beschreibung zu einem Dokument gegeben werden soll, die länger ist und strukturiert ist, z.B. mit Listen, fügt man diese als Fließtext mit eigenen Paragraphen ein.
<Abstract
title="Das Lalala"
author="Originalautorname"
authorsfirst="Originalautorvorname"
>
<P>

Hier kommt die Beschreibung hin.

Sie kann auch aus mehreren P und Cite-Tags bestehen.

Die Kurzbeschreibung ist der eigentliche Abstract, wie er bei Fachveröffentlichungen als Begriff verwendet wird. Sie wird im Dokument selbst als Section allem anderen vorangestellt und statisch als Section/@title="Kurzbeschreibung" gekennzeichnet.

Diese Beschreibung ist übrigens dass, was in den Indexfiles, d. h. den Übersichtsseiten, als Informationstext zum Link erscheint und in der Sitemap mit einer Klappbox versehen angesehen werden kann.

Der Text in Abstract/@description ist als Kurzbeschreibung gedacht, die ohne Schnörkel in den Indexseiten dargestellt wird. Sie wird als Text in der Sitemap einfach so dargestellt, _ohne_ Klappbox. D. h., wenn er eingetragen wird, dann bitte sehr kurz.

Die einzigen bisher erstellten Sichten sind also Exzerpt, Konspekt und Struktur. Eine Sicht bedeutet technisch, dass die gleiche Datei mit einem anderen Stylesheet übersetzt wird und dabei eine andere Datei, eine andere Sicht auf die selbe Quelldatei erzeugt.

Üersetzt man ein Exzerpt-XML-File, also eines, welches mit der notice.dtd konform geht, mit dem excerpt.structure.xsl Stylesheet. Dann werden nur die für die Struktur wichtigen Tags wie z.B. 'CommentHead' dargestellt. Es entsteht ein Strukturfile als HTML-Repräsentant.

Übersetzt man das gleiche File mit dem Konspekt-Stylesheet conspectus.xsl, so wird eine neue Datei erzeugt, in welcher nur die Bestandteile angezeigt werden, welche im Konspekt-Tag stehen.

<Conspectus style="exclusive|inclusive">

</Conspectus>

Ein Konspekt ist eine inhaltliche Zusammenfassung eines Textes gegenüber einem Exzerpt, welches quasi eine zitatorientierte Zusammenfassung ist und auch meist viel umfänglicher als ein Konspekt daherkommt. Man sollte sich also kurz fassen.

Ein Konspekt kann eine andere Datei als das Exzerpt sein, muss es aber nicht. Das Wichtige ist, dass man alles, was im Konspekt erscheinen soll, im Konspekt-Tag einschließt.

Dieser Tag sollte innerhalb von Abschnitten oder Unterabschnitten stehen, diese nicht umfassen. Ansonsten kann man innerhalb des <Conspectus> Tags alle anderen Tags außer Section, Subsection und Fußnoten verwenden.

Also kann man den Konspekt auch aus dem Exzerpt-file generieren. Dabei wird die gleiche Kapitel- oder Abschnittseinteilung genommen wie beim Exzerpt und es gibt automatisch eine Verlinkung zwischen den Überschriften mit den kleinen '>>E' oder '>>K' gekennzeichnet. Alles, was in der Exzerptdatei innerhalb von Konspekt-Tags steht, wird in den Konspekt übernommen und erscheint im Allgemeinen nicht im umgesetzten Exzerpthypertextfile. Also werden zwei separate HTML-Dateien erstellt, eines für das Exzerpt und eines für den Konspekt.

Das 'style' Attribute sagt nun, ob der Inhalt des Konspekt-Tags ausschließlich 'style="exclusive"' nur im Konspektfile dargestellt werden soll, oder, ob er ebenso im Exzerptfile zu sehen sein soll. Dies betrifft natürlich z.B. auch ein zugehöriges Strukturfile. Das 'style' Attribut macht natürlich nur Sinn, wenn der Konspekt als innere Datei, also als Tag-Folge innerhalb des Exzerptfiles definiert wird.

Hier nun ein live Beispiel von einem Exzerpt, welches als innere Dokumente einen Konspekt und eine Struktur definiert hat. Dazu gibt es noch mehrere Originalfiles, welche in HTML-Form vorliegen und also nur kopiert werden. Der folgende Abschnitt befindet sich im entsprechenden Indexfile, welches auf unser Dokument als Übersichtsseite verweist (dazu später mehr).

<IndexItem src="mxks/excerpt/peter2Postone.ZeitArbeitUndGesellHerr.xml"

dest="files/other/peter2Postone.ZeitArbeitUndGesellHerr.html"
base="../.."
stylesheet="excerpt/excerpt.xsl"
origsrc="mxks/excerpt/orig/Postone.vorwort.htm"
origdest="files/other/Postone.vorwort.htm"
style="actual"

<DocInfo name="structure"

src="mxks/excerpt/peter2Postone.ZeitArbeitUndGesellHerr.xml"
dest="files/other/peter2Postone.ZeitArbeitUndGesellHerr.structure.html"
base="../.."
stylesheet="structure/excerpt.structure.xsl"
buildmode="build"

/>
<DocInfo name="conspectus"

src="mxks/excerpt/peter2Postone.ZeitArbeitUndGesellHerr.xml"
dest="files/other/peter2Postone.ZeitArbeitUndGesellHerr.conspectus.html"
base="../.."
stylesheet="conspectus/excerpt.conspectus.xsl"
buildmode="build"

/>
<DocInfo name="original"

src="mxks/excerpt/orig/Postone.kap8.htm"
dest="files/other/Postone.kap8.htm"
base="../.."
buildmode="copy"

/>
<DocInfo name="original1"

src="mxks/excerpt/orig/Postone.prol.htm"
dest="files/other/Postone.prol.htm"
base="../.."
buildmode="copy"

/>

Einem Exzerpt kann über den IndexItem-Tag auch ein Originalfile zugeordnet werden. Ein Original ist immer eine eigene Datei, nicht wie der Konspekt. Ist dies ein Fremdformat, so wird es nur kopiert (IndexItem/@origbuildmode="nobuild"). Ist es hingegen in unserem XML-Format, so kann es mit IndexItem/@origbuildmode="build" übersetzt werden. Mit dem Schalter IndexItem/@origlinkmode="on" wird es automatisch mit Exzerpt oder Konspekt über die Überschriften intern verlinkt. Ansonsten erreicht man dieses File nur über den Link im Dokumentenkopf des Exzerpts oder Konspekts.

Alle XML-Dokumente haben einen Wurzel-Tag, das heißt, dass dieses der äußerste Tag ist, der alle anderen enthält. Er sagt an, welcher Art das Dokument ist. Richtigerweise passiert dies technisch gesehen in der 'DOCTYPE'-Anweisung, sei hier aber nicht weiter beachtet. Hier nun die echte DocTypeDefinition (DTD),die XML-Formatbeschreibung.

Im wesentlichen gibt es im Moment nur die Typen 'Excerpt' und 'Notice'. Dieses Dokument ist eine Notiz. Der Typ eines Dokumentes bestimmt, wie der Inhalt dargestellt wird, z.B. den Kopf. Die eigentliche Darstellung von der technischen Seite her wird mit XSL-Stylesheets generiert, worauf ich aber hier auch nicht weiter eingehen will.

Der am meisten verwendete Dokumenttyp ist das Exzerpt. So ist in unserem Beispiel dies auch der Wurzel-Tag.

<Excerpt >


<Section title*="Titel des Kapitels" index="feste Nummerierung" >

</Section>

<Section title*="Titel des Kapitels" index="feste Nummerierung" >

der Inhalt

</Section>


</Excerpt>

Normalerweise geschieht die Nummerierung automatisch mit arabischen Zahlen. Will man aber eine besondere angeben, dann benutzt man bei 'Section' und 'Subsection' das 'index'-Attribut, z.B. @index="a.)". Es gibt auch die Möglichk einen Anfangswert zu setzen, mit dem 'count'-Attribut.

Hier der notwendige "Trick": <Subsection title="III" index=""> so ist _kein_ Titel und nur die Nummerierung definiert. Da nur @title ein Link wird und @index="" die automatische Nummerierung verhindert.

<Subsection title="Herder" index="III">, falls ein Titel gegeben ist und eine feste Numerierung, also ganz normal angeben.

Eine Navigationsgruppe entspricht einer Horizontalen, einer Ebene von gleichrangigen Items, also Dokumenten, die von hier aus direkt zu erreichen sind. Diese Dokumente sind also in dieser Ebene gruppiert.

Es bekommt jede Ebene eine sie repräsentierende Hauptseite 'backlink' und einen Namen 'name' zugeordnet. Die NavGroup einer eine Ebene repräsentierenden Seite enthält ihrerseits wieder NavItems. Sie enthält ebenso Farbangaben für 'active' und 'inactive', in welcher ihr Label in den Navigationsleisten darzustellen ist.

NavGroups kann man natürlich ineinander schachteln, woraus sich eine im Navigationsfile beschriebene Baumstruktur der ganzen Website ergibt.

Es gibt genau eine oberste Gruppe, welche alle anderen und alle Items enthalten muss. Diese trägt den Namen 'firstlevel'.

Da der @name zur Identifikation dient und z.B. keine Umlaute enthalten darf, gibt es ein weiteres Attribut @label. Dieses Label wird in der grafischen Darstellung benutzt, wenn es existiert. Sonst wird der Name angezeigt.

Ein Navigationsitem ist im Wesentlichen eine Webseite, die mit anderen in einer Navigationsgruppe zusammengefasst ist und über diese Gruppe verlinkt wird. Ein solches Item kann selbst wieder eine Gruppe enthalten und somit Zugang zu einer neuen Ebene/Gruppe sein.

Ein NavItem enthält einen Namen 'title' eine Quelldatei 'src' einen Stylesheet 'stylesheet', eine Zieldatei 'link', in welches sie mit dem Stylesheet umgewandelt wird und letztens eine dazu passende Pfadangabe zur Wurzeldatei der gesamten Site namens 'base'.

Es existieren 3 Arten von durch XML-files repräsentierte Seitentypen. Es gibt Seiten,

• die nur für sich stehen, Einzelseiten, wie z.B. die 'Termine'. Von den Einzelseiten gibt es solche, die nur Daten enthalten und solche,
• welche Index-Files genannt werden. Diese enthalten eine komplexe Struktur von Unterseiten.
• Die dritte Art sind die Seiten, die eine ganze Ebene repräsentieren, wie z.B. 'Texte'. Sie sind die Eröffnungsseiten einer neuen NavGroup.

Wie bei den IndexItem kann man entsprechende DocInfo-Tags verschachteln. Das ermöglicht, für die Indexseiten noch z.B. Bilder oder andere abhängige Daten mit DocInfo/@mode='dircopy' zu kopieren.

Eine Navigationsgruppe umfasst also eine Ebene, der ein XML-File als Hauptseite zugeordnet ist. Das Übersetzen der grundsätzlichen Ebenen muss im Moment noch per Hand in einem Build-File beschrieben werden. Das sind z.B. alle Elemente aus der ersten Ebene. Alle weiteren unteren Ebenen werden automatisch übersetzt, sobald die entsprechende obere Ebene übersetzt wird.

So ruft z.B. ant main.build zum Übersetzen der obersten Ebene auf. 'main.build' ist dabei der Name eines target im Haupt-Build-File 'build.xml' des Tools 'ant'. Von diesem target aus wird mittels 'navbar2build.xsl' ein temporäres Build-File erstellt und aufgerufen. Diese enthält die Informationen zum rekursiven Erstellen der gesamten Unterseiten.

Der Aufruf erfolgt mit dem Namen der entsprechenden NavGroup/@name, in unserem Falle 'firstlevel', um die zu übersetzende Ebene zu kennzeichnen. Aus den untergeordneten NavGroups bzw. NavItems wird dann das Build-File zum Erstellen eben dieser gebaut.

Eine Indexguppe fast mehrere Indexitems zu einer

• Exzerpt
• Konspekt
• Struktur
• Originalfile
• ...
• Bilder und sonstiges

Die IndexItems stellen den informativen Kernbestand dar. Sie enthalten eine Fülle von Informationen. Wohl die wichtigsten sind die Quelldatei 'src', der Ort 'dest' oder die Datei, an welchem sie kopiert oder in welche sie mit Hilfe des 'stylesheet' übersetzt werden soll. Der 'buildmode="build"' gibt z.B. an, ob eine Datei übersetzt werden soll. Meist sind die Files Exzerpte.

Ist das Originalfile selbst ein XML-File unseres von unserem Doctype, dann kann man nicht nur mit 'origbuildmode="build"' das automatische übersetzen dieses Files anstoßen, sondern mit 'origlinkmode="on"' veranlassen, dass die entsprechenden Kapitel und Unterkapitel zwischen Exzerpt und Originaldatei verlinkt werden können. (Dazu müssen sie natürlich übereinstimmen.)

• IndexItem style="actual|main|normal"
• Abstract
• DocInfo buildmode="build|nobuild|copy|dircopy|dirpack" name="conspect|structure|label|thumb|package"
• ...
• IndexItem
• ...

Ein IndexItem kann endlich viele DocInfo-Tags enthalten. Diese Struktur ermöglicht verschiedenste Zusatzsichten und Dateien zu einem Exzerpt zu erstellen. Die wesentlichen Attribute sind 'name' und 'buildmode'.

An Hand des Attributes DocInfo/@name wird entschieden, wie der DocInfo-Tag in der Verlinkung zu interpretieren ist, um welche Art von Informationen es sich im Dokument, bzw. inneren Dokukment, handelt.

Attributwert	Interpretation
conspect	Die beschriebene Datei wird als Konspekt interprätiert, ist meist ein inneres Dokument, es wird prozessiert und bei der Verlinkung mit dem Exzerpt berücksichtigt.
structure	Es handelt sich um ein Strukturfile, es gilt das Gleiche, wie für den Konspekt.
criticism	Dieses File wird als Kritik zum Hauptdokument verlinkt (und erstellt).
label	Dies kennzeichnet ein Bild, welches dem Verweis auf das Hauptfile auf der Indexseite vorangestellt wird.
thumb	Existiert nur mit einem Label und wird anstatt diesem angezeigt, wenn das Label selbst zu umfangreich ist. Beim Klicken auf das 'thumb'-Bildchen, wird das meist einfach nur größere Label im Browser angezeigt, z.B. ein Übersichtsdiagramm.
package	Dieses File beinhaltet Zusatzinformationen und wird z.B. im Exzerptfile als 'Info' im Kopfbereicht verlinkt.
sonstiges	Wird nicht interpretiert, entscheidet sich also nur an Hand des 'buildmode'.

Das Attribut DocInfo/@buildmode wird vom XSL-Prozessor bezüglich der Übersetzung ausgewertet. Dabei kann z.B. eine Übersetzung mit einem Stylesheet erfolgen oder aber ein einfaches Kopieren, etc.

Attributwert	Interpretation
build	Das durch 'src' gekennzeichnete File wird mittels 'stylesheet' nach 'dest' übersetzt, z.B. Exzerpte.
copy	Das File wird einfach kopiert und umbenannt. Dies wird meist bei Originalfiles oder Präsentationen der Fall sein.
dircopy	In diesem Fall ist 'src' ein Ordner und der gesamte Ordnerinhalt wird an die entsprechende Stelle 'dest' kopiert. Das wird oft für das Kopieren von Ordnern mit benötigten Bildern benutzt.
dirpack	Der Ordnerinhalt von 'src' wird als zip-file nach 'dest' gepackt. Meist findet dies bei Zusatzinformationen Anwendung.
nobuild	Hat weiter keine Bedeutung, außer , dass dieses File nicht prozessiert wird.

Das Wichtigste also ist, dass ein DocInfo einen Namen 'name' und einen 'stylesheet' enthält. An Hand des Stylesheets wird das Quellfile 'src' in das Zielfile 'dest' übersetzt, sofern 'buildmode="build"' eingestellt ist. Ist der Name z.B. 'conspect', dann wird dieses File als Konspekt zum übergeordneten Exzerptfile behandelt und entsprechend verlinkt und angezeigt.

Ein weiterer bekannter Name ist 'structure', mit welchem ein so gennantes Strukturfile angelegt und mit dem Exzerpt verlinkt wird. In diesem werden z.B. die CommentHeads und andere Tags die die Struktur beschreiben angezeigt.

Zwei weitere DocInfos gehören zusammen und betreffen Bilder. Wenn '@name="label"' gesetzt ist, so wird das entsprechende File als Bilddatei vor dem Schriftzug verlinkt und in verkleinerter Form auf der Indexseite selbst angezeigt. Ist die Bilddatei zu groß, so benutzt man für die Indexseite eine verkleinerte separate Bilddatei, welche dann angezeigt wird. Der entsprechende Name ist dann 'thumb'. Beide Tag-Formen sollten den 'buildmode="copy"' besitzen, da sonst die entsprechenden Bilddateien nicht in den Zieldateibaum kopiert werden.

Mit dem 'buildmode="dircopy"' veranlasst man den Prozessor dazu, den Ordner 'src' nach 'dest' zu kopieren, um z.B. eine Vielzahl von zu einem File gehörige Bilddateien zu kopieren.

Mit dem 'style'-Attribut lassen sich verschiedene Darstellungen des entsprechenden IndexItems auf der Indexseite realisieren. Normale Items haben das Attribut IndexItem/@style nicht gesetzt, bzw. haben den Default-Wert "normal" aus der DTD. D. h., wir haben einen dünnen grauen Rahmen um das Item gezeichnet. Man kann dieses Attribut aber auch auf folgende Werte setzen:

Attributwert	Interpretation
normal	Ist der default Wert und macht nichts besonderes.
actual	Bedeutet, dass das Item als in Bearbeitung markiert wird. Im Augenblick ist dies ein roter Rahmen und der Schriftzug "in Bearbeitung".
main	"main" zeigt an, dass in der entsprechenden IndexGroup dieses Item einen Hauptbestandteil ist. Diese Kennzeichnung ist einfach ein fetterer und schwarzer Rahmen.

Es ist ein weiterer Spezialfall der Darstellung hinzugekommen. IndexItems sollen nicht nur in Gruppen zusammengefasst dargestellt werden, sondern desgleichen in Spalten gruppiert nach Kategorien. Dafür ist eine neue Struktur eingeführt worden.

Eine IndexGroup wird als tabellarisch wie folgt gekennzeichnet IndexGroup/@type='multicolumn'. Welche Spalten es gibt wird im Tag IndexGroup/IndexGroupColumns beschrieben. Jede Spalte IndexGroup/IndexGroupColumns/IndexGroupColumn erhält einen 'title' der im Tabellenkopf erscheint und eine 'category' als Schlüssel zum Finden der entsprechenden Einträge. Ein 'style' Attribut mit einem generischen HTML-Style ist optional.

• IndexGroup: type='multicolumn', id="XXX" (die Hauptgruppe)
• • IndexGroupColumns
  • • IndexGroupColumn: title, category="AAA", style
    • IndexGroupColumn: title, category="BBB", style
    • ...
• IndexGroup: id="Zeile1" (eine Zeile ist eine Zeilengruppe)
  • IndexItem: category="BBB"
  • IndexItem: category="BBB"
  • IndexItem: category="AAA"
  • ...
• IndexGroup: id="Zeile2"
  • IndexItem: category="BBB"
  • IndexItem: category="BBB"
  • IndexItem: category="AAA"
  • ...
• ...

Es gibt den Fall, dass externe Indexgruppen, also solche auf anderen Seiten als der aktuellen Indexseite, auf der aktuellen Indexseite sichtbar gemacht werden sollen. Dann kann in der aktuellen Indexseite über den Tag IndexGroupRef einen Verweis auf diese externe Gruppe machen.

Dieser Tag stellt also einen Verweis auf eine Gruppe in einem anderen Indexfile dar. Er besitzt nur wenige Attribute.

src	Hier kann man direkt den Pfad zum externen Indexfile angeben, aus welchem die Gruppe genommen werden soll.
navitem	Der Pfad wird nicht aus @src genommen, sondern NavItem[@title=$navitem]/@src. Wir holen ihn also indirekt über das Hauptnavigationsfile.
title	Gibt IndexGroup/@title an, durch welchen die externe Gruppe identifiziert wird.
mode	Gibt den Modus an, nach welchem mit der Gruppe verfahren werden soll.

Wenn der Modus gleich 'merge' ist, dann wird einfach der Inhalt der externen Gruppe in den Inhalt der Gruppe übernommen, in welcher die Referenz steht.

Haben wir hingegen den Modus 'copy', dann wird die externe Gruppe dargestellt, als wenn sie eine normale Gruppe der auf sie verweisenden Indexseite wäre.

Analog der Referenz für Indexgruppen gibt es eine Referenz für die einzelnen Items. Diese externen Items werden aus der externen Indexseite genommen und auf der auf sie verweisenden Indexseite dargestellt.

src	Dies ist der Pfad, der zur Identifikation des Items benutzt wird. Er entspricht IndexItem/@src oder IndexItem/@origsrc.
navitem	Der Pfad zur externen Indexseite ist NavItem[@title=$navitem]/@src. Wir holen ihn also indirekt über das Hauptnavigationsfile.

Hier befinden sich alle Stylesheets, die zumeist seitenbezogene HTML-Tags erzeugen.

• htmlhead, erzeugt mit Hilfe des Abstract-Tags des Quellfiles den Abschnitt <head>...</head> mit den entsprechenden 'META'-Tags und dem 'title' des resultierenden HTML-Files.
• htmlfoot, es werden hiermit am Ende des HTML-Files innerhalb des 'html/body' Zusatzinformationen wie z.B. das letzte Compilierdatum erzeugt.

An dieser Stelle befinden sich sehr verschiedenartige Stylesheets, die aber alle etwas mit dem Strukturfile zu tun haben, z.B. dem zentralen Naviagationsmenu.

• navbar, dieser zentrale Stylesheet erzeugt das entsprechende Navigationsmenu am Anfang jeder Seite (HTML-File), welche direkt über die Navigation zu erreichen ist. Das betrifft alle Indexseiten, wie auch manche reine Datenseite.
• navbar2build kreiert zu einer als Parameter gegebenen NavGroup im Strukturfile ein ANT-Build-File, mit welchem alle zu dieser Navigationsgruppe oder Ebene gehörenden Zieldateien gebaut oder kopiert werden.
• navber2sidemap kompiliert die als 'sitemap' bezeichnete Gesamtübersicht aus dem Navigationsfile und den Informationen aus den Abstracts der entsprechenden XML-Quelldateien.
• navber2sidetree kompiliert die als 'sitemap' bezeichnete Gesamtübersicht aus dem Strukturfile und den Informationen aus dem gesamten Spektrum an vorhandenen Files und erzeugt einen vollständigen Baum der vorhandenen Datenstruktur der gesamten Website.
• treeview.head.xsl kapselt die für den /html/head-Tag bestimmten javascript-Abschnitte für die Baumdarstellung der Sitemap.
• treeview.abstract.xsl kapselt die Darstellung eines einzelnen Files als Blatt oder Knoten in der Baumdarstellung der Sitemap.

Bisher gibt es nur einen css erzeugenden Stylesheet:

• maincss.xsl, bildet dateiweite CSS zur HTML-Darstellung, z.B. dass bei Browseransicht andere Schriftarten als beim Ausdruck zur Anwendung kommen.

Dieser Unterordner enthält sowohl Prozessierungs- als auch Ansichtsstylesheets für Indexfiles.

• index.xsl, erzeugt die eigentliche HTML-Repräsentation der Indexseite.
• index2index.xsl, bildet eine temporäre XML-Indexseite, welche alle externen Referenzen und Informationen enthält.
• index2build.xsl, kompiliert eine XML-Indexseite zu einem ANT-Build-File, um alle entsprechenden Unterseiten und noch notwendigen Build-Files erzeugen zu können.

Dieser Unterordner enthält sowohl Prozessierungsstyles für Exzerpte.

• excerpt.xsl, erzeugt die eigentliche HTML-Repräsentation des Exzerpts.
• excerpt.head.xsl, erzeugt die Kopfsektion des Exzerpts mit allen wichtigen Informationen von und um dieses Dokument.
• excerpt.head.linklist.xsl, kompiliert eine Tabellenzeile des Kopfes, in welchem alle Links auf Dokumente platziert sind, die mit diesem Dokument in Verbindung stehen (siehe DocInfo).
• excerpt.content.items.xsl, stellt die eigentlichen Tags, z.B. P..., des Exzerptes bzw. verwandter Formen, wie Konspekt, dar. Hier wird somit der textuelle Inhalt und sein Aussehen selbst erzeugt.
• excerpt.browser.xsl, dieser spezielle Stylesheet ist für die Darstellung mittels Browser gedacht und befindet sich im XML-Paket. Hiermit ist es möglich, sich eigene XML-Files nach unserer DTD anzusehen, ohne den Prozessierungsmechanismus installieren zu müssen.

Bei den Nicht-Indexseiten gibt es solche,

• die direkt über die Navigation erreicht werden können und
• solche, die über eine Indexseite zu erreichen sind.

Als Beispiel hierfür sei ein Exzerpt genommen, welche mit dem Stylesheet 'excerpt/excerpt.xsl' übersetzt wird.

• excerpt/excerpt.xsl ist der Hauptstylesheet, der alle untergeordneten aufruft.
• • html/htmlhead.xsl, der Kopfbereich der HTML-Seite.
  • excerpt/excerpt.head.xsl, der Kopfbereich des Exzerptes
    • excerpt/excerpt.head.linklist.xsl, Linkbereich im Kopf
  • excerpt/excerpt.contentitems.xsl, erzeugt den eigentlichen Inhalt der Seite selbst, z.B. den HTML-Code der Tags Cite oder P.
  • html/htmlfoot.xsl, die obligatorischen Zusatzinformationen.