summaryrefslogtreecommitdiff
path: root/ikiwiki/directive/postsparkline.mdwn
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2010-10-14 13:38:35 +0200
committerJonas Smedegaard <dr@jones.dk>2010-10-14 13:38:35 +0200
commitdef01959f8b76178d393a39ecd2c5af9be20b31f (patch)
treeed9b5b062671c30e55fe691625fc7ddcb31fee1f /ikiwiki/directive/postsparkline.mdwn
Sync with ikiwiki 3.20100926.HEADmasterikiwiki
Diffstat (limited to 'ikiwiki/directive/postsparkline.mdwn')
-rw-r--r--ikiwiki/directive/postsparkline.mdwn49
1 files changed, 49 insertions, 0 deletions
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"]]