X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/243739e1c355da4162dc1b41c04c11cc1fb676c0..819e2a567aa8e528b95cc6e146d5ee92fd486cc8:/doc/plugins/edittemplate.mdwn diff --git a/doc/plugins/edittemplate.mdwn b/doc/plugins/edittemplate.mdwn index 8140b4f41..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 [[Preprocessor_Directive|/ikiwiki/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.