From def01959f8b76178d393a39ecd2c5af9be20b31f Mon Sep 17 00:00:00 2001
From: Jonas Smedegaard <dr@jones.dk>
Date: Thu, 14 Oct 2010 13:38:35 +0200
Subject: Sync with ikiwiki 3.20100926.

---
 ikiwiki/directive/calendar.mdwn | 63 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 63 insertions(+)
 create mode 100644 ikiwiki/directive/calendar.mdwn

(limited to 'ikiwiki/directive/calendar.mdwn')

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"]]
-- 
cgit v1.2.3