summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMikeMannix <MikeMannix>2001-09-10 00:07:45 +0000
committerMikeMannix <MikeMannix>2001-09-10 00:07:45 +0000
commit3fb1eaf0382ddd3a0a97c5e54996609bc555b321 (patch)
tree5899ce9de1f19bd52a29e1d3ff99088b52546c14
parent48d3e40127623737bf3f08ce7e42fdb1c8f3c447 (diff)
none
-rw-r--r--TWiki/TWikiSkins.mdwn19
1 files changed, 15 insertions, 4 deletions
diff --git a/TWiki/TWikiSkins.mdwn b/TWiki/TWikiSkins.mdwn
index bcbae5ca..6e6dc667 100644
--- a/TWiki/TWikiSkins.mdwn
+++ b/TWiki/TWikiSkins.mdwn
@@ -1,17 +1,28 @@
+%TOC% %STARTINCLUDE%
+
# <a name="TWiki_Skins"> TWiki Skins </a>
-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. 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_
+
+## <a name="Overview"> Overview </a>
+
+Skins are customized [[TWikiDocumentation]] 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.
-Skin files are located in the <code>**twiki/template**</code> directory and are name with this syntax: <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).
+--++ Defining Skins
+
+Skin files are located in the `twiki/templates` directory and are named with the syntax: <code>**&lt;scriptname&gt;.&lt;skin&gt;.tmpl**</code>. For example, the **Printable** skin for the `view` template is `view.print.tmpl`.
+
+## <a name="Activating_Skins"> Activating Skins </a>
A skin can be activated in two ways:
-* Define the SKIN preference variable in [[TWiki/TWikiPreferences]], one of the [[WebPreferences]], or a user preference. Ex:
+* 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 <code>**?skin=name**</code> URL parameter overrides the SKIN preference value.
+The <code>**?skin=name**</code> URL parameter overrides the SKIN Preference value.
-- [[PeterThoeny]] - 14 Jul 2001 <br />