From def01959f8b76178d393a39ecd2c5af9be20b31f Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Thu, 14 Oct 2010 13:38:35 +0200 Subject: Sync with ikiwiki 3.20100926. --- ikiwiki/directive/postsparkline.mdwn | 49 ++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 ikiwiki/directive/postsparkline.mdwn (limited to 'ikiwiki/directive/postsparkline.mdwn') diff --git a/ikiwiki/directive/postsparkline.mdwn b/ikiwiki/directive/postsparkline.mdwn new file mode 100644 index 0000000..6b9bd0a --- /dev/null +++ b/ikiwiki/directive/postsparkline.mdwn @@ -0,0 +1,49 @@ +La directive `postsparkline` est fournie par le module d'extension [[!iki +plugins/postsparkline desc=postsparkline]. + +Cette directive se sert du greffon [[!iki plugins/sparkline desc=sparkline]] +pour créer une [[sparkline]], c'est-à-dire un mini graphique de statistiques +au sujet d'un ensemble de pages, comme par exemple les messages d'un blog. + +# Exemples + + Post interval: + \[[!postsparkline pages="blog/* and !*/Discussion" max=100 + formula=interval style=bar barwidth=2 barspacing=1 height=13]] + + Posts per month this year: + \[[!postsparkline pages="blog/* and !*/Discussion" max=12 + formula=permonth style=bar barwidth=2 barspacing=1 height=13]] + +# Usage + +Toutes les options, à part les options `pages`, `max`, `formula`, `time` et +`color` sont les mêmes que dans la directive [[sparkline]]. + +Vous n'avez pas besoin d'indiquer des points de données. Mais c'est possible +si vous le souhaitez. En fait, les points de données sont automatiquement +créés à partir des dates de création des pages correspondant à la +spécification [[ikiwiki/PageSpec]] `pages`. Un maximum de `max` points de +données sont créés. + +Le paramètre `formula` précise la formule utilisée pour créer les points de +données. Les formules disponibles sont les suivantes : + +* `interval` - La hauteur de chaque point représente la durée depuis le + précédent message. +* `perday` - Chaque point représente un jour. La hauteur représente le + nombre de messages envoyés ce jour-là. +* `permonth` - Chaque point représente un mois. La hauteur représente le + nombre de messages envoyés pendant ce mois. +* `peryear` - Chaque point représente une année. La hauteur représente le + nombre de messages envoyés pendant cette année. + +Le paramètre `time` possède une valeur par défaut, "ctime", puisque les +formules utilisent par défaut la date de création des pages. Si vous +préférez qu'elles utilisent la date de modification, passez la valeur du +paramètre à "mtime". + +Pour modifier la couleur de la ligne-étincelle, utilisez le paramètre +`color`. Par exemple, "color=red". + +[[!meta robots="noindex, follow"]] -- cgit v1.2.3