From 46d295eff558e247b05e61038bd82d5c5b8155a7 Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Thu, 14 Oct 2010 13:38:27 +0200 Subject: Sync with ikiwiki 3.20100926. --- ikiwiki/directive/postsparkline.mdwn | 47 ++++++++++++++++++++++++++++++++++++ 1 file changed, 47 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..1f475f5 --- /dev/null +++ b/ikiwiki/directive/postsparkline.mdwn @@ -0,0 +1,47 @@ +Die `postsparkline`-Anweisung wird durch die [[!iki plugins/postsparkline +desc=postsparkline]]-Erweiterung bereitgestellt. + +Diese Anweisung verwendet die [[!iki plugins/sparkline +desc=sparkline]]-Erweiterung, um eine [[sparkline]] mit Statistiken über +bestimmte Seiten anzuzeigen, etwa über Einträge in einem Blog. + +# Beispiele + + Intervall der Einträge: + \[[!postsparkline pages="blog/* and !*/Discussion" max=100 + formula=interval style=bar barwidth=2 barspacing=1 height=13]] + + Einträge pro Monat in diesem Jahr: + \[[!postsparkline pages="blog/* and !*/Discussion" max=12 + formula=permonth style=bar barwidth=2 barspacing=1 height=13]] + +# Verwendung + +Alle Parameter außer `pages`, `max`, `formula`, `time` und `color` sind die +gleichen wie in der [[sparkline]]-Anweisung. + +Es müssen keine Datenpunkte angegeben werden (auch wenn dies möglich +ist). Stattdessen werden die Datenpunkte ausgehend vom Erstellungsdatum der +durch `pages` angegebenen Seiten (eine [[ikiwiki/PageSpec]]) automatisch +generiert. Es werden höchstens `max` Datenpunkte erzeugt. + +Der Parameter `formula` steuert die Formel, mit der die Datenpunkte erzeugt +werden. Verfügbare Formeln: + +* `interval` - Die Höhe jedes Punkts steht für den zeitlichen Abstand zum + vorherigen Eintrag. +* `perday` - Jeder Punkt entspricht einem Tag; die Höhe stellt die Anzahl + der an diesem Tag gemachten Einträge dar. +* `permonth` - Jeder Punkt entspricht einem Monat; die Höhe stellt die + Anzahl der in diesem Monat gemachten Einträge dar. +* `peryear` - Jeder Punkt entspricht einem Jahr; die Höhe stellt die Anzahl + der in diesem Jahr gemachten Einträge dar. + +Der Parameter `time` hat standardmäßig den Wert `ctime` und es werden die +Erstellungszeiten der Seiten verwendet. Sollen stattdessen die +Änderungszeiten verwendet werden, kann `mtime` angegeben werden. + +Die Farbe der sparkline kann mit dem Parameter `color` verändert werden, +etwa durch `color=red`. + +[[!meta robots="noindex, follow"]] -- cgit v1.2.3