X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/d5e65e582a34ae2494fee493ddcb2b959e4a4bce..1ce0d17dc758c4025d2e2eea79a691a8dbb90414:/doc/plugins/edittemplate.mdwn diff --git a/doc/plugins/edittemplate.mdwn b/doc/plugins/edittemplate.mdwn index a68f7f0a1..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]] +[[!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.