summaryrefslogtreecommitdiff
path: root/ikiwiki/directive/postsparkline.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki/directive/postsparkline.mdwn')
-rw-r--r--ikiwiki/directive/postsparkline.mdwn47
1 files changed, 47 insertions, 0 deletions
diff --git a/ikiwiki/directive/postsparkline.mdwn b/ikiwiki/directive/postsparkline.mdwn
new file mode 100644
index 0000000..f2dfa43
--- /dev/null
+++ b/ikiwiki/directive/postsparkline.mdwn
@@ -0,0 +1,47 @@
+The `postsparkline` directive is supplied by the [[!iki
+plugins/postsparkline desc=postsparkline]] plugin.
+
+This directive uses the [[!iki plugins/sparkline desc=sparkline]] plugin to
+create a [[sparkline]] of statistics about a set of pages, such as posts to
+a blog.
+
+# eksempler
+
+ Bidragsinterval:
+ \[[!postsparkline pages="blog/* and !*/Discussion" max=100
+ formula=interval style=bar barwidth=2 barspacing=1 height=13]]
+
+ Bidrag per måned dette år:
+ \[[!postsparkline pages="blog/* and !*/Discussion" max=12
+ formula=permonth style=bar barwidth=2 barspacing=1 height=13]]
+
+# brug
+
+All options aside from the `pages`, `max`, `formula`, `time`, and `color`
+options are the same as in [[sparkline]] directive.
+
+You don't need to specify any data points (though you can if you want to).
+Instead, data points are automatically generated based on the creation times
+of pages matched by the specified `pages` [[ikiwiki/PageSpec]]. A maximum of
+`max` data points will be generated.
+
+The `formula` parameter controls the formula used to generate data points.
+Available formulae:
+
+* `interval` - The height of each point represents how long it has been
+ since the previous post.
+* `perday` - Each point represents a day; the height represents how many
+ posts were made that day.
+* `permonth` - Each point represents a month; the height represents how many
+ posts were made that month.
+* `peryear` - Each point represents a year; the height represents how many
+ posts were made that year.
+
+The `time` parameter has a default value of "ctime", since formulae use the
+creation times of pages by default. If you instead want them to use the
+modification times of pages, set it to "mtime".
+
+To change the color used to draw the sparkline, use the `color` parameter.
+For example, "color=red".
+
+[[!meta robots="noindex, follow"]]