summaryrefslogtreecommitdiff
path: root/ikiwiki/directive/calendar.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki/directive/calendar.mdwn')
-rw-r--r--ikiwiki/directive/calendar.mdwn63
1 files changed, 63 insertions, 0 deletions
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"]]