X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/blobdiff_plain/dccd76487151acc6adc93ec79f1808096bc41324..29fd100e9f4e71fb85505d932184ffd5e3f26242:/doc/templates.mdwn diff --git a/doc/templates.mdwn b/doc/templates.mdwn index d7480ee8f..9eb12e819 100644 --- a/doc/templates.mdwn +++ b/doc/templates.mdwn @@ -3,7 +3,7 @@ you can fully customise this site. Templates are located in `/usr/share/ikiwiki/templates` by default; the `templatedir` setting can be used to make another directory be -searched first. Customized templates can also be placed inside the +searched first. Customised templates can also be placed inside the "templates/" directory in your wiki's source. Ikiwiki uses the HTML::Template module as its template engine. This @@ -19,19 +19,20 @@ easy to learn. All you really need to know to modify templates is this: [[!if test="enabled(template)" then=""" ## template pages -The template directive allows wiki pages to be used as templates, -filled out and inserted into other pages in the wiki. +The [[!iki ikiwiki/directive/template desc="template directive"]] allows +wiki pages to be used as templates, filled out and inserted into other +pages in the wiki. """]] [[!if test="enabled(edittemplate)" then=""" ## default content for new pages -The edittemplate directive can be used to make new pages default to -containing text from a template page, which can be filled as out the page is -edited. +The [[!iki ikiwiki/directive/edittemplate desc="edittemplate directive"]] can +be used to make new pages default to containing text from a template +page, which can be filled as out the page is edited. """]] -[[!if test="(enabled(template) or enabled(edittemplate) +[[!if test="(enabled(template) or enabled(edittemplate)) and enabled(inline)" then=""" [[!inline pages="templates/* and !*.tmpl and !templates/*/* and !*/discussion" feeds=no archive=yes sort=title template=titlepage @@ -44,9 +45,9 @@ These templates are used to build the wiki. The aim is to keep almost all html out of ikiwiki and in the templates. * `page.tmpl` - Used for displaying all regular wiki pages. This is the - key template to customize. [[!if test="enabled(pagetemplate)" then=""" - (The pagetemplate directive can be used to make a page use a - different template than `page.tmpl`.)"""]] + key template to customise. [[!if test="enabled(pagetemplate)" then=""" + (The [[!iki ikiwiki/directive/pagetemplate desc="pagetemplate directive"]] + can be used to make a page use a different template than `page.tmpl`.)"""]] * `rsspage.tmpl` - Used for generating rss feeds for blogs. * `rssitem.tmpl` - Used for generating individual items on rss feeds. * `atompage.tmpl` - Used for generating atom feeds for blogs.