Contrib plugin jscalendar : a javascript calendar

[ikiwiki.git] / doc / plugins / contrib / jscalendar.mdwn

diff --git a/doc/plugins/contrib/jscalendar.mdwn b/doc/plugins/contrib/jscalendar.mdwn
index 1b6eee4cf804509d141e72f83e4e8f9fc3e1b3dd..a320a054216a0e8d2aed81dbf7d3c37b428cea2f 100644 (file)
--- 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