= Regeln zum Erstellen eines Inhaltsverzeichnisses = Im folgenden werden Regeln beschrieben, wie aus einem XML-Text ein Inhaltsverzeichnis ("TOC") erstellt werden soll. Dabei wird vorausgesetzt, dass der Text gültig ist nach dem MPDL-Schema. Der Text hat eine logische Struktur, die mit
markiert wird. Aus diesen
wird das TOC erstellt. Wenn der Text keine
enthält, kann auch kein TOC erzeugt werden. == Liste der div-Typen == Die Liste basiert auf den div-Typen in Benedetti, der hier als Modelltext fungiert. Außerdem enthält sie die Typen volume, index, multiflow, parallel. Die Liste kann jederzeit erweitert werden. Zu jedem div-Type ist angegeben, ob und wie es im TOC erscheinen soll. Ein Stern * bedeutet, dass der div-Typ selbst gedruckt werden sollte. Beispiel:
sollte im TOC als "Volume" erscheinen (mit großem "V"). 1. volume * Text: * * CSS: fett, Leerzeile vorher * Numerierung: die Volumes haben eine getrennte Numerierung. Verwende das Attribut @n. * Untereinträge werden eingerückt: nein 2. front, body, back * Text: * * CSS: fett, Leerzeilen vorher und nachher * Numerierung: keine * Untereinträge werden eingerückt: nein 3. toc, cover, title, errata * Text: * * CSS: normal * Numerierung: keine * Untereinträge werden eingerückt: ja 4. dedication, preface, index, appendix * Text: *, und zusätzlich alle , falls es welche gibt; return nach jeder head-Gruppe (siehe Erläuterung 1) * CSS: normal * Numerierung: keine * Untereinträge werden eingerückt: ja 5. chapter, section, math:* (zum Beispiel math:theorem), letter * Text: alle ; return nach jeder head-Gruppe. Sonst "[no heading]" * CSS: normal * Numerierung: getrennte Numerierung für diese Gruppe, in der heutzutage üblichen Form: 5, 5.1, 5.1.3 etc. (jeweils ohne Punkt am Ende) * Untereinträge werden eingerückt: ja 6. multiflow, parallel, float, sowie unbekannte div-Typen und deren Untereinträge * (kommen nicht in das TOC) == Erläuterungen == 1. Unmittelbar aufeinanderfolgende bilden eine "head-Gruppe". (Einzelne sind eine head-Gruppe für sich. Zusätzliche head-Gruppen in einem
entstehen durch die editorische Entscheidung, direkt vor der head-Gruppe kein
einzuführen.) Jede head-Gruppe sollte ihren eigenen link haben. Beispiel: {{{
Motum rectum ... per ſe quicquid Ariſtoteli uiſum ſit. CAP. XXV.

...

ALITER IDEM. ... }}} wird zu {{{ 4.25 Motum rectum ... per ſe quicquid Ariſtoteli uiſum ſit. CAP. XXV. Page: 196 ALITER IDEM. Page: 197 }}} Anderes Beispiel: {{{ 2.11 CAP. XI. Page: 143 ALITER IDEM. Page: 144 2.12 JACOBO ... MEDIOLANENSI Serenißimi Ducis ... peritißimo. CAP. VII. Page: 145 }}} Beachte, dass wieder in kursiv umgesetzt wird. Die zusätzlichen head-Gruppen sollten, falls möglich, bündig mit der ersten head-Gruppe sein. 2. Ein Beispiel für ein
ohne ist: {{{
DE MOTV MOLAE ... Illust. Ioanni Paulo ... ...
De rèuolutione rota putealis ... AD EVNDEM. ...
De machina ... AD EVNDEM. ...
}}} Im TOC: {{{ 6.14 [no heading] 6.14.1 DE MOTV MOLAE ... Illust. Ioanni Paulo ... Page: 297 6.14.2 De rèuolutione rota putealis ... AD EVNDEM. Page: 298 6.14.3 De machina ... AD EVNDEM. Page: 299 }}} Wenn auf ein
der Gruppe 5 unmittelbar kein und kein
, sondern ein

folgt, schreibe nicht "[no heading]", sondern die ersten Wörter des Absatzes, am Ende "...", in eckigen Klammern. Beispiel: 4.25 [Wir sind doch nunmehr ganz, ja mehr denn ganz ...] Dieser Fall kommt allerdings in Benedetti nicht vor. 3. Zu "Untereinträge": Der Einrückungs-Level eines Eintrags entspricht der Anzahl seiner einrückenden Ancestors. Beispiel: {{{

}}} Hier hat "letter" zwei nicht-einrückende ancestors, nämlich volume und body, sowie drei einrückende ancestors, nämlich chapter und zweimal section. Der Einrückungs-Level ist also 3. 4. Es könnte für jeden Dokumenttyp eigene Regeln für die Erstellung des TOC geben. Bisher gibt es wie bei Benedetti und . Hier sehe ich keinen Grund für verschiedene Regeln. Das könnte aber zum Beispiel für anders sein. Solange wir solche Dokumenttypen nicht in unserem Text-Korpus haben, müssen wir das noch nicht klären. == Anweisungen im Text zur TOC-Darstellung == Mit den oben beschriebenen Regeln ist klar, dass im XML-Text keine Hinweise für die Erstellung des TOC benötigt werden. Man sollte solche Hinweise sicher auch nicht verpflichtend machen, denn die dadurch nötige Mehrarbeit erhöht die Hemmschwelle, unser Schema zu verwenden. Frage ist nun, ob man sie wenigstens optional erlauben soll. Dabei sollte man allerdings bedenken, dass fast kein Text solche Hinweise enthalten wird, weil das Eintragen dieser Information in den Text viel Arbeit ist und das automatische Ergebnis in fast allen Fällen gut genug sein wird. Alles, was automatisiert in das XML eingetragen werden kann, kann genausogut vom Anzeigesystem übernommen werden. Dafür spricht, dass eine bessere Feinsteuerung des TOC möglich wäre. Dagegen spricht, dass die Information konzeptionell nicht in den XML-Text gehört. Der Text muss nicht einmal wissen, dass in unserem System aus den
ein TOC erstellt wird.