summaryrefslogtreecommitdiff
path: root/ikiwiki/directive.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki/directive.mdwn')
-rw-r--r--ikiwiki/directive.mdwn47
1 files changed, 47 insertions, 0 deletions
diff --git a/ikiwiki/directive.mdwn b/ikiwiki/directive.mdwn
new file mode 100644
index 0000000..cf071de
--- /dev/null
+++ b/ikiwiki/directive.mdwn
@@ -0,0 +1,47 @@
+[[!meta title="Anweisungen"]]
+[[!meta robots="noindex, follow"]]
+Anweisungen haben eine ähnliche Form wie ein [[ikiwiki/WikiLink]],
+allerdings beginnen sie mit `!` und sie können Parameter enthalten. Die
+allgemeine Form ist:
+
+ \[[!anweisung param="Wert" param="Wert"]]
+
+Dies wird expandiert, bevor der Rest der Seite verarbeitet wird, und kann
+auf unterschiedliche Weise genutzt werden, die Seite zu verändern.
+
+Die Anführungszeichen um die Werte können weggelassen werden, wenn der Wert
+ein einfaches Wort ist. Einige Anweisungen verwenden auch Parameter ohne
+Wert, zum Beispiel:
+
+ \[[!tag foo]]
+
+Eine Anweisung muss nicht ganz in einer einzelnen Zeile stehen, sie kann
+auch auf mehrere Zeilen verteilt werden:
+
+ \[[!anweisung foo="baldersnatch"
+ bar="supercalifragilisticexpialidocious" baz=11]]
+
+Außerdem können mehrere Zeilen Text *in Anführungszeichen* für einen Wert
+verwendet werden. Um Anführungszeichen innerhalb des Werts zu ermöglichen,
+trenne den Textblock durch dreifache Anführungszeichen ab:
+
+ \[[!anweisung text="""
+ 1. "foo"
+ 2. "bar"
+ 3. "baz"
+ """]]
+
+Es gibt in ikiwiki auch eine ältere Syntax für Anweisungen, die ein
+Leerzeichen in erfordert, um sie von [[Wiki-Links|ikiwiki/wikilink]] zu
+unterscheiden. Diese Syntax hat mehrere Nachteile: Sie erfordert ein
+Leerzeichen nach Anweisungen ohne Parameter (so wie `\[[pagecount ]]`), and
+sie verbietet Leerzeichen in [[Wiki-Links|ikiwiki/wikilink]]. Die oben
+gezeigte Syntax mit `!`-Präfix ist nun der Standard in ikiwiki. Die alte
+Syntax wird allerdings auch noch unterstützt, wenn die Option
+`prefix_directives` deaktiviert wird.
+
+[[!if test="enabled(listdirectives)" then="""
+Hier ist eine Liste der aktuell verfügbaren Anweisungen in diesem Wiki:
+
+[[!listdirectives ]]
+"""]]