X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/5666c43494064f07229b70cdf30a299aa2ba6e60..80ec92dec4397f7dafd3a9a4a565448e33f0ce7b:/doc/plugins/contrib/jscalendar.mdwn diff --git a/doc/plugins/contrib/jscalendar.mdwn b/doc/plugins/contrib/jscalendar.mdwn index 1b6eee4cf..a320a0542 100644 --- a/doc/plugins/contrib/jscalendar.mdwn +++ b/doc/plugins/contrib/jscalendar.mdwn @@ -1,10 +1,12 @@ [[!meta title="Javascript equivalent of plugin 'calendar'"]] -[[!tag patch]] -Hello, -we ([[Grésille|http://www.gresille.org]]) have a calendar (built using the [[calendar|plugins/calendar]] plugin) in the sidebar of our website. This caused the whole website to be rebuilded each night, and we did not like it. So I wrote a javascript equivalent of the calendar plugin. +# Jscalendar -Here are the differences compared to the [[calendar|plugins/calendar]] plugin. +Jscalendar is a javascript equivalent to the [[calendar|plugins/calendar]] plugin. + +## Description + +Here are some differences compared to this latter plugin. * Pros * No need to rebuild the page containing the calendar each time day changes, or @@ -19,10 +21,25 @@ Here are the differences compared to the [[calendar|plugins/calendar]] plugin. * As a consequence, every calendar of the wiki must index the same set of pages. * Javascript :( . -You can see this plugin in action on [[our website|http://www.gresille.org]]. To see what happens when several pages happens on the same day, check the 15th of March 2012. +## Usage + +### Directive + + \[[!jscalendar type="month" ]] -I do not know how contributions are processed, but if you want to include this plugin in Ikiwiki, I made a copy of Ikiwiki repository, with this new plugin (as well as the documentation for the plugin and the directive). +### Setup file + +It being javascript rather than markdown, most of the configuration must be done in the IkiWiki configuration file rather than in the directive + + 'archivebase' => "evenements/calendrier", + 'archive_pagespec' => "evenements/liste/* and ! evenements/liste/*/*", + 'week_start_day' => 1, + 'month_link' => 1, + +## Example + +You can see this plugin in action on [[our website|http://www.gresille.org]]. To see what happens when several pages happens on the same day, check the 15th of March 2012. - git clone http://spalax.homedns.org/git/ikiwiki +Code and documentation can be found here : [[https://atelier.gresille.org/projects/gresille-ikiwiki/wiki/Jscalendar]] --- Spalax +-- Louis