response

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

diff --git a/doc/plugins/contrib/jscalendar.mdwn b/doc/plugins/contrib/jscalendar.mdwn
index 794e4bd9c5a6a7ad0e923710777d5f6629705282..8123b313243cb3657d878c3985767c31e088b547 100644 (file)
--- a/doc/plugins/contrib/jscalendar.mdwn
+++ b/doc/plugins/contrib/jscalendar.mdwn
@@ -1,3 +1,4 @@
+[[!meta author="spalax"]]

 [[!template id=plugin name=jscalendar author="[[Louis|spalax]]"]]
 
 # Jscalendar
 [[!template id=plugin name=jscalendar author="[[Louis|spalax]]"]]
 
 # Jscalendar


@@ -12,33 +13,37 @@ Here are some differences compared to this latter plugin.
   * No need to rebuild the page containing the calendar each time day changes, or
     a page (indexed by the calendar) is added, changed or deleted. This is
     particularly useful if you want to have this calendar in the sidebar.
   * No need to rebuild the page containing the calendar each time day changes, or
     a page (indexed by the calendar) is added, changed or deleted. This is
     particularly useful if you want to have this calendar in the sidebar.

-  * Handles the case where several pages appear the same day: a popup appear to let user choose the day he wants.

   * Smooth navigation among months.
   * Smooth navigation among months.

-* Neutral
-  * Most of options are defined in Ikiwiki's setup files instead of the options
-    of the directive.

 * Cons
 * Cons

-  * As a consequence, every calendar of the wiki must index the same set of pages.

   * Javascript :( .
 
 ## Usage
 
   * Javascript :( .
 
 ## Usage
 

-### Directive
+### Examples of directive

 
     \[[!jscalendar type="month" ]]
 
 
     \[[!jscalendar type="month" ]]
 

+    \[[!jscalendar type="month" archivebase="calendar"]]
+
+    \[[!jscalendar type="month" year=2014 month=08 pages="posts/* and !posts/*"]]
+
+    \[[!jscalendar type="month" year=-1 month=08]]
+

 ### Setup file
 
 ### 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
+This plugin uses the options used by the [[plugins/calendar]] plugin:

 
 

-    'archivebase' => "evenements/calendrier",
-    'archive_pagespec' => "evenements/liste/* and ! evenements/liste/*/*",
+    'archivebase' => "archive",
+    'archive_pagespec' => "posts/* and ! posts/*/*",

     'week_start_day' => 1,
     'month_link' => 1,
 
     'week_start_day' => 1,
     'month_link' => 1,
 

+The `archivebase` and `archive_pagespec` can be overloaded by the very same
+options of the directive.
+

 ## Example
 
 ## 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.
+You can see this plugin in action on [[our website|http://www.gresille.org]].

 
 Code and documentation can be found here : [[https://atelier.gresille.org/projects/gresille-ikiwiki/wiki/Jscalendar]]
 
 
 Code and documentation can be found here : [[https://atelier.gresille.org/projects/gresille-ikiwiki/wiki/Jscalendar]]