TWikiSkins < TWiki

%TOC%
%STARTINCLUDE%
---# TWiki Skins

_Overlay regular templates with alternate header/footer layouts_

---++ Overview

Skins are customized TWikiTemplates files. You can use skins to change the look of a %WIKITOOLNAME% topic, for example, the layout of the header and footer. Rendered text between header and footer does __not__ change. You can also use skins to define an alternate view, like a view optimized for printing.

---++ Defining Skins

Skin files are located in the =twiki/templates= directory and are named with the syntax: ==&lt;scriptname&gt;.&lt;skin&gt;.tmpl==. For example, the *Printable* skin for the =view= template is =view.print.tmpl=.

---++ Activating Skins

A skin can be activated in two ways:

   * Define the =SKIN= Preference variable in TWiki.TWikiPreferences, one of the WebPreferences, or in a user - %WIKIUSERNAME% - topic.
      * =Set SKIN = print=

   * Add =?skin=name= to the URL, for this example:
      * %SCRIPTURL%/view%SCRIPTSUFFIX%/%WEB%/%TOPIC%?skin=print (for the print view skin)
      * %SCRIPTURL%/view%SCRIPTSUFFIX%/%WEB%/%TOPIC%?skin=plain (for the plain view skin that has no header and footer)

The ==?skin=name== URL parameter overrides the SKIN Preference value.

-- PeterThoeny - 14 Jul 2001 <br>

This topic: TWiki > TWikiSkins
Topic revision: r7 - 2001-09-14 - PeterThoeny

Copyright © 1999-2025 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.TWikiSkins.