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é.

## Generating archive pages

If [[!iki plugins/calendar desc=option]] `calendar_autocreate` is not set,
the [[!iki ikiwiki-calendar]] command can be used to automatically generate
the archive pages. It also refreshes the wiki, updating the calendars to
highlight the current day. This command is typically run at midnight from
cron.

Une crontab possible :

    0 0 * * * ikiwiki-calendar ~/ikiwiki.setup "posts/* and !*/Discussion"


With [[!iki plugins/calendar desc="setup option"]] `calendar_autocreate`,
all this work is done by `ikiwiki` itself. Thus, the crontab command can be
replaced by:

    0 0 * * * ikiwiki --setup ~/ikiwiki.setup --refresh

## 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` - Configures the base of the archives hierarchy.  The
  default is "archives". Note that this default can also be overridden for
  the whole wiki by setting `archivebase` in ikiwiki's setup file.
  Calendars link to pages under here, with names like "2010/04" and
  "2010". These pages can be automatically created using the
  `calendar_autocreate` [[!iki plugins/calendar desc="setup option"]].
* `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"]]
