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"]]