XML

= Extensible Mark up Language (erweiterbare Auszeichnungssprache)

XML ist eine Sprache zur Beschreibung von Dokumentstrukturen. Durch die systematische Trennung von Struktur- und Layoutinformationen dient XML zur medienneutralen Datenhaltung: Die Inhalte werden gemäß ihrer Funktion (z.B.: Absatz, Kapitel) oder gemäß ihrer inhaltlichen Bedeutung (z.B. Rezept, Übung) strukturiert, bzw. ausgezeichnet.

DTD

Document Type Definition

Das Regelwerk („die Grammatik“) für XML-Dateien, das die Elemente sowie deren Reihenfolge und gegebenenfalls Hierarchie definiert.

Bei GU wurde für jedes Erlebnisfeld eine individuelle DTD erarbeitet.

Pflichtelemente und Reihenfolgen

In jeder DTD werden sogenannte Pflichtelemente definiert, das sind bestimmte Textauszeichnungen, die vorkommen müssen. Sonst gilt der Text bei einer XML-Strukturprüfung, die man mit jedem XML Editor durchführen kann, als „nicht valide“. Ein Pflichtelement kann z.B. bestimmen, dass ein Kapitel immer mit einer bestimmten Überschriftenhierarchie beginnen muss. Ebenso kann man feste Reihenfolgen definieren, z.B. dass ein Vorwort immer vor dem ersten Kapitel stehen muss. Je mehr Pflichtelemente und feste Reihenfolgen, desto einfacher wird die Arbeit im XML, weil man viel automatisieren kann. Allerdings wird die XML Struktur dann auch sehr unflexibel, da Ausnahmen kaum mehr möglich sind. Wegen unserer breiten Themenpalette und Layoutvielfalt arbeiten wir mit relativ wenigen Pflichtelementen; wir haben eine sogenannte „weiche“ DTD.

Tags

Englisch für „Etiketten“, „Schildchen“

Markieren das Vorkommen von Strukturelementen im Text. Jedes Element muss ein Anfangs- und ein Endtag haben. Beispiel: (<abc>………</abc>)

Topic

Ein Topic bildet die wichtigste kleinste zusammenhängende Information eines Buchs. Es sollte für sich alleine einen Sinn ergeben – bei der Entscheidung, ob ein bestimmter Text noch ein Topic ist oder nicht, hilft also immer die Frage: „Kann ich mir diesen Text vollkommen losgelöst vom Buchkontext vorstellen und würde er dann noch einen Sinn ergeben?“

Topics können durch ein Attribut noch spezifischer beschrieben werden, z.B. anleitung der Art = „anwendung“ (z.B. eine Anleitung für einen Leberwickel) oder anleitung der Art = „Uebung“ (z.B. für eine Yogaübung).

Topics werden mit Metadaten angereichert. Ein Teil davon (z.B. Urheber) fügt das System automatisch hinzu, einige werden manuell erstellt (z.B. Verschlagwortung).

Wie funktioniert XML?

Im Grunde funktioniert XML ähnlich wie Formatvorlagen, die einem Text zugewiesen werden: Überschriftenhierarchien, Betonungen, Fettungen auf der formalen Seite; auf der inhaltlichen Seite können Texte als Rezepte, Übungen oder Pflanzenporträts beschrieben werden. Eine Besonderheit bei XML ist, dass die Texte durch die Auszeichnungs-Tags wie Babuschka-Puppen verschachtelt werden.

Man arbeitet von außen nach innen, wie das (vereinfachte) Beispiel zeigt:

<produkt_ghn>

                          <hauptteil_ghn>

                                                     <kapitel_ghn>

                                                                             <anleitung_praxis>…….</anleitung_praxis>

                                                     </kapitel_ghn>

                         </hauptteil_ghn>

</produkt_ghn>

<rezept>
<ueberschrift_rezept><u-text>KONFETTI-POPS</u-text></ueberschrift_rezept>
<teasertext>
<fliesstext_abs>Diese regenbogenfarbigen Cake-Pops sind echte Gute-Laune-Stifter! Und beim Bestreuen mit Konfetti-Streuseln helfen bestimmt auch die Kinder begeistert mit.</fliesstext_abs>
</teasertext>
<wertmarke>Kunterbunt</wertmarke>
<zutaten_materiallisten>
<zutaten_materialliste>
<zutat_material><zutat_text>30 g Butter</zutat_text></zutat_material>
<zutat_material><zutat_text>1 Ei (Größe M)</zutat_text></zutat_material>
<zutat_material><zutat_text>50 g Zucker</zutat_text></zutat_material>
<zutat_material><zutat_text>1 Pck. Vanillezucker</zutat_text></zutat_material>
<zutat_material><zutat_text>1 Prise Salz</zutat_text></zutat_material>
<zutat_material><zutat_text>90 g Mehl</zutat_text></zutat_material>
<zutat_material><zutat_text>¼ TL Backpulver</zutat_text></zutat_material>
<zutat_material><zutat_text>1 EL Naturjoghurt</zutat_text></zutat_material>
</zutaten_materialliste>
<zutaten_materialliste>
<ueberschrift_zwischen><u-text>Für die Deko:</u-text></ueberschrift_zwischen>
<zutat_material><zutat_text>50 g weiße Kuvertüre</zutat_text></zutat_material>
<zutat_material><zutat_text>2 EL Milch</zutat_text></zutat_material>
<zutat_material><zutat_text>200 g Puderzucker</zutat_text></zutat_material>
<zutat_material><zutat_text>einige Tropfen Lebensmittelfarbe (rot, gelb, grün)</zutat_text></zutat_material>
<zutat_material><zutat_text>Dekor-Konfetti (Zuckerstreusel)</zutat_text></zutat_material>
</zutaten_materialliste>
<zutaten_materialliste>
<ueberschrift_zwischen><u-text>Außerdem</u-text></ueberschrift_zwischen>
<zutat_material><zutat_text>flexible Cake-Pop-Backform für 16 Stück</zutat_text></zutat_material>
<zutat_material><zutat_text>16 Cake-Pop-Stiele oder Holzstäbchen</zutat_text></zutat_material>
</zutaten_materialliste>
</zutaten_materiallisten>
<rezeptangaben>
<portion><portion_text>Für 16 Stück</portion_text></portion>
<benoetigte_zeit><benoetigte_zeit_text>1 Std. 15 Min. Zubereitung</benoetigte_zeit_text></benoetigte_zeit>
<benoetigte_zeit><benoetigte_zeit_text>20 Min. Backen</benoetigte_zeit_text></benoetigte_zeit>
<benoetigte_zeit><benoetigte_zeit_text>20 Min. Kühlen</benoetigte_zeit_text></benoetigte_zeit>
<naehrwertangabe><naehrwertangabe_text>Pro Stück ca. 123 kcal</naehrwertangabe_text></naehrwertangabe>
<naehrwertangabe><naehrwertangabe_text>1 g EW</naehrwertangabe_text></naehrwertangabe>
<naehrwertangabe><naehrwertangabe_text>3 g F</naehrwertangabe_text></naehrwertangabe>
<naehrwertangabe><naehrwertangabe_text>22 g KH</naehrwertangabe_text></naehrwertangabe>
</rezeptangaben>
<stepanleitungen>
<stepanleitung>
<step><step_inhalt><fliesstext_abs>Backofen auf 180° vorheizen. Butter zerlassen. Ei, Zucker, Vanillezucker und Salz mit dem Handrührgerät in ca. 5 Min weißschaumig rühren. Mehl mit Backpulver mischen und einrühren. Die flüssige Butter und den Joghurt gut unterrühren. Den unteren Teil der Backform auf ein Backblech stellen, den Teig mit zwei Teelöffeln in die Mulden füllen und die Form mit dem Deckel verschließen. Den Teig im Ofen (Mitte) ca. 20 Min. backen. Die Form herausnehmen und 5 Min. abkühlen lassen. Dann den Deckel abnehmen und die Cake-Pops aus den Mulden drücken.</fliesstext_abs></step_inhalt></step>
<step><step_inhalt><fliesstext_abs>Für die Deko die Kuvertüre hacken und in einer Tasse im heißen Wasserbad schmelzen lassen. Cake-Pop-Stiele 1 cm tief eintauchen, in die Cake-Pops stecken und diese 15 Min. kühlen.</fliesstext_abs></step_inhalt></step>
<step><step_inhalt><fliesstext_abs>Milch leicht erwärmen, mit Puderzucker zu einer dickflüssigen Glasur verrühren und diese dritteln. Eine Portion mit einigen Tropfen roter, die zweite mit einigen Tropfen gelber und die dritte mit einigen Tropfen grüner Lebensmittelfarbe verrühren. Die Cake-Pops einzeln in je eine Glasur tauchen und den Überschuss durch Drehen der Stiele abtropfen lassen. Mit Dekor-Konfetti bestreuen und trocknen lassen.</fliesstext_abs></step_inhalt></step>
</stepanleitung>
</stepanleitungen>
<extra art="Sonstiges"><ueberschrift_extra><u-text>TIPP</u-text></ueberschrift_extra><fliesstext_abs>Als Glasur 1 ganz frisches Eiweiß halbsteif schlagen, 200 g Puderzucker und 1 TL Zitronensaft nach und nach einrühren, bis eine dicke, glänzende Glasur entsteht. Die Cake-Pops einzeln hineintauchen und den Überschuss abtropfen lassen. Mit bunten Zuckerstreuseln bestreuen und trocknen lassen.</fliesstext_abs></extra>
</rezept>

rezept

Das Topic rezept wird für alle Rezepte verwendet, die eine Zutatenliste und eine Stepanleitung haben.

Aufbau rezept (keine feste Reihenfolge)

Anmerkungen

Wenn das Rezept mehrere Zutatenlisten hat („für den Teig“, „für den Belag“), so wird dies jeweils in einer eigenen zutaten_materialliste erfasst. „Für den Teig“ wird dann als ueberschrift_zwischen ausgezeichnet. Ebenso wird mit stepanleitungen verfahren.

kurzrezept

Ein Rezept in Fließtextform („…schlagen Sie drei Eier auf und verrühren Sie diese mit einem Liter Milch…“). Es kann eine Zutatenliste haben, oder aber die Zutaten stehen direkt als „inline-Zutat“ im Fließtext.

Aufbau (keine feste Reihenfolge)

Wird bereits im MS strukturiert

Wird später in censhare strukturiert

ueberschrift_kurzrezept

meta_kurzrezept (z.B. Schlagworte)

+ abbildung

­       abbildungstitel

­       bildunterschrift

­       bildcopyright

+ zutaten_materialliste

+      zutat_material

rezeptangaben

­       portion

+      benoetigte zeit

+      naehrwerte

­       haltbarkeit

portion_strukturiert

zeit_strukturiert

naehrwerte_strukturiert

haltbarkeit_strukturiert

kurzbeschreibung

­       zutat_material_inline

­       angabe_inline

+ extra_abhaengig

+ extra_sonstiges