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.