# HG changeset patch
# User Sascha L. Teichmann <teichmann@intevation.de>
# Date 1381065345 -7200
# Node ID 5783bd29de8a1298a377234318c6ee50cc472587
# Parent  fe32a7f9655e0a00483de1158c07a7f466f81402
First draft of a german reference document for datacage elements and functions written in reStructuredText. Lots of TODOs.

diff -r fe32a7f9655e -r 5783bd29de8a artifacts/doc/datacage_ref_de.rst
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/artifacts/doc/datacage_ref_de.rst	Sun Oct 06 15:15:45 2013 +0200
@@ -0,0 +1,118 @@
+=========
+Datenkorb
+=========
+
+
+.. contents:: Inhalt
+
+Übersicht
+---------
+
+Datenkorb-Elemente
+------------------
+
+``dc:element`` **TODO**
+
+``dc:attribute`` **TODO**
+
+``dc:context`` **TODO**
+
+``dc:statement`` **TODO**
+
+``dc:container-context`` **TODO**
+
+``dc:properties`` **TODO**
+
+``dc:for-each`` **TODO**
+
+``dc:iterate`` **TODO**
+
+``dc:virtual-column`` **TODO**
+
+``dc:macro`` **TODO**
+
+``dc:macro-body`` **TODO**
+
+``dc:call-macro`` **TODO**
+
+``dc:comment`` **TODO**
+
+``dc:filter`` **TODO**
+
+``dc:group`` **TODO**
+
+``dc:message`` **TODO**
+
+``dc:variable`` **TODO**
+
+``dc:convert`` **TODO**
+
+
+Bedingte Ausführung
+~~~~~~~~~~~~~~~~~~~
+
+``<dc:if>`` Einfaches Wenn-Dann ohne Sonst-Fall
+...............................................
+
+.. code:: xml
+
+    <dc:if test="XPath-Ausdruck">
+      ...
+    </dc:if>
+
+Der innere Teil wird nur dann betreten, wenn der XPath-Ausdruck zu
+logisch wahr evaluiert wird. Dieses Konstrukt kennt keinen alternativen
+Pfad, der betreten wird, falls der Ausdruck zu logisch falsch ausgewertet
+wird. Wird dies benötigt, muss man ``<dc:choose>`` benutzen.
+``<dc:if>`` ist in Symmetrie zu ``<xsl:if>`` von XSLT entworfen worden.
+
+``<dc:choose>`` Ketten von Wenn-Dann-Ausdrücken
+...............................................
+
+.. code:: xml
+    
+    <dc:choose>
+       <dc:when test="XPath-Ausdruck 1"> ... </dc:when>
+       <dc:when test="XPath-Ausdruck 2"> ... </dc:when>
+       ...
+       <dc:otherwise> ...  </dc:otherwise>
+    </dc:choose>
+
+Es werden der Reihe nach von oben nach unter die ``test``-XPath-Ausdrücke der ``dc:when``-Elemente ausgewertet.  Evaluiert ein Ausdruck zu logisch wahr, wird der innere Teil des entsprechenden ``<dc:when>``-Elements betreten. Die verbliebenen
+``<dc:when>``- und ``<dc:otherwise>``-Elemente werden dann ignoriert. Evaluiert
+keiner der ``test``-Ausdrücke zu wahr, wird der innere Teil des
+``<dc:otherwise>``-Elements betreten.
+``<dc:choose>`` ist in Symmetrie zu ``<xsl:choose>`` von XSLT entworfen worden.
+
+
+Variablen
+---------
+
+Textersatz
+----------
+
+Datenkorb-Funktionen
+--------------------
+
+``dc:contains`` **TODO**
+
+``dc:fromValue`` **TODO**
+
+``dc:toValue`` **TODO**
+
+``dc:replace`` **TODO**
+
+``dc:replace-all`` **TODO**
+
+``dc:has-result`` **TODO**
+
+``dc:group-key`` **TODO**
+
+``dc:date-format`` **TODO**
+
+``dc:dump-variables`` **TODO**
+
+``dc:get`` **TODO**
+
+
+