summaryrefslogtreecommitdiff
path: root/ikiwiki
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki')
-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="