From bb87ddf217cd4a226af6dd25cbe7b8f33152e208 Mon Sep 17 00:00:00 2001
From: PeterThoeny <PeterThoeny>
Date: Sat, 20 Jan 2001 23:33:08 +0000
Subject: [PATCH] none

---
 TWiki/TWikiDocumentation.mdwn | 31 +++++++++++++++++++------------
 TWiki/TWikiSkins.mdwn         | 15 +++++++++++++++
 TWiki/WebHome.mdwn            | 29 ++++++++++++++++-------------
 3 files changed, 50 insertions(+), 25 deletions(-)
 create mode 100644 TWiki/TWikiSkins.mdwn

diff --git a/TWiki/TWikiDocumentation.mdwn b/TWiki/TWikiDocumentation.mdwn
index 132beab..89f4158 100644
--- a/TWiki/TWikiDocumentation.mdwn
+++ b/TWiki/TWikiDocumentation.mdwn
@@ -4,13 +4,14 @@
 - [(2)](#installation) Installation Notes
 - [(3)](#upgrade) Upgrading Earlier Versions of TWiki
 - [(4)](#authentication) TWiki Authentication
-- [(5)](#login) Wiki Username vs. Login Username
+- [(5)](#login) TWiki Username vs. Login Username
 - [(6)](#access) TWiki Access Control
-- [(7)](#templates) Wiki Templates
-- [(8)](#variables) Wiki Variables
-- [(9)](#notification) Notification of Changes by Email
-- [(10)](#category) TWiki Category Table
-- [(11)](#administration) TWiki Administration
+- [(7)](#templates) TWiki Templates
+- [(8)](#skins) TWiki Skins
+- [(9)](#variables) TWiki Variables
+- [(10)](#notification) Notification of Changes by Email
+- [(11)](#category) TWiki Category Table
+- [(12)](#administration) TWiki Administration
 
 **_Note:_** Read the most up to date version of this document at <http://TWiki.org/cgi-bin/view/TWiki/TWikiDocumentation>
 
@@ -44,7 +45,7 @@
 
 ----
 
-**(5) Wiki Username vs. Login Username**
+**(5) TWiki Username vs. Login Username**
 
 <a name="control"> </a>
 
@@ -56,28 +57,34 @@
 
 ----
 
-**(7) Wiki Templates**
+**(7) TWiki Templates**
+
+<a name="skins"> </a>
+
+----
+
+**(8) TWiki Skins**
 
 <a name="variables"> </a>
 
 ----
 
-**(8) Wiki Variables**
+**(9) TWiki Variables**
 
 <a name="notification"> </a>
 
 ----
 
-**(9) Notification of Changes by Email**
+**(10) Notification of Changes by Email**
 
 <a name="category"> </a>
 
 ----
 
-**(10) TWiki Category Table**
+**(11) TWiki Category Table**
 
 <a name="administration"> </a>
 
 ----
 
-**(11) TWiki Administration**
+**(12) TWiki Administration**
diff --git a/TWiki/TWikiSkins.mdwn b/TWiki/TWikiSkins.mdwn
new file mode 100644
index 0000000..7ce0c0a
--- /dev/null
+++ b/TWiki/TWikiSkins.mdwn
@@ -0,0 +1,15 @@
+Skins are customized template 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.
+
+A skin file is located in the `twiki/template` directory and has a name like `<scriptname>.<skin>.tmpl` or `<scriptname>.<topicname>.<skin>.tmpl`. For example, the `print` skin for the `view` template is <code>view<font>.print</font>.tmpl</code> (red color added for clarification).
+
+A skin can be activated in two ways:
+
+- Define the SKIN preference variable in [[TWikiPreferences]], one of the [[WebPreferences]], or a user preference. I.e.
+  - Set SKIN = wikiwiki <br />**Note:** Who has time to create the classic `wikiwiki` skin?
+- Add `?skin=name` to the URL, i.e. for this topic:
+  - <http://www.dementia.org/twiki//view/%WEB%/%TOPIC%?skin=print> (for the print view skin)
+  - <http://www.dementia.org/twiki//view/%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]] - 20 Jan 2001 <br />
diff --git a/TWiki/WebHome.mdwn b/TWiki/WebHome.mdwn
index 9112e45..c47fead 100644
--- a/TWiki/WebHome.mdwn
+++ b/TWiki/WebHome.mdwn
@@ -10,27 +10,30 @@
 
 - [[WelcomeGuest]]: Look here first to get you rolling on %WIKITOOLNAME%.
 - [[TWikiRegistration]]: Create your %WIKITOOLNAME% account in order to edit topics.
-- User documentation:
+- **_User documentation:_**
   - [[TWikiWeb]]: Explains what %WIKITOOLNAME% is.
   - [[TWikiFAQ]]: List of frequently asked questions around the %WIKITOOLNAME% tool.
   - [[TWikiTutorial]]: Get a jump start on %WIKITOOLNAME%.
   - [[GoodStyle]]: Things to consider when changing text.
   - [[WikiSyntax]], [[TextFormattingRules]]: Easy to learn rules for editing text.
   - [[TextFormattingFAQ]]: Answers to frequently asked questions about text formatting.
-- Webmaster documentation:
+  - [[TWikiVariables]]: Add variable content like other topics and inline search.
+  - [[FileAttachments]]: Add files to any topic.
+- **_Webmaster documentation:_**
   - [[TWikiHistory]] shows TWiki's implementation history.
   - [[TWikiDocumentation]] is the implementation documentation of TWiki, containing these topics:
-    - [[TWikiImplementationNotes]]
-    - [[TWikiInstallationNotes]]
-    - [[TWikiUpgradeNotes]]
-    - [[TWikiAuthentication]]
-    - [[TWikiUsernameVsLoginUsername]]
-    - [[TWikiAccessControl]]
-    - [[TWikiTemplates]]
-    - [[TWikiVariables]]
-    - [[TWikiNotificationOfChanges]]
-    - [[TWikiCategoryTable]]
-    - [[TWikiAdministration]] tells you how to rename or delete a topic or web.
+    1. [[TWikiImplementationNotes]]
+    2. [[TWikiInstallationNotes]]
+    3. [[TWikiUpgradeNotes]]
+    4. [[TWikiAuthentication]]
+    5. [[TWikiUsernameVsLoginUsername]]
+    6. [[TWikiAccessControl]]
+    7. [[TWikiTemplates]]
+    8. [[TWikiSkins]]
+    9. [[TWikiVariables]]
+    10. [[TWikiNotificationOfChanges]]
+    11. [[TWikiCategoryTable]]
+    12. [[TWikiAdministration]] tells you how to rename or delete a topic or web.
 
 <form action="http://www.dementia.org/twiki//search/%WEB%/">
   <ul>
-- 
1.9.4