Mercurial > dive4elements > river
comparison artifacts/doc/datacage_ref_de.rst @ 7316:52bc38e6bbe1
Datacage ref doc: Explain dc:variable and dc:convert.
| author | Sascha L. Teichmann <teichmann@intevation.de> |
|---|---|
| date | Mon, 14 Oct 2013 14:40:51 +0200 |
| parents | 8498fdd71a1e |
| children | 00b17e77c2e8 |
comparison
equal
deleted
inserted
replaced
| 7315:8498fdd71a1e | 7316:52bc38e6bbe1 |
|---|---|
| 152 seinen Einsatz, wenn es ein Ausgabeelement vollständig aus Variablenbelegungen | 152 seinen Einsatz, wenn es ein Ausgabeelement vollständig aus Variablenbelegungen |
| 153 erstellt werden soll. | 153 erstellt werden soll. |
| 154 | 154 |
| 155 ``dc:comment`` Kommentare im Beschreibungsdokument | 155 ``dc:comment`` Kommentare im Beschreibungsdokument |
| 156 .................................................. | 156 .................................................. |
| 157 | |
| 157 .. code:: xml | 158 .. code:: xml |
| 158 | 159 |
| 159 <dc:comment> | 160 <dc:comment> |
| 160 ... | 161 ... |
| 161 </dc:comment> | 162 </dc:comment> |
| 163 Ein Kommentar auf Ebene des Beschreibungsdokumentes, das keinerlei Ausgabe | 164 Ein Kommentar auf Ebene des Beschreibungsdokumentes, das keinerlei Ausgabe |
| 164 im Ausgabedokument erzeugt. Eingeschachtelte Elemente werden ebenfalls nicht ausgewertet. | 165 im Ausgabedokument erzeugt. Eingeschachtelte Elemente werden ebenfalls nicht ausgewertet. |
| 165 Im Gegensatz dazu werden die XML-typischen **<!-- Kommetare -->** in das Ausgabedokument übernommen! | 166 Im Gegensatz dazu werden die XML-typischen **<!-- Kommetare -->** in das Ausgabedokument übernommen! |
| 166 | 167 |
| 167 | 168 |
| 168 ``dc:message`` **TODO** | 169 ``dc:message`` Ausgabe auf die Diagnoseausgabe (Log) |
| 169 | 170 .................................................... |
| 170 ``dc:variable`` **TODO** | 171 |
| 171 | 172 .. code:: xml |
| 172 ``dc:convert`` **TODO** | 173 |
| 173 | 174 <dc:message> |
| 175 Text für die Diagnose. | |
| 176 </dc:message> | |
| 177 | |
| 178 Gibt den Text innerhalb des Elementes aus Ausgabe im Log aus. Dies dient in erster Linie | |
| 179 dem Nachvollziehen von Aufrufen innerhalb des Datenkorbdokumentes. Für den Text gelten | |
| 180 die `{$}-Ersetzungen`_. | |
| 181 | |
| 182 ``dc:variable`` Erzeugung einer kontext-lokalen Variablen | |
| 183 ......................................................... | |
| 184 | |
| 185 .. code:: xml | |
| 186 | |
| 187 <dc:variable name="Name" type="Typ" expr="XPath-Ausdruck"/> | |
| 188 | |
| 189 Legt im aktuellen Kontext eine lokale Variable namens Name an. Diese hat den | |
| 190 Typ Typ und entsteht durch Auswertung des XPath-Ausdruck expr. Der Typ | |
| 191 ist optional. Wird dieser nicht gesetzt, wird das Ergebnis als String interpretiert. | |
| 192 Alternativ können hier die Werte 'number' für Zahlen, 'bool' für Boolean-Werte | |
| 193 benutzt werden. Für den Namen und den Typ gelten die `${}-Ersetzungen`_. | |
| 194 Wird der aktuellen `dc:context` verlassen, ist diese Variable nicht mehr definiert. | |
| 195 | |
| 196 | |
| 197 ``dc:convert`` kontext-lokale Konvertierung von Variablen | |
| 198 ......................................................... | |
| 199 | |
| 200 .. code:: xml | |
| 201 | |
| 202 <dc:convert name="Name" type="Typ"/> | |
| 203 | |
| 204 Konvertiert die Variable namens Name für die Gültigkeit des aktuellen Kontextes in | |
| 205 einen anderen Typ. Für Name und Typ gelten die `${}-Ersetzungen`_. Für die | |
| 206 Typen gilt das gleiche wie für die Typen von `dc:variable`. | |
| 174 | 207 |
| 175 Bedingte Ausführung | 208 Bedingte Ausführung |
| 176 ~~~~~~~~~~~~~~~~~~~ | 209 ~~~~~~~~~~~~~~~~~~~ |
| 177 | 210 |
| 178 ``<dc:if>`` Einfaches Wenn-Dann ohne Sonst-Fall | 211 ``<dc:if>`` Einfaches Wenn-Dann ohne Sonst-Fall |