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

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