Tharsis . TWiki . TWikiSkins	Tharsis webs: Design | Guilds | Combat | Website
	TWiki . { Home | Welcome | Register | Changes | Index | Search | Go }

• TWiki Skins
  • Overview
  • Defining Skins
  • Activating Skins

TWiki Skins

Skins overlay regular templates with alternate header/footer layouts; topic text is not affected

Overview

Skins are customized TWikiTemplates files. You can use skins to change the look of a Tharsis 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: <scriptname>.<skin>.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 TWikiPreferences, one of the WebPreferences, or in a user - Main.guest - topic.
  • Set SKIN = print

• Add ?skin=name to the URL, for this example:
  • http://tharsis-gate.org/twiki/bin/view/TWiki/TWikiSkins?skin=print (for the print view skin)
  • http://tharsis-gate.org/twiki/bin/view/TWiki/TWikiSkins?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