X-Git-Url: https://sipb.mit.edu/gitweb.cgi/ikiwiki.git/blobdiff_plain/dccd76487151acc6adc93ec79f1808096bc41324..9ab56b4ec8c99127afa74cbd3dac7f1f2fcae8d9:/doc/templates.mdwn diff --git a/doc/templates.mdwn b/doc/templates.mdwn index d7480ee8f..bfb6a439a 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 out as 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. @@ -55,7 +56,7 @@ html out of ikiwiki and in the templates. * `archivepage.tmpl` - Used for listing a page in a blog archive page. * `titlepage.tmpl` - Used for listing a page by title in a blog archive page. * `microblog.tmpl` - Used for showing a microblogging post inline. -* `blogpost.tmpl` - Used for a form to add a post to a blog (and a rss/atom links) +* `blogpost.tmpl` - Used for a form to add a post to a blog (and rss/atom links) * `feedlink.tmpl` - Used to add rss/atom links if `blogpost.tmpl` is not used. * `aggregatepost.tmpl` - Used by the aggregate plugin to create a page for a post.