summaryrefslogtreecommitdiff
path: root/ikiwiki/directive/templatebody.mdwn
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2015-01-22 15:02:35 +0100
committerJonas Smedegaard <dr@jones.dk>2015-01-22 15:02:35 +0100
commit224ca3cd99c6378f1bad4c69366d7b522e471e22 (patch)
tree271abd8de259f941f3bc03829f7308b5aa5cd682 /ikiwiki/directive/templatebody.mdwn
parent7609bea2373599512f0be20a688941f0b84b7916 (diff)
Sync with ikiwiki 3.20141016.1.
Diffstat (limited to 'ikiwiki/directive/templatebody.mdwn')
-rw-r--r--ikiwiki/directive/templatebody.mdwn28
1 files changed, 28 insertions, 0 deletions
diff --git a/ikiwiki/directive/templatebody.mdwn b/ikiwiki/directive/templatebody.mdwn
new file mode 100644
index 0000000..dfadb2c
--- /dev/null
+++ b/ikiwiki/directive/templatebody.mdwn
@@ -0,0 +1,28 @@
+The `templatebody` directive is supplied by the
+[[!iki plugins/templatebody desc=templatebody]] plugin.
+
+This directive allows wiki pages to be used as templates
+for the [[template]] or [[edittemplate]] directive, without having
+[[!cpan HTML::Template]] markup interpreted as wiki markup when that
+page is built.
+
+This directive does not produce any output in the wiki page that
+defines the template; the rest of that page can be used to to document
+how to use the template.
+
+The first, un-named parameter is the content of the template.
+Because templates often contain [[directives|ikiwiki/directive]], it's
+convenient to use the "here-document" syntax for it:
+
+ \[[!templatebody <<ENDBODY
+ [[!meta title="<TMPL_VAR name>"]]
+ [[!tag person]]
+ <dl>
+ <dt>Name:</dt><dd><TMPL_VAR name></dd>
+ <dt>Age:</dt><dd><TMPL_VAR age></dd>
+ </dl>
+
+ <TMPL_VAR description>
+ ENDBODY]]
+
+[[!meta robots="noindex, follow"]]