X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/6ed7ea211bf344c48115edd13a1f5c808c1607b3..bac47cdecd9a9f7db3224eaaed43de0984bcf9ea:/doc/templates.mdwn diff --git a/doc/templates.mdwn b/doc/templates.mdwn index 101b69763..b40e865e1 100644 --- a/doc/templates.mdwn +++ b/doc/templates.mdwn @@ -1,3 +1,4 @@ +[[!meta robots="noindex, follow"]] [[!if test="enabled(template)" then="This wiki has templates **enabled**." else="This wiki has templates **disabled**." @@ -39,15 +40,19 @@ large chunks of marked up text to be embedded into a template: ## Creating a template -To create a template, simply add a template directive to a page, and page will -provide a link that can be used to create the template. The template is a -regular wiki (.mdwn) page, **located in the `templates/` directory** under source control. Nothing to do with **templatedir** from your ikiwiki configuration. +To create a template, simply add a template directive to a page, and the +page will provide a link that can be used to create the template. The template +is a regular wiki page, located in the `templates/` subdirectory inside +the source directory of the wiki. The template uses the syntax used by the [[!cpan HTML::Template]] perl module, which allows for some fairly complex things to be done. Consult its documentation for the full syntax, but all you really need to know are a few things: +* Each parameter you pass to the template directive will generate a + template variable. There are also some pre-defined variables like PAGE + and BASENAME. * To insert the value of a variable, use ``. Wiki markup in the value will first be converted to html. * To insert the raw value of a variable, with wiki markup not yet converted