XML-Header

XML-Standard-Header
Folgende Header-Zeilen m�ssen laut XML-Standard implementiert sein.
<?xml version="1.0" encoding="UTF-8" ?>
<?xml-stylesheet href="cookml.dtd" type="text/dtd"?>
<?xml-stylesheet href="cookml.xsl" type="text/xsl"?>

cookml

"cookml" stellt die Wurzel aller Rezepte und Men�s dar.
Die Tags prog und progver sind programm-spezifisch und sollte mit dem Programmname und dessen Versionsnummer best�ckt werden, die das XML erzeugen..
<cookml version=" 0.1" prog="cook" progver="2.01">

cookml : version

Revisionsnummer der Spezifikation.
Version gibt die Revisisionsnummer derjenigen CookML-Spezifikation an, auf die sich die Implementierung des erzeugenden Programmes bezieht.

cookml : name

Name der Rezeptsammlung.
Oft werden ganze Rezeptpakete geschn�rt und diesen paketen werden Namen gegeben (z.B. "rec.mampf.de 01-03/2002"). Sofern ein CML ein solches Paket darstellt und einen Namen hat, kann dieser hier eingetragen werden und damit das Paket kennzeichnen.

cookml : prog

Name des erzeugenden Programmes.
Hier muss das Programm, das die CML-Datei erzeugt, seinen Namen hinterlassen. Zusamen mit dem Attribut  'progver' ist dies f�r die Fehlersuche ein wichtiger Hinweis und ist daher Pflicht.

cookml : progver

Versiosnummer des erzeugenden Programmes.
DBeschreibung siehe 'cookml:prog'.

cookml : recipe

"recipe" leitet ein neues Rezept ein.
Dieses Tag stellt die Wurzel eines jeden Rezepts dar. recipe kann in einer Datei beliebig oft wiederholt werden.

cookml : recipe : lang

"lang" definiert die Sprache in dem das Rezept abgefasst wurde
Zwar ist es dem Programm prinzipiell egal, in welcher Sprache das Rezept vorliegt, dennoch ist die Information sp�ter wichtig f�r die automatische Umwandlung von Einheiten in die Sprache des Benutzers. So kann man bei US-Rezepten nicht-metrische Einheiten automatisch in Landeseinheiten umrechnen (z.B. oz in gramm).
Die erlaubten Sprachk�rzel isnd folgender Seite zu entnehmen: http://lcweb.loc.gov/standards/iso639-2/englangn.html

cookml : recipe : head

"head" leitet eine Section mit weiteren Rezeptinformationen ein
Die L�nge ist zwar nicht begrenzt aber man sollte den Titel nicht zu lang w�hlen, damit keine Probleme bei der Anzeige oder beim Druck auftreten. Auch sollte man daran denken, dass die weitergegeben Rezepte eventuell im Mealmaster-Format weitergegeben werden k�nnten und dann bei 64 Zeichen abgeschnitten werden

cookml : recipe : head : title

"title" gibt den Namen des aktuellen Rezeptes an.
Die L�nge ist zwar nicht begrenzt aber man sollte den Titel nicht zu lang w�hlen, damit keine Probleme bei der Anzeige oder beim Druck auftreten. Auch sollte man daran denken, dass die weitergegeben Rezepte eventuell im Mealmaster-Format weitergegeben werden k�nnten und dann bei 64 Zeichen abgeschnitten werden

cookml : recipe : head : rid

"RID" kennzeichnet jedes Rezept rechner�bergreifend mit einem eindeutigen Ident.
Bei der Erzeugung eines Rezeptes wird eine eindeutige ID generiert, die jedes Rezept eindeutig kennzeichnet. Dadurch kann man Bezug nehmen auf andere Rezepte, z.B. auf Grundteige als Bestandteil des aktuellen Rezeptes. Oder man verweist bei der Zusammenstellung eines Men�s nur noch auf Rezepte.
Das erste Programm, dass solche Idents eingesetzt hat, war Ambrosio. Daher wurde das Format der Ambrosio-Ident hier �bernommen.
Am Ende des Dokument gibt es ein Kapitel "Aufbau der Rezept-ID:", in dem beschrieben ist wie die RID aufgebaut ist.

cookml : recipe : head : servingqty

F�r wieviele Einheiten (Personen, St�cke usw.)
In servingtype steht die Einheit, die dem Rezept zugewiesen wurde (z.B. Portionen, St�ck usw). In servingqty wird die Anzahl dieser Einheiten angegeben, f�r die das Rezept ausgelegt ist.

cookml : recipe : head : servingtype

In welcher Einheit wird die Menge angegeben (Personen, St�cke usw.)
In servingtype steht die Einheit, die dem Rezept zugewiesen wurde (z.B. Portionen, St�ck usw). In servingqty wird die Anzahl dieser Einheiten angegeben, f�r die das Rezept ausgelegt ist.

cookml : recipe : head : createdate

Datum der Ersterstellung
Hier wird das Tagesdatum festgehalten, an dem das Rezept erstellt worden ist. Dieses Datum darf sp�ter nicht mehr ver�ndert werden k�nnen (z.B. durch �nderungen am Rezept).
Das Format f�r jedes Datum ist: "2003-02-16T10:00:00"

cookml : recipe : head : createuser

Erfasser des Rezeptes
Hier wird der Name des Erfassers festgehalten, der das Rezept verfasst hat. Dieses Datum darf sp�ter nicht mehr ver�ndert werden k�nnen (z.B. durch �nderungen am Rezept).

cookml : recipe : head : createemail

EMail des Erfassers
Hier wird die EMail des Erfassers festgehalten, der das Rezept verfasst hat. Dies kann zur Kontaktaufnahme oder Nachfragen sinnvoll sein.

cookml : recipe : head : changedate

Datum der letzten �nderung
Hier wird das Tagesdatum festgehalten, an dem das Rezept zum letzten Mal ver�ndert wurde. Die Information �ber die vorletzte �nderung wird dabei �berschrieben.

cookml : recipe : head : changeuser

Person, die die letzte �nderung vorgenommen hat
Hier wird der Name der Person festgehalten, der das Rezept zum letzten Mal ver�ndert wurde. Die Information �ber die vorletzte �nderung wird dabei �berschrieben.

cookml : recipe : head : changeemail

EMail der letzten �ndernden Person
Hier wird die EMail der Person festgehalten, der das Rezept zum letzten Mal ver�ndert wurde. Die Information �ber die vorletzte �nderung wird dabei �berschrieben.

cookml : recipe : head :timeallqty

Zeitangabe der kompletten Rezept-Zubereitung
timeallqty gibt den Zeitaufwand an, der insgesamt f�r das Rezept aufzuwenden ist inklusive Vorbereitungs- und Kochphase.
Die Einheit ist immer Minuten.

cookml : recipe : head : timeprepqty

Zeitangabe der Rezept-Vorbereitungszeit
Gibt den abgesch�tzten Zeitraum an, der f�r die Vorbereitungsphase der Rezeptzubereitung zu erwarten ist. Die Einheit ist immer Minuten.

Zeitangabe der eigentlichen Kochzeit
Gibt den abgesch�tzten Zeitraum an, der f�r die eigentliche Kochphase der Rezeptzubereitung zu erwarten ist. Die Einheit ist immer Minuten.

Kosten des Rezepts
Gibt umgangssprachlich die zu erwartenden Kosten an, die f�r das Rezept aufzuwenden sind. Eine Weiterverarbeitung dieser Information durch Programme ist nicht vorgesehen, diese Angabe hat nur informativen Charakter.

Herkunftsland
Gibt das Land oder die Gegend an, aus der das Rezept kulinarisch stammt.

Anteil der Eiweisse/Proteine
Gibt den Anteil/Menge der Eiweisse/Proteine an den Kalorien an.
Die Angaben sind pro Portion anzugeben und m�ssen daher bei der Umrechnung der Portionsmenge nicht umgerechnet werden.

cookml : recipe : head : Kohlenhydrate

Anteil der Kohlenhydrate
Gibt den Anteil/Menge der Kohlenhydrate an den Kalorien an.
Die Angaben sind pro Portion anzugeben und m�ssen daher bei der Umrechnung der Portionsmenge nicht umgerechnet werden.

cookml : recipe : head : Fette

Anteil der Fette
Gibt den Anteil/Menge der Fette an den Kalorien an.
Die Angaben sind pro Portion anzugeben und m�ssen daher bei der Umrechnung der Portionsmenge nicht umgerechnet werden.

cookml : recipe : head : wwpoints

Weight-Watcher Punkte
Die Weight-Watcher-Gemeinde hat mich des �fteren angeschrieben, da� Sie ein Feld zur Angabe der Weight-Watcher-Punkte ben�tigen. Bei diesen Punkten werden jedem Gericht eine bestimmte Anzahl von Punkten zugewiesen. Hier werden die Punkte f�r das Gesamtrezept, also f�r alle Portionen addiert aufgenommen.

Kategorien (Rezept-Gruppierungen)
In jedem cat-Eintrag wird eine Rezeptkategorie festgelegt. Die Bezeichnungen der Kategorien sind nicht genormt und k�nnen sich von Benutzer zu Benutzer unterscheiden. Geplant ist eine Standardisierung, in der eine sinnvolle Menge an Kategorien vorgeschlagen wird.

Quellenangaben
Sofern die Quelle des Rezeptes bekannt ist sollte die Quelle der fariness halber dem Rezept beigef�ggt sein. In den Sourcelines kann man diese Quelle auff�hren.

Stichworte zu einem Rezept
Zu einem Rezept k�nnen beliebige Stichw�rter hinzugef�gt werden. Meistens kann nach diesen Stichworten auch gesucht werden. Im Gegensatz zu ing:cat gibt es keine Bestrebungen, diese zu normieren, es sind also freie Texte zur freien Verwendung.

N�here Beschreibung des Rezepts (z.B. Restaurantkarte)
Sofern aus einer Rezeptzusammenstellung eine Speisekarte oder Men�karte erstellt werden soll, k�nnen hier erkl�rende Texte zum Rezept oder der Rezepttitel in anderen Sprachen aufgenommen werden.

Allergien
In diesem Tag sammeln sich alle Allergie-Informationen.

Allergie-Angabe
Hier werden die Werte f�r eine Allergie angegeben.

Ist der allergene Stoff vorhanden
'F'=Frei von diesem allergischen Stoff, 'C'-contains, enth�lt diesen allergischen Stoff

Inhalt eines Rezeptes (Stofflicher Art)
Hier kann die Summe aller IInhaltsstoffe bez�glich eines Stoffes laut Bundelebensmittelschl�ssel abgelegt werden. Die meisten Programme werden hier eine Kalorienangabe ablegen, aber es ist auch die �bermittlung von Vitamingehalten, Broteinheiten usw. m�glich.
Ein Datensatz besteht immer aus 2 Teilen: Der Stoffangabe (Schl�ssel = K�rzel der Bundeslebensmittelschl�ssel) und die Menge (gleiche Einheit wie die, die im Bundeslebensmittelschl�ssel vorgesehen ist.
Ausnahmen: 
1. nur quantitative BLS-Stoffe (DIE BLS-Datenbank gibt diese Info her). Strings sind hier nicht sinnvoll wie zB "BLS-Code" der ja auch in dieser Liste steht.
Beispiel:
<content type="GCAL" value="627"/> // Kalorien in kCal
<content type="GKB" value="42"/> // Broteinheiten

Kennzeichnung des Stoffes
Beschreibung siehe recipe : content

Rezeptbild (Dateiname)
Hier wird ein Bild zu einem Rezept in Form eines Dateinamens festgelegt. Die Datei befindet sich dabei nur lokal bei dem Benutzer auf der Festplatte und ist daher nur sinnvoll, wenn entweder die Dateihierarchie immer gleich ist, oder sich alle Bilder in einem festgelegten Verzeichnis befinden und hier nur der Dateiname ohne Pfad angegeben wird.

Pfad auf das Bild lokal im Netzwerk
Hier wird ein Bild zu einem Rezept in Form eines Dateinamens oder einer URL festgelegt. Sofern hier das Feld f�r eine URL benutzt wird ist eine komplette URL Pflicht (http://www.???.com/???.JPG. Das Format ist nicht festgelegt aber aus Gr�nden der Verbreitung ist JPG zu preferieren.

Rezeptbild bin�r als Bestandteil des XMLs
Hier wird ein Bild bin�r als Bestandteil der XML-Datei mitgeschickt. Dabei ist das Bild mit Mime64 zu einem 7-Bit Zeichensatz zu konvertieren.

Format der Bilddatei
Um ein besseres Handling eines mitgeschickten Bildes zu erreichen, muss bei der �bertragung eines Bin�rbildes dessen Format hier mit �bermittelt werden. Dabei muss immer die allgemein g�ltige Extension in Grossbuchstaben benutzt werden.
Festgelegt sind bislang: BMP, JPG, PNG, TIF

Freie Felderdefinition
In diesem Tag lassen sich beliebige eigene Informationen unterbringen. Bitte bei der Verwendung immer daran denken, da� eigene Informationen, die hier untergebracht werden nicht von Benutzern anderer Programme ausgewertet werden k�nnen. Es ist sinnvoll, Informationen, die allgemein sinnvoll sind hier zur Standardisierung anzumelden. Nur so kann ein Wildwuchs vermieden werden.
"custom" setzt sich zusammen aus den Attributen "name", "datatype" und "value". Name muss in jedem "custom"-Tag vorhanden sein, da es die Aufgabe des Knotens spezifiziert.

Name eines freien Feldes
Beschreibung siehe "cookml:recipe:custom"

Name eines freien Feldes
Beschreibung siehe "cookml:recipe:custom"

Wert eines freien Feldes
Beschreibung siehe "cookml:recipe:custom"

Definition einer Zutatengruppe
Zutaten sind oft sortiert zu Einheiten wie Teig oder Belag. Eine solche Einheit ist hier definierbar. Sofern man der Einheit eine �berschrift geben m�chte, kann man dieses �ber das Attribut "title" tun.

Benennung einer Zutatengruppe
Zutaten sind oft sortiert zu Einheiten wie Teig oder Belag. Eine solche Einheit ist hier definierbar. Sofern man der Einheit eine �berschrift geben m�chte, kann man dieses �ber das Attribut "title" tun.

Ben�tigte Menge der Zutat
Hier wird mit einer Zahl die Menge der Einheit beschrieben. Diese Zahl bezieht sich immer auf ing:unit. Erlaubt sind nur Dezimalzahlen. Br�che m�ssen zuvor in Gleitkommazaheln umgerechnet werden.

Einheit der Zutat
Die Einheit der Zutatenbeschreibung. Damit die Rezepte international ausgetauscht werden k�nnen, d�rfen keine nationalen Einheiten benutzt werden sondern ausschliesslich amerikanische Einheiten. Hierf�r gibt es einen Quasi-Standard bei Rezepten: Meal-Master. In Unit d�rfen nur g�ltige Mealmaster-Einheiten Verwendung finden. Eine Liste der erlaubten Einheiten und deutschen Entsprechungen gibt es im Kapitel "Erlaubte Einheiten".

Name der Zutat
Der Name der eigentlichen Zutat. Hier darf wirklich nur der Name aufgef�hrt sein und nicht eine n�here Beschreibung (diese ist in inote anzugeben). Statt also "Festkochende Kartoffeln" hier anzugeben darf nur "Kartoffel" stehen und in inote dann "festkochend".

Weiterreichende Beschreibung der Zutat
In ing:item darf nur der Name stehen. Sind weitere Beschreibungen n�tig, so k�nnen sie hier getrennt vom Name der Zutat aufgef�hrt werden. Statt also "Festkochende Kartoffeln"  anzugegeben darf nur ing:item="Kartoffel" sein und <inote>festkochend</inote>

Der Zutat entsprechender BLS-Code
Der BLS-Schl�ssel der der Zutat entspricht oder zumindest sehr nahe kommt. Durch die Zuweisung von BLS-Schl�ssel an die Zutaten ist eine jederzeitige Berechnung beliebiger Inhaltsstoffe des Rezeptes m�glich.
Wichtig: Auch wenn ein Programm den BLS nicht selbst unterst�tzt, m�ssen diese Schl�ssel beim Import/Export mit durchgereicht werden.

Gramm-Entsprechung bei nicht umrechenbaren Einheiten
Manche Einheiten k�nnen nicht direkt in Gramm umgerechnet werden. F�r eine Berechnung der N�hrstoffe zu einer Zutat ist in Verbindung mit dem Bundeslebensmittel-Schl�ssel eine Mengenentsprechung in Gramm notwendig, die hier dann zusammen mit der Zutat angelegt werden kann. Bei "1 Packung Vanillepulver" kann man also hier "30" (Gramm) angeben. Vorteil der Speicherung: Man macht diese Zuweisung der Grammentsprechung einmalig bei der Rezepterstellung und kann nun die Inhaltsstoffe des Rezeptes jederzeit mit einem Mausklick berechnen lassen.