doc/ikiwiki/directive/edittemplate.mdwn

   1 The `edittemplate` directive is supplied by the [[!iki plugins/edittemplate desc=edittemplate]] plugin.
   2
   3 This directive allows registering template pages, that provide default
   4 content for new pages created using the web frontend. To register a
   5 template, insert an [[ikiwiki/directive/edittemplate]] directive on some other
   6 page.
   7
   8         \[[!edittemplate template="bugtemplate" match="bugs/*"]]
   9
  10 A recommended place to put the directive is on the parent page
  11 of the pages that will be created using the template. So the above
  12 example would be put on the bugs page. (Do not put the directive on the
  13 template page itself.)
  14
  15 In the above example, the page named "bugtemplate" is registered as a
  16 template to be used when any page named "bugs/*" is created. To avoid
  17 the directive displaying a note about the template being registered, add
  18 "silent=yes".
  19
  20 Often the template page contains a simple skeleton for a particular type of
  21 page. For the bug report pages in the above example, it might look
  22 something like:
  23
  24         Package:
  25         Version:
  26         Reproducible: y/n
  27         Details:
  28
  29 The template page can also contain [[!cpan HTML::Template]] directives,
  30 like other ikiwiki [[templates]].
  31
  32 Four variables might be set:
  33
  34 * `<TMPL_VAR name>` is replaced with the name of the page being
  35   created.
  36
  37 * `<TMPL_VAR uuid>` is replaced with a version 4 (random) UUID.
  38   (Requires the `UUID::Tiny` Perl module if not running on Linux.)
  39
  40 * `<TMPL_VAR time>` is replaced with the current (template generation)
  41   time, using a fixed format, `%Y-%m-%d %H:%M:%S`.
  42
  43 * `<TMPL_VAR formatted_time` is replaced with the current (template
  44   generation) time, formatted by IkiWiki.
  45
  46 [[!meta robots="noindex, follow"]]