summaryrefslogtreecommitdiff
path: root/ikiwiki/directive.mdwn
blob: cf071defe63babb858d066404a9eb7f9bf06a060 (plain)

[[!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 ]] """]]