]> git.vanrenterghem.biz Git - git.ikiwiki.info.git/blobdiff - doc/plugins/edittemplate.mdwn
add news item for ikiwiki 3.20140227
[git.ikiwiki.info.git] / doc / plugins / edittemplate.mdwn
index ac8e0a71f29171a81cc24d1ea6ba40021d7cfd5e..c19ecd8586940da51ccf0d3433beebfa3392f9ec 100644 (file)
@@ -1,33 +1,6 @@
-[[template id=plugin name=edittemplate author="[[Joey]]"]]
-[[tag type/useful]]
+[[!template id=plugin name=edittemplate author="[[Joey]]"]]
+[[!tag type/web]]
 
-This plugin allows registering template pages, that provide default
-content for new pages created using the web frontend. To register a
-template, insert a [[PreprocessorDirective]] on some other page.
-
-       \[[!edittemplate template="bugtemplate" match="bugs/*"]]
-
-In the above example, the page named "bugtemplate" is registered as a
-template to be used when any page named "bugs/*" is created.
-
-Often the template page contains a simple skeleton for a particular type of
-page. For the bug report pages in the above example, it might look
-something like:
-
-       Package: 
-       Version: 
-       Reproducible: y/n
-       Details:
-
-The template page can also contain [[cpan HTML::Template]] directives,
-similar to other ikiwiki [[templates]]. Currently only one variable is
-set: `<TMPL_VAR name>` is replaced with the name of the page being
-created.
-
-----
-
-It's generally not a good idea to put the `edittemplate` directive in
-the template page itself, since the directive would then be included as
-part of the template on new pages, which would then in turn be registered
-as templates. If multiple pages are registered as templates for a new page,
-an arbitrary one is chosen, so that could get confusing.
+This plugin provides the [[ikiwiki/directive/edittemplate]] [[ikiwiki/directive]].
+This directive allows registering [[template|templates]] pages, that
+provide default content for new pages created using the web frontend.