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