6183217818818f949ffd9f5ad20c6a8ef56d679e
[openafs-wiki.git] / TWiki / TWikiSkins.mdwn
1 ## <a name="TWiki Skins"></a> TWiki Skins
2
3 Skins are customized [[TWikiTemplate|Main/TWikiTemplates]] files. You can use skins to change the look of a %WIKITOOLNAME% topic, for example the layout of the header and footer. Note that the renderd text between header and footer does **_not_** change. You can use skins also to define an alternate view, i.e. a view optimized for printing.
4
5 A skin file is located in the <code>**twiki/template**</code> directory and has a name like <code>**&lt;scriptname&gt;.&lt;skin&gt;.tmpl**</code>. For example, the <code>**print**</code> skin for the <code>**view**</code> template is <code>**view<font>.print</font>.tmpl**</code> (red color added for clarification).
6
7 A skin can be activated in two ways:
8
9 - Define the SKIN preference variable in [[TWikiPreferences]], one of the [[WebPreferences]], or a user preference. I.e.
10   - `Set SKIN = wikiwiki`
11 - Add `?skin=name` to the URL, i.e. for this topic:
12   - <http://www.dementia.org/twiki//view/%WEB%/%TOPIC%?skin=print> (for the print view skin)
13   - <http://www.dementia.org/twiki//view/%WEB%/%TOPIC%?skin=plain> (for the plain view skin that has no header and footer)
14
15 The <code>**?skin=name**</code> URL parameter overrides the SKIN preference value.
16
17 -- [[PeterThoeny]] - 14 Jul 2001 <br />