La directive calendar est fournie par le module d'extension 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 option calendar_autocreate is not set, the 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 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 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 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.