Difference: TWikiSkins (5 vs. 6)

Revision 62001-09-10 - MikeMannix

->
>
+On this page: 
  Overview
   Changing the default TWiki skin
   Defining Skins 
  Partial customization, or adding in new features to an existing skin
 
   Variables in Skins
   The Jump Box and Navigation Box
   Using Cascading Style Sheets
   Attachment Tables
   Packaging and Publishing Skins
   Browsing Installed Skins
   Activating Skins
   Conditional Skin Activation
   Hard-Coded Skins
  TWiki Skins
-<
<
+Skins are customized TWikiTemplate files. You can use skins to change the look of a TWiki topic, for example the layout of the header and footer. Note that the renderd text between header and footer does not change. You can also use skins to define an alternate view, ex: a view optimized for printing.
->
>
+Overlay regular templates with alternate header/footer layouts
-<
<
+Skin files are located in the twiki/template directory and are name with this syntax: <scriptname>.<skin>.tmpl. For example, the print skin for the view template is view.print.tmpl (red color added for clarification).
->
>
+ Overview 

Skins are customized TWiki Templates files. You can use skins to change the look of a TWiki 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 a user preference. Ex:
->
>
+ Define the SKIN Preference variable in TWikiPreferences, one of the WebPreferences, or in a user - TWikiGuest - topic.
  Set SKIN = print
->
>
  Add ?skin=name to the URL, for this example: 
 https://obelix.beims.me/twiki/bin/view/TWiki/TWikiSkins?skin=print (for the print view skin)
  https://obelix.beims.me/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.
->
>
+The ?skin=name URL parameter overrides the SKIN Preference value.
 -- PeterThoeny - 14 Jul 2001

View topic | History: r25 < r24 < r23 < r22 | More topic actions...

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.