X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/d4ca3b3f50027d0dfd052f77ddcc4290ab0e6a81..f6bd8500b9d8ec429dc455d9eb07a89eebf96c81:/doc/plugins/template.mdwn diff --git a/doc/plugins/template.mdwn b/doc/plugins/template.mdwn index 6f38e554e..4efab57e3 100644 --- a/doc/plugins/template.mdwn +++ b/doc/plugins/template.mdwn @@ -1,4 +1,4 @@ -[[template id=plugin name=template included=1 author="""[[Joey]]"""]] +[[template id=plugin name=template author="[[Joey]]"]] [[tag type/format]] With this plugin, you can set up templates, and cause them to be filled out @@ -23,13 +23,18 @@ large chunks of marked up text to be embedded into a template: * Really 8 and a half. """]] +Some templates are included in the wiki by default; these are listed in the +[[templates]] page. + To create a template, make a page in the wiki named `template/foo`. Note that this is a different location than the directory used for the -[[templates]] used to build the wiki itself, which is not inside the wiki. +[[templates|wikitemplates]] used to build the wiki itself, which is not +part of the wiki. -The template uses the syntax used by the 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: +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: * To insert the value of a variable, use ``. * To make a block of text conditional on a variable being set use @@ -52,3 +57,8 @@ Here's a sample template: + +The filled out template will be formatted the same as the rest of the page +that contains it, so you can include WikiLinks and all other forms of wiki +markup in the template. Note though that such WikiLinks will not show up as +backlinks to the page that uses the template.