* Add first draft at a Restructured Text (rst) plugin, by Sergio

  Talens-Oliag. Note that this has many known issues -- see the caveats on
  the plugin's page.
* Credit everyone who wrote a plugin on the plugins' wiki pages.

6 files changed, 29 insertions, 0 deletions

diff --git a/doc/plugins/htmltidy.mdwn b/doc/plugins/htmltidy.mdwn
index f6f6e0c17..9da9c4d98 100644
--- a/doc/plugins/htmltidy.mdwn
+++ b/doc/plugins/htmltidy.mdwn
@@ -3,5 +3,6 @@ emitted by ikiwiki. Besides being nicely formatted, this helps ensure that
 even if users enter suboptimal html, your wiki generates valid html.
 
 This plugin is included in ikiwiki, but is not enabled by default.
+It was contributed by Faidon Liambotis.
 
 [[tag type/html]]
diff --git a/doc/plugins/map.mdwn b/doc/plugins/map.mdwn
index 40e284256..cd2ef1bc5 100644
--- a/doc/plugins/map.mdwn
+++ b/doc/plugins/map.mdwn
@@ -9,6 +9,7 @@ Hint: To limit the map to displaying pages less than a certian level deep,
 use a [[PageSpec]] like this: `pages="* and !*/*/*"`
 
 This plugin is included in ikiwiki, but is not enabled by default.
+It was contributed by Alessandro Dotti Contra.
 
 If this plugin is enabled, here is a page map for the plugins section
 of this wiki:
diff --git a/doc/plugins/pagestats.mdwn b/doc/plugins/pagestats.mdwn
index a9f3bdbdb..93e9f5694 100644
--- a/doc/plugins/pagestats.mdwn
+++ b/doc/plugins/pagestats.mdwn
@@ -11,5 +11,6 @@ And here's how to create a table of all the pages on the wiki:
 	\[[pagestats style="table"]]
 
 This plugin is included in ikiwiki, but is not enabled by default.
+It was contributed by Enrico Zini
 
 [[tag type/meta type/tags]]
diff --git a/doc/plugins/polygen.mdwn b/doc/plugins/polygen.mdwn
index 85b05e102..d04708e2a 100644
--- a/doc/plugins/polygen.mdwn
+++ b/doc/plugins/polygen.mdwn
@@ -7,6 +7,7 @@ It's also possible to specify a starting nonterminal for the grammar by
 including `symbol="text"` in the directive.
 
 This plugin is included in ikiwiki, but not enabled by default.
+It was contributed by Enrico Zini.
 
 ----
 
diff --git a/doc/plugins/rst.mdwn b/doc/plugins/rst.mdwn
new file mode 100644
index 000000000..0f0d6f96c
--- /dev/null
+++ b/doc/plugins/rst.mdwn
@@ -0,0 +1,24 @@
+This plugin lets ikwiki convert files with names ending in ".rst" to html.
+It uses the [reStructuredText](http://docutils.sourceforge.net/rst.html)
+markup syntax. You need to have the python-docutils module installed to use
+it.
+
+Note that this plugin does not interoperate very well with the rest of
+ikiwiki. Limitations include:
+
+* reStructuredText does not allow raw html to be inserted into
+  documents, but ikiwiki does so in many cases, including
+  [[WikiLinks|WikiLink]] and many
+  [[PreprocessorDirectives|PreprocessorDirective]].
+* It's slow; it forks a copy of python for each page. While there is a
+  perl version of the reStructuredText processor, it is not being kept in
+  sync with the standard version, so is not used.
+
+So while you may find this useful for importing old files into your wiki,
+using this as your main markup language in ikiwiki isn't recommended at
+this time.
+
+This plugin is included in ikiwiki, but not enabled by default.
+It was contributed by Sergio Talens-Oliag.
+
+[[tag type/format]]
diff --git a/doc/plugins/sidebar.mdwn b/doc/plugins/sidebar.mdwn
index f38e56817..8ab416f6f 100644
--- a/doc/plugins/sidebar.mdwn
+++ b/doc/plugins/sidebar.mdwn
@@ -12,5 +12,6 @@ you can create a sidebar page that is completely empty. This will turn off
 the sidebar altogether.
 
 This plugin is included in ikiwiki, but is not enabled by default.
+It was contributed by Tuomo Valkonen.
 
 [[tag type/chrome]]