X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/14d2b0b65c0c2956031f13472dba4ed7d23eaab9..096619f738a097a3ed42a863c8b5e0c001829c99:/doc/plugins/edittemplate.mdwn diff --git a/doc/plugins/edittemplate.mdwn b/doc/plugins/edittemplate.mdwn index ac8e0a71f..c19ecd858 100644 --- a/doc/plugins/edittemplate.mdwn +++ b/doc/plugins/edittemplate.mdwn @@ -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: `` 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.