| Version 12 (modified by , 14 years ago) (diff) |
|---|
Das ECHO-Schema
Auf dieser Seite wird das ECHO-Schema beschrieben.
1. Übersicht
Übersichtsgrafik über die Schema-Module:
Schema-Struktur
Das Schema besteht aus Gruppen von Modulen, die im Schaubild mit schwarzen Rahmen markiert sind:
- Standard-Module
- Module zur Grobstrukturierung des Textes
- Module zur Feinstrukturierung des Textes
- additional text blocks (floats): float, note, import-xhtml, figure, handwritten. Diese Module sind ebenfalls optional, aber wird bekommen die entsprechende Information aus dem transkribierten Text.
- additional text blocks (non-floats): textflows, block-scholarly. Diese optionalen Module werden bei Texten mit mehreren Textflows (z.B die "Conimbricenses") sowie bei der Erstellung von Editionen mit wissenschaftlichem Anspruch benötigt.
- Module für die Auszeichnung von Text:
- additions to the inline model: gap, de, mathematics, import-mathml, gis, content-scholarly. Diese optionalen Module sind (bis auf gap) Teil der wissenschaftlichen Bearbeitung der Texte
- additional attributes for Chinese text: chinese-text. Dieses Modul wird für chinesischen Text benötigt. Die entsprechenden Informationen sind in der Transkription bereits enthalten.
Die Grund-Datei des Schemas ist echo.rnc im Verzeichnis trunk/schema/schema/echo, in der die Version des Schemas (z.B. 1.0) sowie die verwendeten namespaces definiert werden. In der Grund-Datei werden außerdem die Module eingebunden. Wenn man für einen bestimmten Text nicht alle Module benötigt, kann man die entsprechenden Zeilen einfach auskommentieren. Zum Beispiel sind in echo-automated-european.rnc die Module chinese-text für chinesischen Text und content-scholarly für nicht-automatisierbare Textverbesserungen auskommentiert.
Die Module sind alle im Unterverzeichnis modules, bis auf import-xhtml, das zusammen mit einigen unnverändert übernommenen xhtml-Modulen im Unterverzeichnis xhtml ist.
Beziehungen zwischen den Modulen
Die Beziehungen zwischen den Modulen sind im Schaubild durch Pfeile dargestellt. Dazu einige Erläuterungen:
- Pfeile
- A → B: Modul A modifiziert Modul B, indem es in A definierte Klassen oder Elemente in in B definierten Klassen oder Elementen erlaubt
- A --> B: Modul A weiß von Modul B, modifiziert es aber nicht
Die Pfeile geben also nicht die Hierarchie der Elemente im XML-Dokument wieder. Sondern: Wenn man B auskommentiert, wird A nicht mehr richtig funktionieren.
- Farben
- grün: Module
- dunkelgrün: Information in der Transkription enthalten
- hellgrün: Information nicht in der Transkription enthalten
- rot: Element/Klasse wird in diesem Modul definiert
- gelb: entspricht einem Pfeil, also A modifies B; wird verwendet, wenn ein Pfeil das Schaubild verwirren würde
- weiß: modifiziert Modul B, indem es Attribute ergänzt
- blau: A verwendet ein in echo-content definiertes Textmodell (weggelassen, wenn A bereits einen Pfeil zu echo-content hat)
- grün: Module
Die Definitionen in den Modulen echo-attribute und echo-datatype werden von allen anderen Modulen verwendet. Verbindungen zu diesen Modulen sind nicht eingezeichnet.
Das originale PDF ist hier: PDF; Legende zur Grafik: PDF (Beides Stand März 2010. Die Struktur des Schemas hat sich kaum geändert; trotzdem TO DO: aktualisieren)
2. Usage Guide
Eine erste Version des Usage Guide für das Schema: PDF (Stand April 2010; TO DO: aus LaTeX in das Wiki übertragen, aktualisieren)
General
Design decisions:
- one schema for all texts
- modules should be independent
- tags in the DESpecs should have some counterpart in the Schema, if possible
- however, do not mimic the DESpecs structure
Standard suffixes as in xhtml:
- .attrib (defined in echo-attribute)
- .datatype (defined in echo-datatype)
- .model (defined in echo-content)
- .class (defined in several modules)
IDs are expected, but XML texts should also validate without IDs
Informationsquellen und minimales Schema
Der Kern des Schemas: "(--)" bedeutet: nicht minimal, aber man bekommt etwas dafür, was über die optische Anzeige des Textes hinausgeht
| Ebene | minimal | China | Modul | Element |
| Grobstruktur | + | -- | echo-start | <echo> |
| + | -- | echo-metadata | <metadata> | |
| +/-- | -- | echo-metadata | Metadaten | |
| + | -- | echo-div | <text> | |
| Mittelstruktur | (--) | + | echo-div | <div index>, <div toc> |
| (--) | -- | echo-div | <div chapter> etc. | |
| Feinstruktur | + | + | echo-block | <head>, <p>, <note> |
| + | -- | echo-block | <s> | |
| -- | + | echo-block | <quote> | |
| -- | -- | echo-block | <set-off> | |
| Text | -- | + | echo-content | <emph> |
| (--) | -- | echo-content | <reg>, <foreign>, <ref> | |
| -- | -- | echo-content | <sic>, <set-off>, <q> | |
| Hilfsmodule | + | n/a | echo-attribute | -- |
| + | n/a | echo-datatype | -- | |
| F: Figures | -- | + | echo-figure | <figure>, <caption> etc. |
| F: Handwritten | -- | + | echo-handwritten | <handwritten> |
| F: Chinese text | -- | + | echo-chinese-text | <head ti>, <p @indent>, <p @ics>, <pb @ics> |
| F: Textflows | -- | + | echo-textflows | <head @flow>, <p @flow>, <div multiflow @flows> |
| F: Tables | -- | + | echo-imp.-xhtml | <xhtml:table> |
| F: Lists | -- | -- | echo-imp.-xhtml | <xhtml:ul> etc. |
| F: Floats | -- | -- | echo-float | <div float> |
| F: Images | -- | -- | echo-figure | <image> |
| T: Milestones | (--) | + | echo-milestone | <pb> (auch F), <lb>, <cb> |
| T: Corruptions | -- | + | echo-gap | <gap>, <unsure> |
| -- | + | echo-de | <de:unknown>, <de:wrong> | |
| T: Chinese notes | -- | + | echo-chinese-text | <lb halfline> |
| T: Floats | -- | + | echo-float | <anchor> |
| T: numbers etc. | (--) | -- | echo-mathematics | <num>, <var> |
| T: formulas | (--) | -- | echo-imp.-mathml | <mml:math> |
| T: Verse | -- | -- | echo-textflows | <lb @label> |
| T: Images | -- | -- | echo-figure | <image> |
| T: Gis | -- | -- | echo-gis | <place>, <time> |
| G: Gis | -- | -- | echo-gis | <dcterms:temporal>, <dcterms:spatial> |
3. Umsetzung der XML-tags
Wie die XML-tags und -Attribute umgesetzt werden sollen: PDF (Stand April 2010; TO DO: aus LaTeX in das Wiki übertragen, aktualisieren)
Regeln zur Umsetzung der div-Struktur in ein Inhaltsverzeichnis: PDF (Stand März 2010; immer noch aktuell; muss ich noch implementieren)
Offene Tickets für die Umsetzung: keyword XML
