diff options
author | William Uther <willu@cse.unsw.edu.au> | 2008-09-11 17:04:23 -0400 |
---|---|---|
committer | Joey Hess <joey@kodama.kitenet.net> | 2008-09-11 17:05:19 -0400 |
commit | 4f0ac7fe59c196a602e07cc6c4abfc248999ec6b (patch) | |
tree | 725f523faeb8e8db0efd81be4024257799c93ef8 /underlays/basewiki/directive/edittemplate.mdwn | |
parent | 595b0359157d1f57ee5a87c63e665dfa1d2130ec (diff) |
add underlay files for listdirectives
As was noted, 'listdirectives' didn't include the underlay files that make
it really worthwhile. I've just gone through all the plugin
documentation, modified it to remove installation information and renamed
the files to match the directives rather than the plugins. This can now
serve as useful underlay.
I've only gone through plugins in the 'plugins' dir. I did not go through
the 'contrib' dir.
Diffstat (limited to 'underlays/basewiki/directive/edittemplate.mdwn')
-rw-r--r-- | underlays/basewiki/directive/edittemplate.mdwn | 32 |
1 files changed, 32 insertions, 0 deletions
diff --git a/underlays/basewiki/directive/edittemplate.mdwn b/underlays/basewiki/directive/edittemplate.mdwn new file mode 100644 index 000000000..94295585e --- /dev/null +++ b/underlays/basewiki/directive/edittemplate.mdwn @@ -0,0 +1,32 @@ +The `edittemplate` directive is supplied by the [[!iki plugins/edittemplate]] plugin. + +This directive allows registering template pages, that provide default +content for new pages created using the web frontend. To register a +template, insert a [[ikiwiki/directive/template]] directive 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. |