doc/todo/Javascript_calendar.mdwn

@@ -0,0 +1,27 @@
+[[! 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.
+
+Here are the differences compared to the [[calendar|plugins/calendar]] plugin.
+
+* Pros
+  * 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.
+  * Smooth navigation among months.
+* Neutral
+  * Most of options are defined in Ikiwiki's setup files instead of the options
+    of the directive.
+* Cons
+  * 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]].
+
+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).
+
+    git clone http://spalax.homedns.org/git/ikiwiki
+
+-- Spalax