aboutsummaryrefslogtreecommitdiff
path: root/doc/plugins/edittemplate.mdwn
diff options
context:
space:
mode:
authorJoey Hess <joey@kitenet.net>2007-12-12 01:52:26 -0500
committerJoey Hess <joey@kitenet.net>2007-12-12 01:52:26 -0500
commit8576fe4c4913c2ebe678c54f9353ac22c6bdaa84 (patch)
tree5fb544d50ebdb2af4ceb5a5b434e15576f8992b1 /doc/plugins/edittemplate.mdwn
parent035a57f209e02c954a0edf798bbc4879a6311a3f (diff)
downloadikiwiki-8576fe4c4913c2ebe678c54f9353ac22c6bdaa84.tar
ikiwiki-8576fe4c4913c2ebe678c54f9353ac22c6bdaa84.tar.gz
incomplate edittemplate plugin
Diffstat (limited to 'doc/plugins/edittemplate.mdwn')
-rw-r--r--doc/plugins/edittemplate.mdwn33
1 files changed, 33 insertions, 0 deletions
diff --git a/doc/plugins/edittemplate.mdwn b/doc/plugins/edittemplate.mdwn
new file mode 100644
index 000000000..6d889f5f1
--- /dev/null
+++ b/doc/plugins/edittemplate.mdwn
@@ -0,0 +1,33 @@
+[[template id=plugin name=edittemplate author="[[Joey]]"]]
+[[tag type/useful]]
+
+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.
+
+[[template id=note text="""
+Note: 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.
+"""]]
+
+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.