X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/89673afc6b75bdbf1f0f3d98841c6397a89f99c4..e71622d233660b5ba305d68e586d7d14ff2124e6:/doc/plugins/postsparkline.mdwn diff --git a/doc/plugins/postsparkline.mdwn b/doc/plugins/postsparkline.mdwn index a85d7e824..b0733e343 100644 --- a/doc/plugins/postsparkline.mdwn +++ b/doc/plugins/postsparkline.mdwn @@ -1,46 +1,14 @@ -[[template id=plugin name=postsparkline author="[[Joey]]"]] -[[tag type/chrome]] +[[!template id=plugin name=postsparkline author="[[Joey]]"]] +[[!tag type/widget]] -This plugin uses the [[sparkline]] plugin to create a sparkline of +This plugin provides the [[ikiwiki/directive/postsparkline]] [[ikiwiki/directive]]. +It uses the [[sparkline]] plugin to create a sparkline of statistics about a set of pages, such as posts to a blog. -# examples - - 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 - -All options aside fron the `pages`, `max`, and `forumla` options are passed -on to the sparkline plugin. - -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` [[PageSpec]]. A maximum of -`max` data points will be generated. - -The `formula` parameter controls the formula used to generate data points. -Available forumlae: - -* `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 day; the height represents how - many posts were made that year. - # adding formulae Additional formulae can be added without modifying this plugin by writing plugins that register functions in the `IkiWiki::Plugin::postsparkline::formula` namespace. These functions will receive on input a reference to a hash of parameters, and a sorted list of -pages (newest pages first), and should return a list of data points for -the sparkline plugin. +pages, and should return a list of data points for the sparkline plugin.