TWiki Templates
Definition of the templates used to render all HTML pages displayed in TWiki
Overview
Templates are plain text with embedded
template directives that tell TWiki how to compose blocks of text together, to create something new.
There are two types of template:
- Master Templates: Define the HTML used to display TWiki pages.
- Template Topics: Define default text when you create a new topic
Tip: TWiki:TWiki.TWikiTemplatesSupplement
on TWiki.org has supplemental documentation on TWiki templates.
Master Templates
TWiki uses master templates when composing the output from all actions, like topic view, edit, and preview. This allows you to change the look and feel of all pages by editing just a few template files.
Master templates are also used in the definition of
TWikiSkins.
Master templates are stored as text files with the extension
.tmpl
. They are usually HTML with embedded
template directives. The directives are expanded when TWiki wants to generate a user interface screen.
How Template Directives Work
- Directives are of the form
%TMPL:<key>%
and %TMPL:<key>{"attr"}%
.
- Directives:
-
%TMPL:INCLUDE{"file"}%
: Includes a template file. The file is found as described