summaryrefslogtreecommitdiff
path: root/ikiwiki/directive
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2010-10-14 13:38:35 +0200
committerJonas Smedegaard <dr@jones.dk>2010-10-14 13:38:35 +0200
commitdef01959f8b76178d393a39ecd2c5af9be20b31f (patch)
treeed9b5b062671c30e55fe691625fc7ddcb31fee1f /ikiwiki/directive
Sync with ikiwiki 3.20100926.HEADmasterikiwiki
Diffstat (limited to 'ikiwiki/directive')
-rw-r--r--ikiwiki/directive/aggregate.mdwn61
-rw-r--r--ikiwiki/directive/brokenlinks.mdwn15
-rw-r--r--ikiwiki/directive/calendar.mdwn63
-rw-r--r--ikiwiki/directive/color.mdwn27
-rw-r--r--ikiwiki/directive/comment.mdwn39
-rw-r--r--ikiwiki/directive/cutpaste.mdwn53
-rw-r--r--ikiwiki/directive/edittemplate.mdwn39
-rw-r--r--ikiwiki/directive/format.mdwn29
-rw-r--r--ikiwiki/directive/fortune.mdwn8
-rw-r--r--ikiwiki/directive/graph.mdwn23
-rw-r--r--ikiwiki/directive/haiku.mdwn16
-rw-r--r--ikiwiki/directive/if.mdwn48
-rw-r--r--ikiwiki/directive/img.mdwn42
-rw-r--r--ikiwiki/directive/inline.mdwn133
-rw-r--r--ikiwiki/directive/linkmap.mdwn31
-rw-r--r--ikiwiki/directive/listdirectives.mdwn21
-rw-r--r--ikiwiki/directive/map.mdwn25
-rw-r--r--ikiwiki/directive/meta.mdwn171
-rw-r--r--ikiwiki/directive/more.mdwn18
-rw-r--r--ikiwiki/directive/orphans.mdwn17
-rw-r--r--ikiwiki/directive/pagecount.mdwn12
-rw-r--r--ikiwiki/directive/pagestats.mdwn42
-rw-r--r--ikiwiki/directive/pagetemplate.mdwn14
-rw-r--r--ikiwiki/directive/ping.mdwn20
-rw-r--r--ikiwiki/directive/poll.mdwn28
-rw-r--r--ikiwiki/directive/polygen.mdwn12
-rw-r--r--ikiwiki/directive/postsparkline.mdwn49
-rw-r--r--ikiwiki/directive/progress.mdwn20
-rw-r--r--ikiwiki/directive/shortcut.mdwn10
-rw-r--r--ikiwiki/directive/sparkline.mdwn58
-rw-r--r--ikiwiki/directive/table.mdwn51
-rw-r--r--ikiwiki/directive/tag.mdwn37
-rw-r--r--ikiwiki/directive/template.mdwn85
-rw-r--r--ikiwiki/directive/testpagespec.mdwn28
-rw-r--r--ikiwiki/directive/teximg.mdwn24
-rw-r--r--ikiwiki/directive/toc.mdwn29
-rw-r--r--ikiwiki/directive/toggle.mdwn38
-rw-r--r--ikiwiki/directive/version.mdwn13
38 files changed, 1449 insertions, 0 deletions
diff --git a/ikiwiki/directive/aggregate.mdwn b/ikiwiki/directive/aggregate.mdwn
new file mode 100644
index 0000000..fd48172
--- /dev/null
+++ b/ikiwiki/directive/aggregate.mdwn
@@ -0,0 +1,61 @@
+La directive `aggregate` est fournie par le module d'extension [[!iki
+plugins/aggregate desc=aggregate]]. Ce greffon demande une configuration
+particulière, à savoir une tâche `cron`. Consultez la documention du greffon
+pour des précisions.
+
+Cette directive permet d'assembler les contenus d'autres flux dans le
+wiki. Ainsi :
+
+ \[[!aggregate name="example blog" dir="example"
+ feedurl="http://example.com/index.rss"
+ url="http://example.com/" updateinterval="15"]]
+
+Dans cet exemple, les messages du flux RSS indiqué sont assemblés dans le
+répertoire example/ du wiki, une page par message. La fréquence de mise à
+jour est de 15 minutes (mais moins fréquemment si la tâche cron est exécutée
+moins fréquemment).
+
+Vous pouvez utiliser la directive [[inline]] d'ikiwiki pour créer un blog
+avec un ou plusieurs flux assemblés. Par exemple :
+
+ \[[!inline pages="internal(example/*)"]]
+
+Notez l'utilisation de la fonction `internal()` de [[ikiwiki/PageSpec]] pour
+trouver les pages assemblées. Par défaut, les pages assemblées sont des
+pages internes, ce qui empêche qu'elles apparaissent directement dans le
+wiki. C'est pourquoi la fonction `internal()` est nécessaire dans la
+spécification [[PageSpec]] pour les trouver.
+
+## Usage
+
+Voici la description de tous les paramètres acceptés par cette directive :
+
+* `name` - Le nom du flux. Chaque flux doit avoir un nom unique. Paramètre
+ obligatoire.
+* `url` - L'URL de la page web contenant le flux assemblé. Paramètre
+ obligatoire.
+* `dir` - Le répertoire du wiki où seront sauvegardées les pages. Paramètre
+ facultatif. S'il n'est pas indiqué, le répertoire est construit à partir
+ du nom du flux.
+* `feedurl` - L'URL du flux. Paramètre facultatif. S'il n'est pas indiqué,
+ ikiwiki cherchera le flux avec le paramètre `url`. Les flux RSS et Atom
+ sont reconnus.
+* `updateinterval` - Fréquence, en minutes, de la recherche des nouveaux
+ messages. Par défaut, 15 minutes.
+* `expireage` - Éliminer les anciens messages du flux si leur ancienneté
+ est plus grande qu'un nombre de jours donné. Par défaut, aucune
+ élimination ne se fait sur l'ancienneté.
+* `expirecount` - Éliminer les anciens messages du flux si leur nombre est
+ plus grand qu'un nombre donné. Les messages les plus anciens sont éliminés
+ en premier. Par défaut, aucune élimination ne se fait sur le nombre.
+* `tag` - Représente une étiquette avec laquelle étiqueter chaque message
+ du flux. Le nom du flux est une bonne étiquette. Ce paramètre peut être
+ répété. Le greffon [[tag]] doit être activé.
+* `template` - Modèle de page à utiliser pour la création des pages
+ assemblées. Par défaut, c'est "aggregatepost".
+
+Notez que même si vous utilisez subversion ou un autre système de
+versionnement, les pages créées par assemblage *ne* seront *pas* prises en
+compte par le système de contrôle de versions.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/brokenlinks.mdwn b/ikiwiki/directive/brokenlinks.mdwn
new file mode 100644
index 0000000..91e05d6
--- /dev/null
+++ b/ikiwiki/directive/brokenlinks.mdwn
@@ -0,0 +1,15 @@
+La directive `brokenlinks` est fournie par le module d'extension [[!iki
+plugins/brokenlinks desc=brokenlinks]].
+
+Cette directive crée une liste des liens cassés sur les pages du wiki. On
+peut ainsi facilement trouver les pages à écrire ou les liens mal trancrits.
+
+Le paramètre optionnel "pages" peut être une expression [[ikiwiki/PageSpec]]
+indiquant dans quelles pages chercher les liens cassés. Par défaut la
+recherche se fait dans toutes les pages.
+
+Exemple :
+
+ \[[!brokenlinks pages="* and !recentchanges"]]
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/calendar.mdwn b/ikiwiki/directive/calendar.mdwn
new file mode 100644
index 0000000..07e8d26
--- /dev/null
+++ b/ikiwiki/directive/calendar.mdwn
@@ -0,0 +1,63 @@
+La directive `calendar` est fournie par le module d'extension [[!iki
+plugins/calendar desc=calendar]].
+
+Cette directive affiche un calendrier, comparable aux calendriers affichés
+par certains blogs.
+
+# Exemples :
+
+ \[[!calendar ]]
+
+ \[[!calendar type="month" pages="blog/* and !*/Discussion"]]
+
+ \[[!calendar type="year" year="2005" pages="blog/* and !*/Discussion"]]
+
+## configuration
+
+L'agenda, habituellement trouvé dans les blogs, est essentiellement une
+interface agréable pour l'archive de pages précédentes. Il peut afficher un
+calendrier pour un mois donné ou une liste de mois pour une année donnée. Un
+calendrier mensuel lie à chaque jour du mois les pages publiées ce jour. Un
+calendrier annuel lie aux pages d'archive, avec des noms comme
+`archives/2007` (pour tout 2007) et `archives/2007/01` (pour janvier 2007).
+
+Les directives calendar peuvent être insérées n'importe où dans le wiki,
+même dans la barre latérale. Vous devez cependant créer les pages
+d'archives. Celles-ci utilisent cette directive pour afficher un calendrier
+et aussi la directive [[inline]] pour afficher ou lister les pages créées
+dans l'espace de temps donné.
+
+La commande `ikiwiki-calendar` peut créer automatiquement les pages
+d'archives. Elle actualise aussi le wiki, mettant à jour les calendriers
+(date du jour en surbrillance). Cette commande est exécutée généralement à
+minuit par le programme cron.
+
+Une crontab possible :
+
+ 0 0 * * * ikiwiki-calendar ~/ikiwiki.setup "posts/* and !*/Discussion"
+
+## utilisation
+
+* `type` - Ce paramètre indique le type du calendrier. C'est soit « month »
+ soit « year », la valeur par défaut étant le calendrier mensuel.
+* `pages` - Indique une spécification [[ikiwiki/PageSpec]] pour les pages
+ qui seront liées au calendrier. La valeur par défaut est « * ».
+* `archivebase` - Indique la racine des répertoires d'archives, « archives »
+ par défaut. On peut changer cette valeur en renseignant `archivebase` dans
+ le fichier de configuration d'ikiwiki. Les calendriers se lient à des
+ pages placées là, nommées "2010/04" ou "2010" par exemple. Ces pages
+ peuvent être créées automatiquement par le programme `ikiwiki-calendar`.
+* `year` - Indique l'année pour le calendrier annuel. La valeur par défaut
+ est l'année en cours. On peut aussi utiliser -1 pour se référer à l'année
+ dernière, ainsi de suite.
+* `month` - Ce paramètre indique le chiffre du mois (1..12) pour le
+ calendrier. Il n'est utilisé que pour le calendrier mensuel, et la valeur
+ par défaut est le chiffre du mois en cours. On peut aussi utiliser -1 pour
+ se référer au mois dernier, ainsi de suite.
+* `week_start_day` - Indique le chiffre (0..6) qui représente le jour par
+ lequel commence la semaine dans le calendrier. Dimanche, c'est 0, lundi,
+ 1, etc. La valeur par défaut est 0, dimanche.
+* `months_per_row` - Ce paramètre indique, dans le calendrier annuel, le
+ nombre de mois par ligne. La valeur par défaut est 3.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/color.mdwn b/ikiwiki/directive/color.mdwn
new file mode 100644
index 0000000..f07e21f
--- /dev/null
+++ b/ikiwiki/directive/color.mdwn
@@ -0,0 +1,27 @@
+La directive `color` est fournie par le module d'extension [[!iki
+plugins/color desc=color]].
+
+Cette directive permet de mettre en couleur une partie d'un texte sur la
+page. On peut ainsi définir la couleur du texte lui-même ou la couleur du
+fond sur lequel le texte s'affiche.
+
+Vous pouvez utiliser le nom de la couleur (par exemple "white") ou bien le
+code HTML (`#ffffff`).
+
+## Exemples :
+
+Voici comment définir la couleur du texte par un nom et la couleur du fond
+par un code HTLM :
+
+ \[[!color foreground=white background=#ff0000 text="White text on red background"]]
+
+Si la couleur de fond est absente, le texte est affiché sur la couleur de
+fond par défaut :
+
+ \[[!color foreground=white text="White text on default color background"]]
+
+Si la couleur du texte est absente, le texte possède la couleur par défaut :
+
+ \[[!color background=#ff0000 text="Default color text on red background"]]
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/comment.mdwn b/ikiwiki/directive/comment.mdwn
new file mode 100644
index 0000000..9e527b5
--- /dev/null
+++ b/ikiwiki/directive/comment.mdwn
@@ -0,0 +1,39 @@
+La directive `comment` est fournie par le module d'extension [[!iki
+plugins/comments desc=comments]]. Elle permet l'ajout d'un commentaire sur
+une page. En général, la page ne comporte que la directive et c'est le
+greffon lui-même qui remplit la directive quand un utilisateur poste un
+commentaire.
+
+Exemple :
+
+ \[[!comment format=mdwn
+ username="foo"
+ subject="Bar"
+ date="2009-06-02T19:05:01Z"
+ content="""
+ Blah blah.
+ """
+ ]]
+
+## Usage
+
+Le seul paramètre obligatoire est `content`. les autres paramètres ajoutent
+ou annulent des métadonnées.
+
+* `content` - Texte du commentaire à afficher. Les
+ [[directives|ikiwiki/directive]] sont autorisées, ou non, selon la
+ configuration du greffon « comment ».
+* `format` - Indique le balisage utilisé par le commentaire.
+* subject` - Sujet du commentaire.
+* `date` - Indique la date du commentaire. Cette date peut utiliser presque
+ tous les formats, puisqu'elle est analysée par [[!cpan TimeDate]].
+* `username` - Sert pour l'enregistrement du nom (ou OpenID) d'un
+ commentateur présent.
+* `nickname` - Name to display for a logged in commenter. (Optional; used
+ for OpenIDs.)
+* `ip` - Permet d'enregistrer l'adresse IP d'un commentateur, s'il envoie
+ son commentaire de façon anonyme.
+* `claimedauthor` - Enregistre le nom donné par l'utilisateur, si les
+ commentateurs anonymes ont la possibilité d'indiquer un nom (invérifié).
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/cutpaste.mdwn b/ikiwiki/directive/cutpaste.mdwn
new file mode 100644
index 0000000..62ea32b
--- /dev/null
+++ b/ikiwiki/directive/cutpaste.mdwn
@@ -0,0 +1,53 @@
+Les directives `copy`, `cut` and `paste` sont fournies par le module
+d'extension [[!iki plugins/cutpaste desc=cutpaste]].
+
+Ces directives permettent de sauvegarder et rappeler des parties de texte
+d'une page.
+
+ * `\[[!cut id=name text="text"]]` garde en mémoire le texte, qui peut être
+ rappelé grâce à l'id. Le texte coupé n'est pas inclus dans la sortie.
+ * `\[[!copy id=name text="text"]]` garde en mémoire le texte, qui peut être
+ rappelé grâce à l'id. Le texte coupé *est* inclus dans la sortie.
+ * `\[[!paste id=name]]` est remplacé par le texte précédemment mis en
+ mémoire.
+
+Le texte coupé, copié ou collé peut être inclus dans une balise wiki, avec
+d'autres appels encore aux directives cut, copy et paste.
+
+Il n'est pas nécessaire de mettre en mémoire le texte avant de
+l'utiliser. Une directive « cut » peut suivre une directive « paste » qui
+utilise le texte. Pouvoir différer de gros morceaux de texte comme de
+longues annotations et pouvoir suivre un cours plus naturel est très
+pratique. Par exemple :
+
+ \[[!toggleable id="cut" text="[[!paste id=cutlongdesc]]"]]
+ \[[!toggleable id="copy" text="[[!paste id=copylongdesc]]"]]
+ \[[!toggleable id="paste" text="[[!paste id=pastelongdesc]]"]]
+
+ [...some time later...]
+
+ \[[!cut id=cutlongdesc text="""
+ blah blah blah
+ """]]
+ \[[!cut id=copylongdesc text="""
+ blah blah blah
+ """]]
+ \[[!cut id=pastelongdesc text="""
+ blah blah blah
+ """]]
+
+Des boucles peuvent résulter mais ikiwiki est intelligent et les rompt.
+
+Puisqu'il est possible de coller sans doubler les guillemets, ces directives
+copy et paste peuvent servir à emboîter des directives qui demandent des
+paramètres à plusieurs lignes insérés l'un dans l'autre :
+
+ \[[!toggleable id=foo text="""
+ [[!toggleable id=bar text="[[!paste id=baz]]"]]
+ """]]
+
+ \[[!cut id=baz text="""
+ multiline parameter!
+ """]]
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/edittemplate.mdwn b/ikiwiki/directive/edittemplate.mdwn
new file mode 100644
index 0000000..a4f90c1
--- /dev/null
+++ b/ikiwiki/directive/edittemplate.mdwn
@@ -0,0 +1,39 @@
+La directive `edittemplate` est fournie par le greffon [[!iki
+plugins/edittemplate desc=edittemplate]].
+
+Cette directive permet l'enregistrement de modèles de pages, qui proposent
+un contenu par défaut aux pages nouvellement créées avec l'interface
+web. Pour enregistrer un modèle, il faut insérer une directive
+[[ikiwiki/directive/template]] dans une quelconque autre page.
+
+ \[[!edittemplate template="bugtemplate" match="bugs/*"]]
+
+Dans l'exemple ci-dessus, la page nommée « bugtemplate » est enregistrée
+comme modèle de page à utiliser pour toute page nommée « bugs/* » qui sera
+créée. Pour éviter que la directive n'affiche une note au sujet de
+l'enregistrement du modèle, il suffit d'activer le paramètre « silent=yes ».
+
+Souvent la page modèle contient le simple squelette d'une page
+particulière. Pour le modèle « rapport de bogue » dans l'exemple, ce
+squelette pourrait se présenter ainsi :
+
+ Paquet :
+ Version :
+ Reproductible : o/n
+ Détails :
+
+The template page can also contain [[!cpan HTML::Template]] directives,
+like other ikiwiki [[templates]]. Currently only one variable is
+set: `<TMPL_VAR name>` is replaced with the name of the page being
+created.
+
+----
+
+Ce n'est pas une bonne idée de mettre la directive `edittemplate` dans la
+page modèle elle-même. En effet la directive serait alors incluse comme
+partie du modèle sur les nouvelles pages, qui seraient à leur tour
+enregistrées comme modèles. Si de nombreuses pages sont enregistrées comme
+modèles pour une page, un modèle est choisi au hasard et tout devient
+confus.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/format.mdwn b/ikiwiki/directive/format.mdwn
new file mode 100644
index 0000000..da68ff0
--- /dev/null
+++ b/ikiwiki/directive/format.mdwn
@@ -0,0 +1,29 @@
+La directive `format` est fournie par le module d'extension [[!iki
+plugins/format desc=format]].
+
+Cette directive permet de formater un texte avec tout type de format
+disponible. Elle possède deux paramètres. Le premier est le format à
+utiliser, c'est-à-dire l'extension à donner à un fichier de ce type. Le
+second est le texte à formater.
+
+Par exemple, pour insérer un fichier outline (.otl) dans une page qui
+utilise mdwn ou un autre format :
+
+ \[[!format otl """
+ foo
+ 1
+ 2
+ bar
+ 3
+ 4
+ """]]
+
+Si le greffon highlight est activé, cette directive permet d'afficher un
+code dont la syntaxe est mise en évidence. Beaucoup de langages sont
+reconnus. Par exemple :
+
+ \[[!format perl """
+ print "hello, world\n";
+ """]]
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/fortune.mdwn b/ikiwiki/directive/fortune.mdwn
new file mode 100644
index 0000000..e52351c
--- /dev/null
+++ b/ikiwiki/directive/fortune.mdwn
@@ -0,0 +1,8 @@
+La directive `fortune` est fournie par le module d'extension [[!iki
+plugins/fortune desc=fortune]].
+
+Une petite sentence est insérée sur la page grâce au programme `fortune` :
+
+ \[[!fortune ]]
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/graph.mdwn b/ikiwiki/directive/graph.mdwn
new file mode 100644
index 0000000..ee92c5f
--- /dev/null
+++ b/ikiwiki/directive/graph.mdwn
@@ -0,0 +1,23 @@
+La directive `graph` est fournie par le module d'extension [[!iki
+plugins/graphviz desc=graphviz]].
+
+Cette directive permet d'embarquer des graphiques
+[graphviz](http://www.graphviz.org/) sur une page. Par exemple :
+
+ \[[!graph src="a -> b -> c; a -> c;"]]
+
+Vous ne pourrez prévisualiser les graphiques que si le navigateur gère les
+[[!wikipedia data: URI]], ou si le même graphique existe déjà sur la page.
+
+Voici les paramètres de la directive `graph` :
+
+- `src` - La source graphviz à afficher.
+- `type` - Le type de graphique : `graph` ou `digraph`. La valeur par
+ défaut est `digraph`.
+- `prog` - Le programme graphviz à utiliser : `dot`, `neato`, `fdp`,
+ `twopi`, ou `circo`. La valeur par défaut est `dot`.
+- `height`, `width` - Ces paramètres limitent la taille des graphiques, avec
+ une hauteur et une largeur exprimées en pouce. Vous devez les indiquer
+ tous les deux. Sinon le programme choisira une valeur sans limites.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/haiku.mdwn b/ikiwiki/directive/haiku.mdwn
new file mode 100644
index 0000000..a8b7bd1
--- /dev/null
+++ b/ikiwiki/directive/haiku.mdwn
@@ -0,0 +1,16 @@
+la directive `haiku` est fournie par le module d'extension [[!iki
+plugins/haiku desc=haiku]].
+
+Cette directive permet l'insertion d'un haiku créé automatiquement sur une
+page du wiki. Il suffit d'écrire :
+
+ \[[!haiku hint="argument"]]
+
+[[!haiku hint="argument test"]]
+
+Le paramètre "hint" peut être omis. Il ne donne au générateur qu'une idée du
+sujet du haiku. S'il est absent, le sujet est fondé sur le nom de la
+page. Comme le vocabulaire du programme est assez pauvre, il est inutile de
+donner beaucoups d'indications sur le thème du haiku.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/if.mdwn b/ikiwiki/directive/if.mdwn
new file mode 100644
index 0000000..baa629f
--- /dev/null
+++ b/ikiwiki/directive/if.mdwn
@@ -0,0 +1,48 @@
+La directive `if` est fournie par le module d'extension [[!iki
+plugins/conditional desc=conditional]].
+
+Cette directive permet de faire dépendre l'affichage de texte d'une
+condition donnée. Par exemple :
+
+ \[[!if test="enabled(smiley)"
+ then="Le greffon smiley est activé :-)"
+ else="Pas de greffon smiley ici..."]]
+
+Si le `test` réussit, le texte du paramètre `then` est affiché. Sinon, le
+texte du paramètre `else` est affiché. La partie `else` du test est
+facultative.
+
+Les valeurs de `then` et `else` peuvent inclure n'importe quelle balise qui
+serait autorisée dans les pages du wiki. Tripler les guillemets autour de la
+valeur permet même d'y inclure des guillemets.
+
+Le `test` est une spécification [[ikiwiki/PageSpec]]. Si une page correspond
+à l'expression, le test réussit. Vous pouvez ainsi tester l'existence d'une
+page ou de plusieurs, tester la date de création, etc.
+
+Si vous voulez confronter l'expression [[ikiwiki/PageSpec]] uniquement à la
+page qui contient la condition plutôt qu'à toutes les pages du wiki, il faut
+donner la valeur "no" au paramètre "all".
+
+Dans une directive `if`, la syntaxe normale d'une spécification
+[[ikiwiki/PageSpec]] est étendue avec les tests suivants :
+
+* enabled(greffon)
+
+ Ce test vérifie si le greffon indiqué est activé.
+
+* sourcepage(motif)
+
+ Ce test confronte le motif donné au nom de la page qui contient la condition.
+
+* destpage(motif)
+
+ Ce test confronte le motif donné au nom de la page qui est construite.
+ Ce nom peut être différent du nom de la page qui contient la condition,
+ si la page est reliée à une autre page.
+
+* included()
+
+ Ce test vérifie si la page est incluse dans une autre page.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/img.mdwn b/ikiwiki/directive/img.mdwn
new file mode 100644
index 0000000..7f53dd6
--- /dev/null
+++ b/ikiwiki/directive/img.mdwn
@@ -0,0 +1,42 @@
+La directive `img` est fournie par le module d'extension [[!iki plugins/img
+desc=img]].
+
+Cette directive est consacrée à la gestion des images. Ikiwiki permet de
+relier des images en taille réelle en faisant un [[ikiwiki/WikiLink]] qui
+pointe vers l'image. Avec cette directive vous pouvez facilement réduire la
+taille de l'image pour permettre son inclusion dans une page, tout en créant
+un lien vers l'image en taille réelle.
+
+## Usage
+
+ \[[!img image1.jpg size="200x200" alt="clouds"]]
+
+L'image est recherchée selon les mêmes règles utilisées pour chercher un
+fichier pointé par un [[ikiwiki/WikiLink]].
+
+Le paramètre `size` est facultatif. Par défaut la taille est la taille
+réelle. Le format d'image original est toujours respecté, même si cela
+signifie qu'il faut rendre l'image plus petite que la taille indiquée. Vous
+pouvez spécifier seulement la hauteur ou la largeur, et l'autre valeur sera
+calculée selon le format d'image, "200x", "x200".
+
+You can also pass `alt`, `title`, `class`, `align`, `id`, `hspace`, and
+`vspace` parameters. These are passed through unchanged to the html img
+tag. If you include a `caption` parameter, the caption will be displayed
+centered beneath the image.
+
+Le paramètre `link` contrôle la liaison entre l'image réduite et l'image à
+taille réelle. Par défaut il les relie. Vous pouvez définir "link=somepage"
+pour créer un lien vers une autre page, "link=no" pour désactiver le lien ou
+encore "link=http://url" pour créer un lien vers une URL.
+
+Vous pouvez aussi définir des valeurs par défaut qui seront utilisées pour
+toutes les images, sauf si ces valeurs sont annulées. C'est très utile quand
+on insère beaucoup d'images sur une page.
+
+ \[[!img defaults size=200x200 alt="wedding photo"]]
+ \[[!img photo1.jpg]]
+ \[[!img photo2.jpg]]
+ \[[!img photo3.jpg size=200x600]]
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/inline.mdwn b/ikiwiki/directive/inline.mdwn
new file mode 100644
index 0000000..2af6236
--- /dev/null
+++ b/ikiwiki/directive/inline.mdwn
@@ -0,0 +1,133 @@
+La directive `inline` est fournie par le module d'extension [[!iki
+plugins/inline desc=inline]].
+
+Cette directive permet l'inclusion d'une page de wiki dans une
+autre. L'utilisation la plus fréquente de cette directive est la création de
+blog ou de flux Atom ou RSS.
+
+Exemple :
+
+ \[[!inline pages="blog/* and !*/Discussion" show="10" rootpage="blog"]]
+
+Toute page correspondant à la spécification, [[PageSpec]], (dans l'exemple,
+toute [[SubPage]] de "blog") fera partie du blog et les dix dernières pages
+apparaîtront dans la page. Notez que les fichiers qui, sans être des pages,
+correspondent à la spécification, seront inclus dans la diffusion par RSS,
+ce qui est utile pour le « podcasting ».
+
+Le paramètre facultatif `rootpage` indique que les nouveaux messages de ce
+blog seront des sous-pages [[SubPages|SubPage]] de "blog". Il active aussi
+un formulaire en haut de la page du blog qui permet l'écriture de nouveaux
+messages.
+
+Si vous voulez que le blog possède une page d'archive, listant tous les
+messages déjà envoyés, voici ce qu'il faut faire :
+
+ \[[!inline pages="blog/* and !*/Discussion" archive="yes"]]
+
+Vous pouvez même créer une liste de toutes les pages du wiki, les plus
+récentes en tête, comme cela :
+
+ \[[!inline pages="* and !*/Discussion" archive="yes"]]
+
+Vous pouvez aussi ajouter des pages à un blog donné en les étiquetant. Pour
+étiqueter une page, il suffit de la lier à une ou plusieurs pages qui
+représentent cette étiquette. Puis, il faut utiliser une spécification
+[[PageSpec]] avec la fonction spéciale `link()` pour trouver toutes les
+pages correspondant à cette étiquette.
+
+ \[[!inline pages="link(rugby)"]]
+
+Vous pouvez aussi inclure certaines étiquettes et en exclure d'autres :
+
+ \[[!inline pages="link(debian) and !link(social)"]]
+
+## Usage
+
+Il est possible d'utiliser beaucoup de paramètres avec la directive
+`inline`. Voici les plus communs :
+
+* `pages` - Une spécification [[PageSpec]] des pages à relier.
+* `show` - Indique le nombre maximun de pages correspondantes à relier. Par
+ défaut, ce nombre vaut 10 sauf pour l'archivage où toutes les pages sont
+ reliées. La valeur 0 permet d'afficher toutes les pages correspondantes.
+* `archive` - Quand ce paramètre vaut "yes", on ne liste que le titre des
+ pages et certaines métadonnées, pas tout le contenu des pages.
+* `description` - donne le nom du flux RSS créé. Par défaut, c'est le nom du
+ wiki.
+* `skip` - Indique un nombre de pages à ne pas afficher. C'est utile pour
+ produire un flux qui ne montre que les pages archivées.
+* `postform` - Quand ce paramètre vaut "yes", le formulaire qui permet de
+ créer de nouvelles pages sur un blog est activé.
+* `postformtext` - Spécifie le texte affiché par le formulaire.
+* `rootpage` - Active le formulaire et indique l'endroit où les nouveaux
+ messages seront placés, en donnant la page dont ils seront des sous-pages.
+
+Voici quelques paramètres moins nécessaires :
+
+* `actions` - Quand ce paramètre vaut "yes", des liens permettant la
+ modification et la discussion sont ajoutés au bas des pages reliées plutôt
+ qu'en haut.
+* `rss` - Contrôler la création d'un flux RSS. Si le wiki est configuré par
+ défaut pour créer des flux rss, le mettre à "no" désactive la création de
+ flux. Si le wiki est configuré avec l'option `allowrss`, le mettre à
+ "yes" active la création de flux rss.
+* `atom` - Contrôler la création d'un flux Atom. Si le wiki est configuré
+ par défaut pour créer des flux Atom, le mettre à "no" désactive la
+ création de flux. Si le wiki est configuré avec l'option `allowatom`, le
+ mettre à "yes" active la création de flux Atom.
+* `feeds` - Contrôler la création de tout type de flux. Le mettre à "no"
+ pour désactiver la création de flux.
+* `emptyfeeds` - Mettre ce paramètre à "no" pour désactiver toute création
+ de flux vides. N'a aucun effet si le paramètre `rootpage` ou le paramètre
+ `postform` est activé.
+* `template` - Ce paramètre indique le modèle de page à utiliser pour chaque
+ page reliée. Par défaut le modèle utilisé est `inlinepage`. Pour les
+ archives, le modèle utilisé est `archivepage`. Il est possible d'utiliser
+ d'autres modèles comme `titlepage` qui n'affiche que le titre des
+ messages, ou `microblog`, optimisé pour le « microblogging », et même de
+ créer vos propres modèles. Notez que vous devez quand même activer le
+ paramètre archive, `archive=yes`, si votre modèle n'inclut pas le contenu
+ de la page.
+* `raw` - Si ce paramètre vaut "yes", la page sera incluse sous sa forme
+ « brute », sans balisage supplémentaire, comme si elle faisait partie de
+ la source de la page dans laquelle elle est incluse. Le comportement par
+ défaut de ce paramètre est de créer un blog.
+* `sort` - permet d'indiquer comment les pages liées sont triées
+ [[sorted|pagespec/sorting]]. Par défaut, les pages les plus récentes sont
+ triées en premier.
+* `reverse` - Si ce paramètre vaut "yes", l'ordre de classement est
+ renversé.
+* `feedshow` - Indique le nombre maximun de pages à inclure dans le flux
+ RSS/Atom. La valeur par défaut est la même que celle du paramètre `show`.
+* `feedonly` - Ne créer que le flux, ne pas afficher les pages reliées sur
+ la page.
+* `quick` - Construire l'archive en mode rapide, sans chercher les
+ métadonnées dans le contenu des pages. Cela désactive la création de flux.
+* `timeformat` - Ce paramètre permet d'indiquer la manière d'afficher
+ l'heure ou la date dans les pages de blog. Le format est passé à la
+ fonction strftime(3).
+* `feedpages` - Une spécification [[PageSpec]] des pages à inclure dans le
+ flux rss/atom. Par défaut, cette valeur est la même que celle du paramètre
+ `pages` et seules les pages correspondantes sont incluses, mais une
+ spécification plus précise peut en exclure certaines.
+* `guid` - Si une URI est donnée (peut-être un UUID préfixé, `urn:uuid:`),
+ le flux Atom aura cet identifiant, son `<id>`. Par défaut, l'URL de la
+ page contenant la directive `inline` est utilisée.
+* `feedfile` - On peut utiliser ce paramètre pour changer le nom du fichier
+ créé pour le flux. C'est très utile dans le cas d'une page qui contient
+ plusieurs flux. Par exemple, indiquez "feedfile=feed" pour créer un
+ fichier `page/feed.atom` ou `page/feed.rss`. Si le wiki est configuré pour
+ ne pas utiliser `usedirs`, ce paramètre ne fonctionne pas.
+* `pagenames` - Si ce paramètre est utilisé à la place de `pages`, il est
+ interprété comme une liste de liens, séparés par des espaces, avec les
+ mêmes règles [[SubPage/LinkingRules]] que dans un
+ [[ikiwiki/WikiLink]]. Ces liens sont reliés dans l'ordre dans lequel ils
+ sont listés : les paramètres `sort` et `pages` ne peuvent pas être
+ utilisés en même temps.
+
+[[!meta robots="noindex, follow"]]
+
+Une directive apparentée à cette directive est
+[[ikiwiki/directive/edittemplate]], qui permet d'indiquer un texte par
+défaut pour la nouvelle page.
diff --git a/ikiwiki/directive/linkmap.mdwn b/ikiwiki/directive/linkmap.mdwn
new file mode 100644
index 0000000..cc5e369
--- /dev/null
+++ b/ikiwiki/directive/linkmap.mdwn
@@ -0,0 +1,31 @@
+"La directive `linkmap` est fournie par le module d'extension [[!iki
+plugins/linkmap desc=linkmap]].
+
+Cette directive utilise le programme [graphviz](http://www.graphviz.org/)
+pour créer un graphique montrant les liens existants entre certaines pages
+du wiki. Par exemple :
+
+ \[[!linkmap pages="* and !blog/* and !*/Discussion"]]
+
+Seuls les liens entre les pages recherchées sont montrés. Des liens
+existants entre des pages non recherchées sont ignorés. Si les pages à
+rechercher ne sont pas spécifiées, les liens entre toutes les pages (et tous
+les fichiers) du wiki seront affichés.
+
+Voici la description des paramètres de la directive `linkmap` :
+
+* `pages` - Une spécification [[ikiwiki/PageSpec]] des pages à rechercher.
+* `height`, `width` - Ces paramètres limitent la taille du diagramme, avec
+ une hauteur et une largeur exprimées en pouce. Vous devez les indiquer
+ tous les deux. Sinon le programme choisira une valeur sans limites.
+* `connected` - permet d'indiquer si l'on inclut les pages sans lien à
+ d'autres pages (connected=no, par défaut), ou si l'on ne montre que les
+ pages liées à d'autres pages (connected=yes).
+
+Pour des résultats corrects, il vaut mieux définir l'ensemble des pages à
+rechercher. Sinon, le diagramme deviendra très grand, illisible et
+compliqué. Si l'on inclut trop de pages, le diagramme deviendra si grand que
+graphviz ne pourra pas l'afficher. Le paramètre `connected` permet de se
+débarrasser des pages qui encombrent le diagramme.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/listdirectives.mdwn b/ikiwiki/directive/listdirectives.mdwn
new file mode 100644
index 0000000..fee0118
--- /dev/null
+++ b/ikiwiki/directive/listdirectives.mdwn
@@ -0,0 +1,21 @@
+La directive `listdirectives` est fournie par le module d'extension [[!iki
+plugins/listdirectives desc=listdirectives]].
+
+Cette directive crée une liste des [[directives|ikiwiki/directive]]
+disponibles.
+
+ \[[!listdirectives]]
+
+Il n'y a qu'un seul paramètre facultatif, `generated`. Toutes les directives
+internes et les directives déclarées par les greffons seront listées. Avec
+ce paramètre, `listdirectives` listera aussi les directives qui viendront à
+être créées. Par exemple, tous les raccourcis [[shortcuts]] sont des
+directives créées par la directive `shortcut`. Ils seront listés si le
+paramètre `generated` est fourni.
+
+ \[[!listdirectives generated]]
+
+Cette liste est souvent très longue. Elle contient aussi beaucoup de
+directives non documentées.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/map.mdwn b/ikiwiki/directive/map.mdwn
new file mode 100644
index 0000000..f8ef0e6
--- /dev/null
+++ b/ikiwiki/directive/map.mdwn
@@ -0,0 +1,25 @@
+La directive `map` est fournie par le module d'extension [[!iki plugins/map
+desc=map]].
+
+Cette directive crée une représentation hiérarchisée des pages du
+wiki. Voici un exemple d'utilisation :
+
+ \[[!map pages="* and !blog/* and !*/Discussion"]]
+
+Si les pages à inclure ne sont pas spécifiées, toutes les pages (et tous les
+fichiers) sont pris en compte.
+
+Par défaut, les noms des pages sont utilisés dans la représentation. Le
+paramètre `show` permet d'utiliser à la place le titre des pages ou leur
+description lorsqu'ils ont été définis avec la directive [[meta]]. Par
+exemple :
+
+ \[[!map pages="* and !blog/* and !*/Discussion" show=title]]
+
+ \[[!map pages="* and !blog/* and !*/Discussion" show=description]]
+
+Pour n'afficher les pages que jusqu'à un certain niveau de profondeur, vous
+pouvez utiliser une spécification [[ikiwiki/PageSpec]] comme celle-ci :
+`pages=\"* and !*/*/*\"`.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/meta.mdwn b/ikiwiki/directive/meta.mdwn
new file mode 100644
index 0000000..32997d8
--- /dev/null
+++ b/ikiwiki/directive/meta.mdwn
@@ -0,0 +1,171 @@
+La directive `meta` est fournie par le module d'extension [[!iki
+plugins/meta desc=meta]].
+
+Cette directive permet l'insertion de métadonnées quelconques dans la source
+d'une page. Voici comment procéder :
+
+ \[[!meta field="valeur"]]
+ \[[!meta field="valeur" param="valeur" param="valeur"]]
+
+La première expression donne une valeur à un champ, tandis que la seconde
+définit également des sous-paramètres.
+
+La valeur d'un champ est traitée comme du texte codé en HTML. Vous pouvez
+inclure un guillemet en écrivant `&quot;` par exemple.
+
+Champs reconnus :
+
+* title
+
+ La valeur de ce champ remplace le titre d'une page, qui est en général
+ le nom de la page.
+
+ Si le titre est remplacé, une variable « title_overridden » est définie avec une valeur *true*
+ dans le modèle de page. On peut se servir de cette variable pour formater le texte différemment.
+
+ An optional `sortas` parameter will be used preferentially when
+ [[ikiwiki/pagespec/sorting]] by `meta(title)`:
+
+ \[[!meta title="The Beatles" sortas="Beatles, The"]]
+
+ \[[!meta title="David Bowie" sortas="Bowie, David"]]
+
+* license
+
+ Indique la license de la page, par exemple « GPL ». Peut contenir des WikiLinks
+ et des balises quelconques.
+
+* copyright
+
+ Indique le copyright de la page, par exemple « Copyright 2007 by Joey Hess ».
+ Peut contenir des WikiLinks et des balises quelconques.
+
+* author
+
+ L'auteur de la page.
+
+ An optional `sortas` parameter will be used preferentially when
+ [[ikiwiki/pagespec/sorting]] by `meta(author)`:
+
+ \[[!meta author="Joey Hess" sortas="Hess, Joey"]]
+
+* authorurl
+
+ Indique une URL pour l'auteur de la page.
+
+* description
+
+ Donne une courte description de la page qui sera placée dans l'en-tête html
+ et qui peut être affichée par la directive [[map]].
+
+* permalink
+
+ Indique un lien permanent vers la page, si différent de la page créée par ikiwiki.
+
+* date
+
+ Indique la date de création de la page. Tous les formats de date sont reconnus, puisque la valeur
+ de ce champ est analysée par [[!cpan TimeDate]].
+
+* stylesheet
+
+ Ajoute une feuille de style à la page. La feuille de style est traitée
+ comme un lien wiki vers un fichier `.css` dans le wiki. On ne peut donc pas
+ ajouter de liens vers des feuilles de style externes. Par exemple :
+
+ \[[!meta stylesheet=somestyle rel="alternate stylesheet"
+ title="somestyle"]]
+
+* openid
+
+ Ajoute des balises HTML &lt;link&gt; pour réaliser une délégation OpenID
+ à un serveur OpenID externe. Cela permet d'utiliser une page de wiki comme
+ votre identifiant OpenID.
+
+ Par défaut la délégation se fera pour `openid` et `openid2`. Pour n'en choisir qu'un,
+ ajoutez par exemple ce paramètre : `delegate=openid`.
+
+ Un paramètre facultatif `xrds-location` permet d'indiquer l'adresse de tout
+ [eXtensible Resource DescriptorS](http://www.windley.com/archives/2007/05/using_xrds.shtml).
+
+ Exemple :
+
+ \[[!meta openid="http://joeyh.myopenid.com/"
+ server="http://www.myopenid.com/server"
+ xrds-location="http://www.myopenid.com/xrds?username=joeyh.myopenid.com""]]
+
+* link
+
+ Indique un lien vers une autre page. C'est une façon de lier deux pages
+ sans afficher un [[ikiwiki/WikiLink]] qui serait visible par l'utilisateur :
+
+ \[[!meta link=otherpage]]
+
+ On peut aussi s'en servir pour insérer une balise HTML &lt;link&gt;. Par exemple :
+
+ \[[!meta link="http://joeyh.myopenid.com/" rel="openid.delegate"]]
+
+ Cependant cette expression ne sera pas permise si le greffon
+ [[!iki plugins/htmlscrubber desc=htmlscrubber]] est activé,
+ car il permet d'insérer des contenus non sécurisés.
+
+* redir
+
+ Rend possible la redirection d'une page vers une autre dans le wiki.
+
+ \[[!meta redir=otherpage]]
+
+ Un délai (en seconde) peut être indiqué. Par défaut, il n'y a pas de délai.
+
+ Une redirection vers une URL externe est aussi possible. Par exemple :
+
+ \[[!meta redir="http://example.com/"]]
+
+ Cependant cette expression ne sera pas permise si le greffon
+ [[!iki plugins/htmlscrubber desc=htmlscrubber]] est activé,
+ car il permet d'insérer des contenus non sécurisés.
+
+ Dans les deux cas, on peut indiquer une ancre à l'intérieur de la page visée,
+ avec la syntaxe habituelle `#ANCHOR`.
+
+* robots
+
+ Permet l'écriture de l'étiquette robots :
+
+ \[[!meta robots="index, nofollow"]]
+
+ L'attribut peut prendre les valeurs suivantes : "index", "noindex", "follow"
+ et "nofollow". On peut indiquer plusieurs valeurs, séparées par une virgule.
+ Seules quelques combinaisons cependant ont du sens. Si l'étiquette robots
+ n'existe pas, "index, follow" est utilisée par défaut.
+
+ La valeur est protégée mais son contenu n'est pas vérifié.
+
+* guid
+
+ Indique l'identificateur unique (*GUID*) d'une page. Cet identificateur
+ doit être un URI, en particulier, il peut être de la forme `urn:uuid:` suivi
+ d'un UUID, comme indiqué dans le [[!rfc 4122]]). Il permet l'identification d'une
+ page pour un flux RSS ou Atom. S'il n'est pas donné, l'URL de la page
+ est utilisée comme GUID.
+
+ Sa principale utilisation est de garder inchangés les identificateurs des pages
+ qui ont été déplacées, évitant ainsi l'engorgement des agrégateurs.
+ Consultez [[!iki tips/howto_avoid_flooding_aggregators]]).
+
+* updated
+
+ Indique une date de modification fausse pour une page qui doit être affichée
+ dans les flux RSS ou Atom. Cela permet d'éviter l'engorgement des agrégateurs
+ qui classent les pages par date de modification, comme Planet par exemple.
+ Pour ajouter des étiquettes à un ancien message, vous pouvez mettre une valeur
+ supérieure d'une seconde à l'ancienne valeur. Tous les formats de date reconnus par
+ [[!cpan TimeDate]] sont acceptés, tout comme pour le paramètre `date`.
+
+Si le paramètre n'est pas l'un de ceux définis précédemment, les métadonnées
+seront écrites sur la page HTML créée sous forme d'en-tête
+&lt;meta&gt;. Cependant cette expression ne sera pas permise si le greffon
+[[!iki plugins/htmlscrubber desc=htmlscrubber]] est activé, car il permet
+d'insérer des contenus non sécurisés.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/more.mdwn b/ikiwiki/directive/more.mdwn
new file mode 100644
index 0000000..2f61266
--- /dev/null
+++ b/ikiwiki/directive/more.mdwn
@@ -0,0 +1,18 @@
+La directive `more` est fournie par le module d'extension [[!iki
+plugins/more desc=more]].
+
+Cette directive permet d'insérer un lien "more" sur le message d'un blog. Ce
+lien pointe vers la version complète de la page. Voici comment l'utiliser :
+
+ \[[!more linktext="click for more" text="""
+ Voici la suite du message. Ce n'est pas à l'intention des gens rattrapant
+ leur retard dans la lecture de leurs blogs à 10000 mètres d'altitude. Parce que
+ j'aime rendre les choses difficiles.
+ """]]
+
+Si le paramètre `linktext` est omis, la valeur par défaut du lien est
+"more".
+
+Vous pouvez obtenir quelque chose de semblable avec [[toggle]].
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/orphans.mdwn b/ikiwiki/directive/orphans.mdwn
new file mode 100644
index 0000000..90f653d
--- /dev/null
+++ b/ikiwiki/directive/orphans.mdwn
@@ -0,0 +1,17 @@
+La directive `orphans` est fournie par le module d'extension [[!iki
+plugins/orphans desc=orphans]].
+
+Cette directive crée une liste des pages probablement orphelines,
+c'est-à-dire des pages qui ne sont liées à aucune autre page. Exemple :
+
+ \[[!orphans pages="* and !blog/*"]]
+
+Le paramètre facultatif "pages" peut être une spécification
+[[ikiwiki/PageSpec]] indiquant un ensemble de pages à vérifier. Par défaut
+la recherche se fait dans toutes les pages.
+
+Notez que les rétroliens sont pris en compte. Mais relier une page à une
+autre n'est pas considéré comme un lien et les pages d'un blog seront
+comptées parmi les pages orphelines.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/pagecount.mdwn b/ikiwiki/directive/pagecount.mdwn
new file mode 100644
index 0000000..be299b9
--- /dev/null
+++ b/ikiwiki/directive/pagecount.mdwn
@@ -0,0 +1,12 @@
+La directive `pagecount` est fournie par le module d'extension [[!iki
+plugins/pagecount desc=pagecount]].
+
+Cette directive compte les pages du wiki. Exemple :
+
+ \[[!pagecount pages="*"]]
+
+Le paramètre facultatif "pages" peut être une spécification
+[[ikiwiki/PageSpec]] indiquant un ensemble de pages à compter. Par défaut
+toutes les pages du wiki sont comptées.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/pagestats.mdwn b/ikiwiki/directive/pagestats.mdwn
new file mode 100644
index 0000000..c1d78f9
--- /dev/null
+++ b/ikiwiki/directive/pagestats.mdwn
@@ -0,0 +1,42 @@
+La directive `pagestats` est fournie par le module d'extension [[!iki
+plugins/pagestats desc=pagestats]].
+
+Cette directive permet de créer des statistiques sur les pages et la façon
+dont elles sont liées. Elle affiche soit un nuage d'étiquettes, soit un
+tableau montrant le nombre de liens de chaque page.
+
+Here's how to use it to create a [[tag]] cloud, with tags sized based on
+frequency of use:
+
+ \[[!pagestats pages="tags/*"]]
+
+Voici comment afficher une liste d'étiquettes, avec la taille des étiquettes
+proportionnelle à la fréquence d'utilisation, comme pour un nuage :
+
+ \[[!pagestats style="list" pages="tags/*"]]
+
+Et voici comment créer un tableau de toutes les pages du wiki :
+
+ \[[!pagestats style="table"]]
+
+Le paramètre facultatif `among` permet de limiter l'ensemble des pages à
+considérer. Par exemple, pour afficher un nuage avec les étiquettes
+utilisées dans un blog, tout en ignorant les autres pages qui ont ces
+étiquettes, on peut écrire :
+
+ \[[!pagestats pages="tags/*" among="blog/posts/*"]]
+
+Pour afficher un nuage avec les étiquettes consacrées à Linux, écrivez :
+
+ \[[!pagestats pages="tags/* and not tags/linux" among="tagged(linux)"]]
+
+Le paramètre optionnel `show` permet d'afficher un nombre déterminé de
+pages. Par exemple, pour afficher les dix premières pages en terme de nombre
+de liens :
+
+ \[[!pagestats style="table" show="10"]]
+
+The optional `class` parameter can be used to control the class of the
+generated tag cloud `div` or page stats `table`.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/pagetemplate.mdwn b/ikiwiki/directive/pagetemplate.mdwn
new file mode 100644
index 0000000..6a10114
--- /dev/null
+++ b/ikiwiki/directive/pagetemplate.mdwn
@@ -0,0 +1,14 @@
+La directive `pagetemplate` est fournie par le module d'extension [[!iki
+plugins/pagetemplate desc=pagetemplate]].
+
+This directive allows a page to be displayed using a different
+[[template|templates]] than the default `page.tmpl` template.
+
+Le texte de la page est inséré dans le modèle. Ainsi le modèle commande
+l'allure générale de la page. Cette directive agit différemment de la
+directive [[ikiwiki/directive/template]] qui permet d'insérer des modèles _à
+l'intérieur_ du corps d'une page.
+
+ \[[!pagetemplate template="my_fancy.tmpl"]]
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/ping.mdwn b/ikiwiki/directive/ping.mdwn
new file mode 100644
index 0000000..9b1c55a
--- /dev/null
+++ b/ikiwiki/directive/ping.mdwn
@@ -0,0 +1,20 @@
+La directive `ping` est fournie par le module d'extension [[!iki
+plugins/pinger desc=pinger]].
+
+Cette directive permet de configurer ikiwiki pour qu'il visite une URL à
+chaque mise à jour du wiki. Utilisée avec le greffon [[!iki plugins/pingee
+desc=pingee]], elle permet de mettre en place un réseau avec des miroirs
+couplés ou une version « branche » d'un wiki. En visitant le miroir ou la
+branche à chaque modification du wiki principal, ils peuvent être gardés à
+jour.
+
+ \[[!ping from="http://mywiki.com/"
+ to="http://otherwiki.com/ikiwiki.cgi?do=ping"]]
+
+Le paramètre "from" doit être identique à l'URL du wiki qui effectue le
+*ping*, de manière à éviter les boucles.
+
+Le paramètre "to" est l'URL à visiter. L'exemple montre comment visiter une
+autre instance d'ikiwiki.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/poll.mdwn b/ikiwiki/directive/poll.mdwn
new file mode 100644
index 0000000..8eb3592
--- /dev/null
+++ b/ikiwiki/directive/poll.mdwn
@@ -0,0 +1,28 @@
+La directive `poll` est fournie par le module d'extension [[!iki
+plugins/poll desc=poll]].
+
+Cette directive permet d'organiser des sondages en ligne sur le wiki. Voici
+un exemple d'utilisation :
+
+ \[[!poll 0 "red" 0 "green" 0 "blue"]]
+
+Chaque chiffre indique le nombre d'utilisateurs qui ont voté pour ce
+choix. Quand quelqu'un vote pour un choix, la page est modifiée et le nombre
+augmente.
+
+Des précautions élémentaires sont prises pour éviter qu'on puisse voter deux
+fois. Cependant ce type de consultation n'est pas très précis et les
+préventions habituelles contre les sondages en ligne s'appliquent
+aussi. Quand la page du sondage n'est pas verrouillée, les utilisateurs
+peuvent même modifier la page et changer les chiffres !
+
+Paramètres :
+
+* `open` - Indique s'il est possible de voter. Il faut indiquer la valeur
+ "no" pour terminer la consultation.
+* `total` - Affiche le nombre total de votes au bas de la consultation. La
+ valeur par défaut est "yes".
+* `percent` - Indique s'il faut montrer des pourcentages. La valeur par
+ défaut est "yes".
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/polygen.mdwn b/ikiwiki/directive/polygen.mdwn
new file mode 100644
index 0000000..fb662e1
--- /dev/null
+++ b/ikiwiki/directive/polygen.mdwn
@@ -0,0 +1,12 @@
+La directive `polygen` est fournie par le module d'extension [[!iki
+plugins/polygen desc=polygen]].
+
+Cette directive permet l'insertion d'un texte créé par polygen dans une page
+de wiki. Par exemple :
+
+ \[[!polygen grammar="genius"]]
+
+Il est aussi possible d'indiquer un symbole non-terminal pour la grammaire
+en incluant `symbol="text"` dans la directive.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/postsparkline.mdwn b/ikiwiki/directive/postsparkline.mdwn
new file mode 100644
index 0000000..6b9bd0a
--- /dev/null
+++ b/ikiwiki/directive/postsparkline.mdwn
@@ -0,0 +1,49 @@
+La directive `postsparkline` est fournie par le module d'extension [[!iki
+plugins/postsparkline desc=postsparkline].
+
+Cette directive se sert du greffon [[!iki plugins/sparkline desc=sparkline]]
+pour créer une [[sparkline]], c'est-à-dire un mini graphique de statistiques
+au sujet d'un ensemble de pages, comme par exemple les messages d'un blog.
+
+# Exemples
+
+ Post interval:
+ \[[!postsparkline pages="blog/* and !*/Discussion" max=100
+ formula=interval style=bar barwidth=2 barspacing=1 height=13]]
+
+ Posts per month this year:
+ \[[!postsparkline pages="blog/* and !*/Discussion" max=12
+ formula=permonth style=bar barwidth=2 barspacing=1 height=13]]
+
+# Usage
+
+Toutes les options, à part les options `pages`, `max`, `formula`, `time` et
+`color` sont les mêmes que dans la directive [[sparkline]].
+
+Vous n'avez pas besoin d'indiquer des points de données. Mais c'est possible
+si vous le souhaitez. En fait, les points de données sont automatiquement
+créés à partir des dates de création des pages correspondant à la
+spécification [[ikiwiki/PageSpec]] `pages`. Un maximum de `max` points de
+données sont créés.
+
+Le paramètre `formula` précise la formule utilisée pour créer les points de
+données. Les formules disponibles sont les suivantes :
+
+* `interval` - La hauteur de chaque point représente la durée depuis le
+ précédent message.
+* `perday` - Chaque point représente un jour. La hauteur représente le
+ nombre de messages envoyés ce jour-là.
+* `permonth` - Chaque point représente un mois. La hauteur représente le
+ nombre de messages envoyés pendant ce mois.
+* `peryear` - Chaque point représente une année. La hauteur représente le
+ nombre de messages envoyés pendant cette année.
+
+Le paramètre `time` possède une valeur par défaut, "ctime", puisque les
+formules utilisent par défaut la date de création des pages. Si vous
+préférez qu'elles utilisent la date de modification, passez la valeur du
+paramètre à "mtime".
+
+Pour modifier la couleur de la ligne-étincelle, utilisez le paramètre
+`color`. Par exemple, "color=red".
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/progress.mdwn b/ikiwiki/directive/progress.mdwn
new file mode 100644
index 0000000..c809b99
--- /dev/null
+++ b/ikiwiki/directive/progress.mdwn
@@ -0,0 +1,20 @@
+La directive `progress` est fournie par le module d'extension [[!iki
+plugins/progress desc=progress]].
+
+Cette directive affiche une barre de progression.
+
+Deux ensembles de paramètres sont disponibles. le premier est composé d'un
+seul paramètre "percent" qui indique le pourcentage de remplissage de la
+barre.
+
+Le second ensemble est composé de deux spécifications [[ikiwiki/PageSpec]],
+`totalpages` et `donepages`. La directive compte le nombre de pages
+correspondant à chaque spécification et affiche le pourcentage de pages déjà
+traitées.
+
+Par exemple, pour afficher le pourcentage de pages qui possèdent des pages
+discussion :
+
+ \[[!progress totalpages="* and !*/Discussion" donepages="*/Discussion"]]
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/shortcut.mdwn b/ikiwiki/directive/shortcut.mdwn
new file mode 100644
index 0000000..845e2f2
--- /dev/null
+++ b/ikiwiki/directive/shortcut.mdwn
@@ -0,0 +1,10 @@
+La directive `shortcut` est fournie par le module d'extension [[!iki
+plugins/shortcut desc=shortcut]].
+
+Cette directive permet l'utilisation de raccourcis. Un raccourci est un lien
+externe qui permet de renvoyer facilement à des sites connus.
+
+Les raccourcis disponibles sont définis sur la page [[shortcuts]] du
+wiki. La directive `shortcut` ne peut être utilisée que sur cette page.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/sparkline.mdwn b/ikiwiki/directive/sparkline.mdwn
new file mode 100644
index 0000000..a6edb6a
--- /dev/null
+++ b/ikiwiki/directive/sparkline.mdwn
@@ -0,0 +1,58 @@
+La directive `sparkline` est fournie par le module d'extension [[!iki
+plugins/sparkline desc=sparkline]].
+
+Cette directive permet d'embarquer des lignes-étincelles (*sparklines*) ou
+mini graphiques dans les pages d'un wiki. Une ligne-étincelle est un mini
+graphique, simple et proche d'un mot, affichable au fil du texte.
+
+# Exemples
+
+ \[[!sparkline 1 3 5 -3 10 0 width=40 height=16
+ featurepoint="4,-3,red,3" featurepoint="5,10,green,3"]]
+
+Cet exemple affiche un mini graphique de plusieurs points. Sa largeur est de
+40 pixels et sa hauteur, 16 pixels. Le *haut* est désigné par un point vert
+et le *bas* par un point rouge.
+
+ \[[!sparkline 1 -1(red) 1 -1(red) 1 1 1 -1(red) -1(red) style=bar barwidth=2
+ barspacing=1 height=13]]
+
+Cet exemple plus complexe engendre un histogramme. La largeur des barres est
+de 2 pixels avec une séparation de 1 pixel et la hauteur du graphique est de
+13 pixels. La largeur de l'histogramme est déterminée automatiquement. Les
+points dont la valeur est négative sont en rouge, au lieu de noir, valeur
+par défaut.
+
+# Usage
+
+Le format des points de données est "x,y" ou simplement "y" si la valeur "x"
+n'importe pas. On peut aussi ajouter un paramètre "(color)" pour spécifier
+la couleur d'une barre.
+
+Les paramètres suivants sont reconnus. La plupart d'entre eux sont les mêmes
+que ceux de la bibliothèque sparkline sous-jacente et sont documentés avec
+plus de précisions dans [son wiki](http://sparkline.wikispaces.com/usage).
+
+* `style` - soit "line" (valeur par défaut) ou "bar".
+* `width` - largeur du graphique en pixels. Nécessaire seulement pour les
+ graphiques ligne.
+* `height` - Hauteur du graphique en pixels. La valeur par défaut est 16.
+* `barwidth` - Largeur des barres dans un histogramme. La valeur par défaut
+ est 1 pixel.
+* `barspacing` - Espacement entre les barres dans un histogramme. La valeur
+ par défaut est 1 pixel.
+* `ymin`, `ymax` - Valeurs minimum et maximum pour l'axe des Y. Elles sont
+ normalement calculées automatiquement mais on peut vouloir les préciser
+ pour obtenir les mêmes valeurs pour plusieurs graphiques apparentés.
+* `featurepoint` - Ajoute un cercle sur un graphique ligne, avec un texte
+ facultatif. On peut ainsi mettre en évidence certains points
+ significatifs.
+
+ La valeur est une liste de paramètres, séparés par des virgules, spécifiant
+ le point à cercler : valeur X, valeur Y, couleur, diamètre du cercle, texte (facultatif),
+ et position du texte (facultatif). Exemple : `featurepoint="3,5,blue,3"`.
+
+ Les valeurs disponibles pour la position du texte sont : "top", "right", "bottom"
+ et "left".
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/table.mdwn b/ikiwiki/directive/table.mdwn
new file mode 100644
index 0000000..9631008
--- /dev/null
+++ b/ikiwiki/directive/table.mdwn
@@ -0,0 +1,51 @@
+La directive `table` est fournie par le module d'extension [[!iki
+plugins/table desc=table]].
+
+Cette directive permet l'affichage de tableau HTML à partir de données au
+format CSV (comma-separated values) ou DSV (delimiter-separated values).
+
+## exemples
+
+ \[[!table data="""
+ Customer |Amount
+ Fulanito |134,34
+ Menganito|234,56
+ Menganito|234,56
+ """]]
+
+ \[[!table class="book_record" format=csv file="data/books/record1"]]
+
+Dans cet exemple, la page `record1` devrait ressembler à :
+
+ "Title","Perl Best Practices"
+ "Author","Damian Conway"
+ "Publisher","O’Reilly"
+
+Pour qu'une cellule s'étende sur plusieurs colonnes, il faut la faire suivre
+par une cellule vide, ou plusieurs. Par exemple :
+
+ \[[!table data="""
+ left||right|
+ a|b|c|d
+ cette cellule prend 4 colonnes|||
+ """]]
+
+## Usage
+
+* `data` - Valeurs pour le tableau.
+* `file` - Fichier dans le wiki contenant les données.
+* `format` - Le format des données, "csv", "dsv", ou "auto" (valeur par
+ défaut).
+* `delimiter` - Le caractère servant à délimiter les champs. Par défaut, le format CSV utilise une virgule (`,`)
+ et le format DSV utilise une barre verticale (`|`).
+* `class` - Une classe CSS pour l'élément HTML table.
+* `header` - Par défaut, ou si sa valeur est "row", la première ligne des données est utilisée
+ comme en-tête du tableau. Si la valeur est "no", le tableau n'a pas d'en-tête et si la valeur
+ est "column", la première colonne constitue l'en-tête.
+
+For tab-delimited tables (often obtained by copying and pasting from HTML or
+a spreadsheet), `delimiter` must be set to a literal tab character. These
+are difficult to type in most web browsers - copying and pasting one from
+the table data is likely to be the easiest way.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/tag.mdwn b/ikiwiki/directive/tag.mdwn
new file mode 100644
index 0000000..01fab40
--- /dev/null
+++ b/ikiwiki/directive/tag.mdwn
@@ -0,0 +1,37 @@
+Les directives `tag` et `taglink` sont fournies par le module d'extension
+[[!iki plugins/tag desc=tag]].
+
+Elles permettent d'étiqueter les pages. Ainsi :
+
+ \[[!tag tech life linux]]
+
+Les étiquettes sont comme des [[ikiwiki/WikiLink]] (cachés) sur une
+page. Vous pouvez donc utiliser une spécification [[ikiwiki/PageSpec]] pour
+trouver toutes les pages possédant une étiquette particulière. Les
+étiquettes apparaissent sur les messages des blogs, au bas des pages
+étiquetées ainsi que dans les flux RSS et Atom.
+
+Si vous voulez que l'étiquette soit visible comme un [[ikiwiki/WikiLink]],
+utilisez taglink :
+
+ \[[!taglink foo]]
+ \[[!taglink tagged_as_foo|foo]]
+
+Note that if the wiki is configured to use a tagbase, then the tags will be
+located under a base directory, such as "tags/". This is a useful way to
+avoid having to write the full path to tags, if you want to keep them
+grouped together out of the way. Also, since ikiwiki then knows where to put
+tags, it will automatically create tag pages when new tags are used.
+
+S'il existe un répertoire d'étiquettes, vous devrez le spécifier dans la
+fonction spéciale `link()` d'une [[ikiwiki/PageSpec]] : par exemple, si le
+répertoire d'étiquettes est `tag`, vous chercherez les pages étiquetées
+« foo » avec `link(tag/foo)`.
+
+Si pour une étiquette vous voulez éviter le répertoire d'étiquettes, vous
+pouvez écrire quelque chose comme ça :
+
+ \[[!tag /foo]]
+ \[[!taglink /foo]]
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/template.mdwn b/ikiwiki/directive/template.mdwn
new file mode 100644
index 0000000..e4f3a93
--- /dev/null
+++ b/ikiwiki/directive/template.mdwn
@@ -0,0 +1,85 @@
+La directive `template` est fournie par le module d'extension [[!iki
+plugins/template desc=template]].
+
+Cette directive permet d'utiliser des pages de wiki comme modèles. Ces
+modèles peuvent être remplis et insérés dans d'autres pages du wiki. La page
+[[templates]] liste les modèles utilisables avec cette directive.
+
+Cette directive possède un paramètre `id` qui identifie le modèle à
+utiliser. Les autres paramètres servent à remplir le modèle.
+
+## Exemple :
+
+ \[[!template id=note text="""Here is the text to insert into my note."""]]
+
+Cette expression remplit le modèle `note`, remplaçant le champ `text` par la
+valeur spécifiée, et insérant le résultat dans la page.
+
+## Utilisation d'un modèle
+
+Une valeur peut contenir tout marquage autorisé dans une page de wiki
+externe au modèle. On peut même inclure des guillemets dans la valeur, en
+les triplant. Avec des valeurs sur plusieurs lignes entre guillemets, on
+peut ainsi insérer de longs passages de texte dans un modèle.
+
+ \[[!template id=foo name="Sally" color="green" age=8 notes="""
+ * \[[Charley]]'s sister.
+ * "I want to be an astronaut when I grow up."
+ * Really 8 and a half.
+ """]]
+
+## Création d'un modèle
+
+Le modèle est une simple page de wiki, située dans le sous-répertoire
+`templates/` du répertoire source du wiki.
+
+Il est aussi possible de conserver les modèles dans un répertoire extérieur
+au wiki, comme des fichiers avec l'extension ".tmpl". Par défaut ces
+fichiers sont recherchés dans `/usr/share/ikiwiki/templates`. Le paramètre
+`templatedir` peut être utilisé pour commencer la recherche dans un autre
+répertoire.
+
+Le modèle utilise la syntaxe du module Perl [[!cpan HTML::Template]] qui
+permet de faire des choses assez compliquées. Consultez la documentation
+mais vous n'avez besoin de connaître que peu de choses :
+
+* Chaque paramètre passé à la directive template créera une variable pour le
+ modèle. Certaines variables sont prédéfinies comme PAGE et BASENAME.
+* Pour insérer la valeur d'une variable, utilisez `<TMPL_VAR variable>`. Le
+ marquage wiki dans la valeur sera d'abord converti en HTML.
+* Pour insérer la valeur brute d'une variable, sans conversion en HTML du
+ marquage wiki, utilisez `<TMPL_VAR raw_variable>`.
+* Pour rendre un texte dépendant d'une variable, utilisez `<TMPL_IF
+ variable>text</TMPL_IF>`
+* Pour utiliser un texte quand une variable est définie et un autre texte
+ quand elle n'est pas définie, utilisez `<TMPL_IF
+ variable>text<TMPL_ELSE>other text</TMPL_IF>`
+
+Voici un exemple :
+
+ <span class="infobox">
+ Name: \[[<TMPL_VAR raw_name>]]<br />
+ Age: <TMPL_VAR age><br />
+ <TMPL_IF color>
+ Favorite color: <TMPL_VAR color><br />"
+ <TMPL_ELSE>
+ No favorite color.<br />
+ </TMPL_IF>
+ <TMPL_IF notes>
+ <hr />
+ <TMPL_VAR notes>
+ </TMPL_IF>
+ </span>
+
+Le modèle rempli sera formaté comme le reste de la page dans laquelle il se
+trouve. Vous pouvez donc inclure des WikiLinks ou d'autres marquages wiki
+dans le modèle. Cependant ces WikiLinks n'apparaîtront pas comme des
+rétroliens vers la page qui utilise ce modèle.
+
+Remarquez l'utilisation de "raw_name" dans [[ikiwiki/WikiLink]] de l'exemple
+ci-dessus. Ainsi, si le nom peut être confondu avec un marquage wiki, il
+n'est pas converti en html avant d'être créé en tant que
+[[ikiwiki/WikiLink]].
+
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/testpagespec.mdwn b/ikiwiki/directive/testpagespec.mdwn
new file mode 100644
index 0000000..9ce2308
--- /dev/null
+++ b/ikiwiki/directive/testpagespec.mdwn
@@ -0,0 +1,28 @@
+La directive `testpagespec` est fournie par le module d'extension [[!iki
+plugins/testpagespec desc=testpagespec]].
+
+Cette directive permet de confronter une spécification [[ikiwiki/PageSpec]]
+et une page, puis de voir quelle partie correspond ou quelle partie provoque
+l'échec du test.
+
+Exemples :
+
+ \[[!testpagespec pagespec="foopage and barpage" match="foopage"]]
+
+ Cette expression affichera quelque chose comme "no match: barpage does not
+match foopage", mettant en évidence la partie de la spécification
+[[ikiwiki/PageSpec]] qui provoque l'échec.
+
+ \[[!testpagespec pagespec="foopage or !bar*" match="barpage"]]
+
+Cette expression affichera quelque chose comme "no match: bar* matches
+barpage", puisque la partie de la spécification [[ikiwiki/PageSpec]] qui
+fait échouer le test est le motif nié.
+
+ \[[!testpagespec pagespec="foopage or barpage" match="barpage"]]
+
+Cette expression affichera quelque chose comme "match: barpage matches
+barpage", indiquant la partie de la spécification [[ikiwiki/PageSpec]] qui
+fait réussir le test.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/teximg.mdwn b/ikiwiki/directive/teximg.mdwn
new file mode 100644
index 0000000..f2ba164
--- /dev/null
+++ b/ikiwiki/directive/teximg.mdwn
@@ -0,0 +1,24 @@
+La directive `teximg` est fournie par le module d'extension [[!iki
+plugins/teximg desc=teximg]].
+
+Cette directive transforme les formules LaTeX en images.
+
+## Exemples :
+
+ \[[!teximg code="\frac{1}{2}"]]
+ \[[!teximg code="E = - \frac{Z^2 \cdot \mu \cdot e^4}{32\pi^2 \epsilon_0^2 \hbar^2 n^2}" ]]
+
+Pour ajuster une image, utilisez height=x :
+
+ \[[!teximg code="\frac{1}{2}" height="17"]]
+ \[[!teximg code="\frac{1}{2}" height="8"]]
+
+Si aucune hauteur n'est choisie, la valeur par défaut est 12. Voici les
+valeurs reconnues : 8, 9, 10, 11, 12, 14, 17, 20. Si une autre valeur est
+donnée, la valeur la plus proche est choisie.
+
+Pour ajouter un texte à l'image, utilisez alt="text" :
+
+ \[[!teximg code="\frac{1}{2}" alt="1/2"]]
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/toc.mdwn b/ikiwiki/directive/toc.mdwn
new file mode 100644
index 0000000..a52e856
--- /dev/null
+++ b/ikiwiki/directive/toc.mdwn
@@ -0,0 +1,29 @@
+La directive `toc` est fournie par le module d'extension [[!iki plugins/toc
+desc=toc]].
+
+Voici comment ajouter une table des matières sur une page :
+
+ \[[!toc ]]
+
+La table des matières sera automatiquement créée à partir des titres de la
+page. Par défaut seuls les plus grands titres présents sur la page sont
+affichés. Pour choisir un niveau de titre, il faut utiliser le paramètre
+`levels` :
+
+ \[[!toc levels=2]]
+
+La directive `toc` choisit le niveau du premier titre comme le premier
+niveau, même si des niveaux plus élévés sont rencontrés plus tard dans le
+fichier.
+
+Pour créer une table des matières qui ne liste que les titres d'un certain
+niveau, vous pouvez utiliser le paramètre `startlevel`. Par exemple, pour ne
+montrer que les titres h2 et plus petits :
+
+ \[[!toc startlevel=2]]
+
+La table des matières est une liste ordonnée. Si vous voulez une liste non
+numérotée, il faut changer le style de liste dans la feuille de style
+locale.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/toggle.mdwn b/ikiwiki/directive/toggle.mdwn
new file mode 100644
index 0000000..fe77519
--- /dev/null
+++ b/ikiwiki/directive/toggle.mdwn
@@ -0,0 +1,38 @@
+Les directives `toggle` et `toggleable` sont fournies par le module
+d'extension [[!iki plugins/toggle desc=toggle]].
+
+Ces directives permettent de créer des liens qui, lorsque vous cliquez
+dessus, basculent l'affichage sur d'autres parties de la page.
+
+Javascript est nécessaire pour cela. Les navigateurs qui ne disposent pas de
+javascript affichent toujours la page entière.
+
+Exemple :
+
+ \[[!toggle id="ipsum" text="show"]]
+
+ \[[!toggleable id="ipsum" text="""
+ Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do
+ eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim
+ ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut
+ aliquip ex ea commodo consequat.
+
+ [[!toggle id="ipsum" text="hide"]]
+ """]]
+
+Vous pouvez inclure des balises wiki dans le texte du lien, et même d'autres
+liens de ce type, comme le montre l'exemple ci-dessus.
+
+Il n'est pas nécessaire que les textes des directives toggle et togglable
+soient proches, ils peuvent être partout sur la page. Il peut même y avoir
+de multiples textes qui renvoient tous à un seul texte de la directive
+toggleable.
+
+La valeur par défaut du paramètre « id » est "default", et peut être omis
+dans les cas les plus simples.
+
+Si vous voulez un affichage d'un texte par défaut et qui bascule vers un
+état caché, il suffit de passer le paramètre "open=yes" quand vous
+définissez la directive toggleable.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/directive/version.mdwn b/ikiwiki/directive/version.mdwn
new file mode 100644
index 0000000..eb4c37b
--- /dev/null
+++ b/ikiwiki/directive/version.mdwn
@@ -0,0 +1,13 @@
+La directive `version` est fournie par le module d'extension [[!iki
+plugins/version desc=version]].
+
+Cette directive permet d'insérer la version d'ikiwiki sur une page.
+
+À chaque mise à niveau d'ikiwiki, la page est reconstruite, modifiant par là
+le numéro de version.
+
+Simple est son utilisation :
+
+ \[[!version ]]
+
+[[!meta robots="noindex, follow"]]