summaryrefslogtreecommitdiff
path: root/ikiwiki/directive.mdwn
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2010-10-14 13:38:34 +0200
committerJonas Smedegaard <dr@jones.dk>2010-10-14 13:38:34 +0200
commit944255f9f0857a5286d88f627c47dd9428a9f810 (patch)
tree7e946cdb321966dec83d2e8bf093a15dc5588e41 /ikiwiki/directive.mdwn
Sync with ikiwiki 3.20100926.HEADmasterikiwiki
Diffstat (limited to 'ikiwiki/directive.mdwn')
-rw-r--r--ikiwiki/directive.mdwn46
1 files changed, 46 insertions, 0 deletions
diff --git a/ikiwiki/directive.mdwn b/ikiwiki/directive.mdwn
new file mode 100644
index 0000000..f7ebc17
--- /dev/null
+++ b/ikiwiki/directive.mdwn
@@ -0,0 +1,46 @@
+[[!meta robots="noindex, follow"]]
+Les directives sont semblables aux [[ikiwiki/WikiLink]] mais elles
+commencent par un `!` et peuvent contenir des paramètres. La forme d'une
+directive est la suivante :
+
+ \[[!directive param="value" param="value"]]
+
+Le contenu de cette directive est traité avant que la page ne soit traitée
+et cela peut être utilisé pour modifier cette page.
+
+Les guillements autour des valeurs des paramètres peuvent être omis si cette
+valeur est un simple mot. D'autre part, certaines directives peuvent avoir
+des paramètres sans valeur, par exemple :
+
+ \[[!tag foo]]
+
+Il n'est pas nécessaire d'écrire une directive sur une seule ligne ; elle
+peut l'être sur plusieurs si vous préférez. Par exemple :
+
+ \[[!directive foo="baldersnatch"
+ bar="supercalifragilisticexpialidocious" baz=11]]
+
+De plus, une *citation* sur plusieurs lignes peut servir de valeur. Pour
+autoriser les guillemets du texte, il suffit de mettre trois séries de
+guillemets autour du texte :
+
+ \[[!directive text="""
+ 1. "foo"
+ 2. "bar"
+ 3. "baz"
+ """]]
+
+Il existe aussi une ancienne syntaxe pour les directives. Elle demande un
+espace dans la directive pour les distinguer des
+[[wikilinks|ikiwiki/wikilink]]. Cette syntaxe a plusieurs défauts : elle
+demande un espace après une directive sans paramètre, comme `\[[pagecount
+]]`, et elle interdit les espaces dans les
+[[wikilinks|ikiwiki/wikilink]]. Par défaut, ikiwiki utilise maintenant la
+syntaxe montrée plus haut, avec le `!`. Cependant, l'ancienne syntaxe est
+toujours acceptée, une fois que l'option `prefix_directives` est désactivée.
+
+[[!if test="enabled(listdirectives)" then="""
+Voici une liste des directives actuellement disponibles sur ce wiki :
+
+[[!listdirectives ]]
+"""]]