]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/blobdiff - doc/plugins/haiku.mdwn
New plugin for review
[git.ikiwiki.info.git] / doc / plugins / haiku.mdwn
index 1da4ee2a951c1fd900f92735e371ddd6f5e91f32..74eac1c29679961c96ec2c9329cd8be81296b7a3 100644 (file)
@@ -1,18 +1,11 @@
-This plugin allows inserting a randomly generated haiku into a wiki page.
-Just type \\[[haiku hint="argument"]].
+[[!template id=plugin name=haiku author="[[Joey]]"]]
+[[!tag type/fun]]
 
-[[haiku hint="argument test"]]
+This plugin provides a [[ikiwiki/directive/haiku]] [[ikiwiki/directive]].
+The directive allows inserting a randomly generated haiku into a wiki page.
 
-The hint parameter can be omitted, it only provides the generator a hint of
-what to write the haiku about. If no hint is given, it might base it on the
-page name. Since the vocabulary it knows is very small, many hints won't
-affect the result at all.
+As a special bonus, enabling this plugin makes any error messages ikiwiki
+should display be written in haiku.
 
-This plugin is included in ikiwiki, but is not enabled by default. As a
-special bonus, enabling this plugin makes any error messages ikiwiki should
-display be written in haiku.
-
-You need to have the Coy module installed for this plugin to do anything
-interesting. That does all the heavy lifting.
-
-[[tag type/fun]]
+You need to have the [[!cpan Coy]] module installed for this plugin to do
+anything interesting. That does all the heavy lifting.