none
authorPeterThoeny <PeterThoeny>
Fri, 14 Sep 2001 09:05:09 +0000 (09:05 +0000)
committerPeterThoeny <PeterThoeny>
Fri, 14 Sep 2001 09:05:09 +0000 (09:05 +0000)
TWiki/ManagingWebs.mdwn
TWiki/TWikiAccessControl.mdwn
TWiki/TWikiMetaData.mdwn
TWiki/TWikiSkins.mdwn
TWiki/TWikiTemplates.mdwn

index cebe10a..4e21901 100644 (file)
@@ -2,8 +2,8 @@
   <ul>
     <li><a href="#Managing Webs"> Managing Webs</a><ul>
         <li><a href="#Overview"> Overview</a></li>
-        <li><a href="#How to Add a New Web"> How to Add a New Web</a></li>
-        <li><a href="#How to Rename or Delete a Web"> How to Rename or Delete a Web</a></li>
+        <li><a href="#Adding a New Web"> Adding a New Web</a></li>
+        <li><a href="#Renaming or Deleting a Web"> Renaming or Deleting a Web</a></li>
       </ul>
     </li>
   </ul>
 
 # <a name="Managing Webs"></a> Managing Webs
 
-_Adding, renaming and deleting webs is done directly on the server_
+_Adding, renaming and deleting webs are manual operations done directly on the server_
 
 ## <a name="Overview"></a> Overview
 
-Managing TWiki webs requires direct access to the installation files on the host server. There are no browser-based web tools.
+Managing TWiki webs requires direct access to the installation files on the host server. There are currently no browser-based equivalents of the Rename/move/delete topic tools for working with webs.
 
-## <a name="How to Add a New Web"></a> How to Add a New Web
+## <a name="Adding a New Web"></a> Adding a New Web
 
 Adding new webs is quick and easy - you can have a basic web up and running in a couple of minutes:
 
-1. **Create** a new directory under <code>**twiki/data/**</code>, ex: `twiki/data/newweb`
+1. **Create** a new directory under `twiki/data/`, ex: `twiki/data/Newweb`<br />
+  - the name has to start with a capital and _cannot_ be a [[WikiWord]]
 2. **Copy** in the contents of `twiki/data/_default`.
 
-For detailed instructions: [[TWiki Installation Guide: Creating a New Web|Main/TWikiDocumentation#CreateWeb]].
+For detailed instructions, see [[TWiki Installation Guide: Adding a New Web|Main/TWikiDocumentation#CreateWeb]].
 
-## <a name="How to Rename or Delete a Web"></a> How to Rename or Delete a Web
+## <a name="Renaming or Deleting a Web"></a> Renaming or Deleting a Web
 
-**NOTE:** Think twice if you intend to rename the %WIKITOOLNAME%.Main web, since many files point to it. If you rename it, you also have to change all occurrences of `Main` to the new web name (like the web prefixes for all user signatures, `Main.SomeName`). (On the other hand, if the `%MAINWEB%` variable is used throughout, you won't have that problem.)
+**NOTE:** If you plan to rename the %WIKITOOLNAME%.Main web, remember that TWiki stores user and group topics in <code>%MAINWEB%</code>, default named `Main`. That means, every [[WikiName]] signature - `Main.SomeUserName` - points to it and would need updating (unless the variable, `%MAINWEB%.SomeUserName`, is used throughout).
 
-1. Prepare your site: Other webs may link to the web you want to rename or delete. Search each web for links to the target web: search all webs for `Abouttochange.` - include the period to find topics like `Abouttochange.SomeTopic`. Make changes as required.
+1. Prepare your site: Search each web for links to the target web, searching topic text for `Oldwebname.`, including the dot so you'll find references like `Oldwebname.SomeTopic`.
+  - Make changes as required, to `Newwebname.SomeTopic` or better yet, to `=%MAINWEB%.SomeTopic`.
 2. Edit the [[TWikiPreferences]] topic: Rename or delete the web from the `WIKIWEBLIST` variable.
 3. Edit the [[TWikiWebsTable]] topic: Rename or delete the web from the table.
-4. Connect to the %WIKITOOLNAME% server: Login via Telnet or FTP.
-5. Edit the data files: Go to `twiki/data` and rename or delete the web directory.
-6. Edit the template files: Go to `twiki/templates` and rename or delete the web directory if present.
-7. Edit the public files: Go to `twiki/pub` and rename or delete the web directory if present.
+4. Login to the %WIKITOOLNAME% server, via Telnet or FTP.
+5. Go to `twiki/data` and rename or remove the web directory.
+6. Go to `twiki/templates` and rename or remove the web directory if present.
+7. Go to `twiki/pub` and rename or remove the web directory if present.
 
--- [[MikeMannix]] - 29 Aug 2001 <br />
+-- [[MikeMannix]] - 14 Sep 2001 <br />
index f569769..7c43487 100644 (file)
@@ -37,7 +37,7 @@ _Restricting read and write access to topics and webs, by users and groups_
 
 ## <a name="Overview"></a> Overview
 
-[[TWikiAccessControl]] allows you restrict access to single topics and entire webs, by individual user and by user groups, in three main areas: view; edit &amp; attach; and rename/move/delete. These controls, combined with [[TWikiUserAuthentication|Main/TWikiDocumentation#TWiki_User_Authentication]], let you easily create and manage an extremely flexible, fine-grained privilege system.
+[[TWikiAccessControl]] allows you restrict access to single topics and entire webs, by individual user and by user groups, in three main areas: view; edit &amp; attach; and rename/move/delete. These controls, combined with [[TWikiUserAuthentication]], let you easily create and manage an extremely flexible, fine-grained privilege system.
 
 ## <a name="An Important Control Considerati"></a> An Important Control Consideration
 
@@ -48,7 +48,7 @@ Open, freeform editing is the essence of the [[WikiCulture]] - it's what makes T
 - Peer editing - the ability to rearrange anything on a page - keeps topics focussed.
 
 - All content is preserved under revision control.
-  - Edits can be undone by the [[TWikiAdminGroup]] (the default administrators group; see [[Managing Groups|Main/WebHome#ManagingGroups]]).
+  - Edits can be undone by the [[TWikiAdminGroup]] (the default administrators group; see #ManagingGroups).
   - Users are encouraged to edit and refactor (condense a long topic), since there's a safety net.
 
 As a collaboration guideline:
@@ -62,9 +62,9 @@ Access control is based on users and groups. Users are defined by their [[WikiNa
 
 ### <a name="Managing Users"></a> Managing Users
 
-A user is created by with the [TWikiRegistration](%SCRIPTULRPATH%/view/TWiki/TWikiRegistration) form. The process generates a topic in the Main web in the new user's [[WikiName]]. The default visitor name is [[TWikiGuest]].
+A user is created by with the [[TWikiRegistration]] form. The process generates a topic in the Main web in the new user's [[WikiName]]. The default visitor name is [[TWikiGuest]].
 
-- Users can be authenticated using Basic Authentication or SSL. [[Authentication|Main/TWikiDocumentation#TWikiAuthentication]] is required in order to track user identities.
+- Users can be authenticated using Basic Authentication or SSL. [[TWikiUserAuthentication]] is required in order to track user identities.
 
 <a name="ManagingGroups"></a>
 
@@ -154,13 +154,13 @@ You can define restrictions of who is allowed to view a %WIKITOOLNAME% web.
 ### <a name="Known Issues"></a> Known Issues
 
 - The view restriction is not suitable for very sensitive content since there is a way to circumvent the read access restriction.
-- Read access restriction only works if the view script is authenticated, that means that users need to log on also just to read topics. [[TWiki Installation Guide|Main/TWikiDocumentation#TWikiInstallationGuide]] has more on Basic Authentication based on the <code>**.htaccess**</code> file.
+- Read access restriction only works if the view script is authenticated, that means that users need to log on also just to read topics. [[TWikiInstallationGuide]] has more on Basic Authentication based on the <code>**.htaccess**</code> file.
 
 #### <a name="Selective Unrestricted Web Acces"></a> Selective Unrestricted Web Access
 
 - There is a workaround if you prefer to have unrestricted access to view topics located in normal webs, and to authenticate users only for webs where view restriction is enabled:
   1. **Omit** the <code>**view**</code> script from the `.htaccess` file.
-  2. **Enable** the <code>**$doRememberRemoteUser**</code> flag in <code>**lib/wikicfg.pm**</code> as described in [[User Authentication|Main/TWikiDocumentation#TWikiUserAuthentication]]. %WIKITOOLNAME% will now remember the IP address of an authenticated user.
+  2. **Enable** the <code>**$doRememberRemoteUser**</code> flag in <code>**lib/TWiki.cfg**</code> as described in [[TWikiUserAuthentication]]. %WIKITOOLNAME% will now remember the IP address of an authenticated user.
   3. **Copy** the <code>**view**</code> script to <code>**viewauth**</code> (or better, create a symbolic link)
   4. **Add** <code>**viewauth**</code> to the list of authenticated scripts in the .htaccess file.
     - When a user accesses a web where you enabled view restriction, %WIKITOOLNAME% will redirect from the `view` script to the `viewauth` script once (this happens only if the user has never edited a topic). Doing so will ask for authentication. The `viewauth` script shows the requested topic if the user could log on and if the user is authorized to see that web.
index e695080..f51ef85 100644 (file)
@@ -2,16 +2,14 @@
   <ul>
     <li><a href="#TWiki Meta Data"> TWiki Meta Data</a><ul>
         <li><a href="#Overview"> Overview</a></li>
-        <li><a href="#Meta Data Syntax"> Meta Data Syntax</a><ul>
-            <li><a href="#Specifications"> Specifications</a><ul>
-                <li><a href="#TOPICINFO"> TOPICINFO</a></li>
-                <li><a href="#TOPICMOVED"> TOPICMOVED</a></li>
-                <li><a href="#TOPICPARENT"> TOPICPARENT</a></li>
-                <li><a href="#FILEATTACHMENT"> FILEATTACHMENT</a></li>
-                <li><a href="#FORM"> FORM</a></li>
-                <li><a href="#FIELD"> FIELD</a></li>
-              </ul>
-            </li>
+        <li><a href="#Meta Data Syntax"> Meta Data Syntax</a></li>
+        <li><a href="#Meta Data Specifications"> Meta Data Specifications</a><ul>
+            <li><a href="#META:TOPICINFO"> META:TOPICINFO</a></li>
+            <li><a href="#META:TOPICMOVED"> META:TOPICMOVED</a></li>
+            <li><a href="#META:TOPICPARENT"> META:TOPICPARENT</a></li>
+            <li><a href="#META:FILEATTACHMENT"> META:FILEATTACHMENT</a></li>
+            <li><a href="#META:FORM"> META:FORM</a></li>
+            <li><a href="#META:FIELD"> META:FIELD</a></li>
             <li><a href="#Recommended Sequence"> Recommended Sequence</a></li>
           </ul>
         </li>
@@ -31,12 +29,12 @@ _Topic data not editable from main freeform text box, stored in name/value `META
 
 ## <a name="Overview"></a> Overview
 
-TWikiMetaData uses `META` variables to store topic data that's separate from the main free-form content. This includes program-generated info like [[FileAttachment]] data, and user-defined [[Form Template|Main/TWikiDocumentation#TWiki_Form_Templates]] info.
+TWikiMetaData uses `META` variables to store topic data that's separate from the main free-form content. This includes program-generated info like [[FileAttachment]] data, and user-defined [[TWikiForms]] info.
 
 ## <a name="Meta Data Syntax"></a> Meta Data Syntax
 
-- Format is the same as in [[TWikiVariables|Main/TWikiDocumentation#TWiki_Variables]], except all fields have a key.
-  - %META:&lt;type&gt;\{key1="value1" [key2="value2" [...]]\}%
+- Format is the same as in [[TWikiVariables]], except all fields have a key.
+  - `%META:<type>{key1="value1" key2="value2" ...}%`
 
 - Order of fields within the meta variables is not defined, except that if there is a field with key `name`, this appears first for easier searching (note the order of the variables themselves is defined).
 
@@ -46,22 +44,22 @@ TWikiMetaData uses `META` variables to store topic data that's separate from the
 
 > **Example of Format**
 >
->     %<nop>META:TOPICINFO{version="1.6" date="976762663" author="PeterThoeny" format="1.0"}%
->        text of the topic
->     %<nop>META:TOPICMOVED{from="Codev.OldName" to="CoDev.NewName"
->        by="JohnTalintyre" date="976762680"}%
->     %<nop>META:TOPICPARENT{name="NavigationByTopicContext"}%
->     %<nop>META:FILEATTACHMENT{name="Sample.txt" version="1.3" ... }%
->     %<nop>META:FILEATTACHMENT{name="Smile.gif" version="1.1" ... }%
->     %<nop>META:FORM{name="WebFormTemplate"}%
->     %<nop>META:FIELD{name="OperatingSystem" value="OsWin"}%
->     %<nop>META:FIELD{name="TopicClassification" value="PublicFAQ"}%
-
-### <a name="Specifications"></a> Specifications
+>     %META:TOPICINFO{version="1.6" date="976762663" author="PeterThoeny" format="1.0"}%
+>      text of the topic
+>     %META:TOPICMOVED{from="Codev.OldName" to="Codev.NewName"
+>      by="JohnTalintyre" date="976762680"}%
+>     %META:TOPICPARENT{name="NavigationByTopicContext"}%
+>     %META:FILEATTACHMENT{name="Sample.txt" version="1.3" ... }%
+>     %META:FILEATTACHMENT{name="Smile.gif" version="1.1" ... }%
+>     %META:FORM{name="WebFormTemplate"}%
+>     %META:FIELD{name="OperatingSystem" value="OsWin"}%
+>     %META:FIELD{name="TopicClassification" value="PublicFAQ"}%
+
+## <a name="Meta Data Specifications"></a> Meta Data Specifications
 
 The current version of Meta Data is 1.0, with support for the following variables.
 
-#### <a name="TOPICINFO"></a> TOPICINFO
+### <a name="META:TOPICINFO"></a> META:TOPICINFO
 
 <table border="1" cellpadding="0" cellspacing="0">
   <tr>
@@ -86,11 +84,11 @@ The current version of Meta Data is 1.0, with support for the following variable
   </tr>
 </table>
 
-#### <a name="TOPICMOVED"></a> TOPICMOVED
+### <a name="META:TOPICMOVED"></a> META:TOPICMOVED
 
-This is optional, exists if topic has ever been moved. If a topic is moved more than once, only the most recent TOPICMOVED meta variable exists in the topic, older ones are to be found in the rcs history.
+This is optional, exists if topic has ever been moved. If a topic is moved more than once, only the most recent META:TOPICMOVED meta variable exists in the topic, older ones are to be found in the rcs history.
 
-%META:TOPICMOVED\{from="Codev.OldName" to="CoDev.NewName" by="talintj" date="976762680"\}%
+`%META:TOPICMOVED{from="Codev.OldName" to="Codev.NewName" by="talintj" date="976762680"}%`
 
 <table border="1" cellpadding="0" cellspacing="0">
   <tr>
@@ -120,7 +118,7 @@ Notes:
 - at present version number is not supported directly, it can be inferred from the RCS history.
 - there is only one META:TOPICMOVED in a topic, older move information can be found in the RCS history.
 
-#### <a name="TOPICPARENT"></a> TOPICPARENT
+### <a name="META:TOPICPARENT"></a> META:TOPICPARENT
 
 <table border="1" cellpadding="0" cellspacing="0">
   <tr>
@@ -133,7 +131,7 @@ Notes:
   </tr>
 </table>
 
-#### <a name="FILEATTACHMENT"></a> FILEATTACHMENT
+### <a name="META:FILEATTACHMENT"></a> META:FILEATTACHMENT
 
 <table border="1" cellpadding="0" cellspacing="0">
   <tr>
@@ -178,6 +176,10 @@ Extra fields that are added if an attachment is moved:
 
 <table border="1" cellpadding="0" cellspacing="0">
   <tr>
+    <th bgcolor="#99CCCC"><strong> Key </strong></th>
+    <th bgcolor="#99CCCC"><strong> Comment </strong></th>
+  </tr>
+  <tr>
     <td> movedfrom </td>
     <td> full topic name - web.topic </td>
   </tr>
@@ -195,7 +197,7 @@ Extra fields that are added if an attachment is moved:
   </tr>
 </table>
 
-#### <a name="FORM"></a> FORM
+### <a name="META:FORM"></a> META:FORM
 
 <table border="1" cellpadding="0" cellspacing="0">
   <tr>
@@ -204,13 +206,13 @@ Extra fields that are added if an attachment is moved:
   </tr>
   <tr>
     <td> name </td>
-    <td> A topic name - the topic is a [[Main/TWikiDocumentation#Form_Template]]. Can optionally include the web name i.e. web.topic, but doesn't normally </td>
+    <td> A topic name - the topic represents one of the [[Main/TWikiForms]]. Can optionally include the web name i.e. web.topic, but doesn't normally </td>
   </tr>
 </table>
 
-#### <a name="FIELD"></a> FIELD
+### <a name="META:FIELD"></a> META:FIELD
 
-Should only be present if there is a FORM entry. Note that this data is used when viewing a topic, the form template definition is not read.
+Should only be present if there is a META:FORM entry. Note that this data is used when viewing a topic, the form template definition is not read.
 
 <table border="1" cellpadding="0" cellspacing="0">
   <tr>
@@ -219,11 +221,11 @@ Should only be present if there is a FORM entry. Note that this data is used whe
   </tr>
   <tr>
     <td> name </td>
-    <td> Ties to entry in [[Main/TWikiDocumentation#Form_Template]], is title with all bar alphanumerics and . removed </td>
+    <td> Ties to entry in [[Main/TWikiForms]] template, is title with all bar alphanumerics and . removed </td>
   </tr>
   <tr>
     <td> title </td>
-    <td> Full text from [[Main/TWikiDocumentation#Form_Template]]</td>
+    <td> Full text from [[Main/TWikiForms]] template </td>
   </tr>
   <tr>
     <td> value </td>
@@ -240,13 +242,13 @@ There is no absolute need for Meta Data variables to be listed in a specific ord
 
 The recommended sequence is:
 
-- TOPICINFO
+- META:TOPICINFO
 - `text of topic`
-- TOPICMOVED (optional)
-- TOPICPARENT (optional)
-- FILEATTACHMENT (0 or more entries)
-- FORM (optional)
-- FIELD (0 or more entries; FORM required)
+- META:TOPICMOVED (optional)
+- META:TOPICPARENT (optional)
+- META:FILEATTACHMENT (0 or more entries)
+- META:FORM (optional)
+- META:FIELD (0 or more entries; FORM required)
 
 ## <a name="Viewing Meta Data in Page Source"></a> Viewing Meta Data in Page Source
 
@@ -267,7 +269,7 @@ Current support covers:
   </tr>
   <tr>
     <td> %META{"form"}% </td>
-    <td> Show form data, see [[Main/TWikiDocumentation#Form_Templates]]</td>
+    <td> Show form data, see [[Main/TWikiForms]]</td>
   </tr>
   <tr>
     <td> %META{"attachments"}% </td>
@@ -306,15 +308,11 @@ Current support covers:
     <td> Suffix, only appears if there are parents; default "" </td>
   </tr>
   <tr>
-    <td> seperator="..." </td>
+    <td> separator="..." </td>
     <td> Separator between parents, default is " &gt; " </td>
   </tr>
 </table>
 
-- **Future Development:** There are numerous development directions and specific features to consider. A couple of obvious possibilities:
-  - Rendering to formats other than tables: bullet lists, formatted body text;
-  - Specifying templates to be used for rendering.
-
 ## <a name="Known Issues"></a> Known Issues
 
 At present, there is no Meta Data support for Plugins. However, the format is readily extendable and the `Meta.pm` code that supports the format needs only minor alteration.
index ca13c94..cff820e 100644 (file)
@@ -2,6 +2,7 @@
   <ul>
     <li><a href="#TWiki Skins"> TWiki Skins</a><ul>
         <li><a href="#Overview"> Overview</a></li>
+        <li><a href="#Defining Skins"> Defining Skins</a></li>
         <li><a href="#Activating Skins"> Activating Skins</a></li>
       </ul>
     </li>
@@ -14,9 +15,9 @@ _Overlay regular templates with alternate header/footer layouts_
 
 ## <a name="Overview"></a> Overview
 
-Skins are customized [[TWiki Templates|Main/TWikiDocumentation#TWiki_Template_System]] 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.
+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
+## <a name="Defining Skins"></a> 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`.
 
index 641faec..27c8797 100644 (file)
@@ -10,6 +10,7 @@
             <li><a href="#Sample screen shot of oopstest.t"> Sample screen shot of oopstest.tmpl</a></li>
           </ul>
         </li>
+        <li><a href="#TWiki master template"> TWiki master template</a></li>
         <li><a href="#Known Issues"> Known Issues</a></li>
       </ul>
     </li>
@@ -22,7 +23,7 @@ _Definition of the templates used to render all HTML pages displayed in TWiki_
 
 ## <a name="Overview"></a> Overview
 
-The new modular template system is more flexible, efficient, and easily updated than the old set-up, where each template is a complete HTML file. The new master template approach places common templates parts, like headers and footers, in one shared file. This simplifies the conversion of templates into XHTML format, and provides a more versatile solution for templates and for [[skins|Main/TWikiDocumentation#TWiki_Skins]].
+The new modular template system is more flexible, efficient, and easily updated than the old set-up, where each template is a complete HTML file. The new master template approach places common templates parts, like headers and footers, in one shared file. This simplifies the conversion of templates into XHTML format, and provides a more versatile solution for templates and for [[TWikiSkins]].
 
 ## <a name="Major changes from the previous"></a><a name="Major changes from the previous "></a> Major changes from the previous template system
 
@@ -40,15 +41,14 @@ The main difference is that templates are now defined using variables to include
 - Use of template directives is optional, templates work without them.
 - All template preprocessing is done in `&TWiki::Store::readTemplate()` so that the caller simply gets an expanded template file (the same as before).
 - Directives are of the form `%TMPL:<key>%` and `%TMPL:<key>{"attr"}%`.
-- Initial set of directives:
-  - `%TMPL:INCLUDE{"file"}%`: Includes a template file. The usual search path is applied.
+- Directives:
+  - `%TMPL:INCLUDE{"file"}%`: Includes a template file. The template directory of the current web is searched first, then the templates root (`twiki/templates`).
   - `%TMPL:DEF{"var"}%`: Define a variable. Text between this and the END directive is not returned, but put into a hash for later use.
   - `%TMPL:END%`: Ends variable definition.
   - `%TMPL:P{"var"}%`: Prints a previously defined variable.
-- New directives can be added over time when needed, ex: IF-THEN-ELSE.
 - Variables are live in a global name space, there is no parameter passing.
 - Two-pass processing, so that you can use a variable before declaring it or after.
-- Templates and [[skins|Main/TWikiDocumentation#TWiki_Skins]] work transparently and interchangeably. For example, you can create a skin that overloads just the `twiki.tmpl`, like `twiki.print.tmpl`, that redefines the header and footer.
+- Templates and [[TWikiSkins]] work transparently and interchangeably. For example, you can create a skin that overloads just the `twiki.tmpl`, like `twiki.print.tmpl`, that redefines the header and footer.
 - **_Note:_** The template directives work only for templates, they do not get processed in topic text.
 
 ## <a name="New Template System by Example"></a> New Template System by Example
@@ -59,51 +59,49 @@ Attached is an example of an oops base template `oopsbase.tmpl` and a example oo
 
 The first line declares the delimiter variable called "sep", used to separate multiple link items. The variable can be called anywhere by writing `%TMPL:P{"sep"}%`
 
-**_NOTE:_** Added a dot to escape rendering of variables, i.e. read <code>**%.WEB%**</code> as <code>**%WEB%**</code>.
-
-> <table border="1" cellspacing="0" cellpadding="1">
->     <tr><td>
->     <verbatim>
->     %.TMPL:DEF{"sep"}% | %.TMPL:END%
->     <html>
->     <head>
->       <title> %.WIKITOOLNAME% . %.WEB% . %.TOPIC% %.TMPL:P{"titleaction"}%</title>
->       <base href="%.SCRIPTURL%/view%.SCRIPTSUFFIX%/%.WEB%/%.TOPIC%">
->       <meta name="robots" content="noindex">
->     </head>
->     <body bgcolor="#FFFFFF">
->     <table width="100%" border="0" cellpadding="3" cellspacing="0">
->       <tr>
->       <td bgcolor="%.WEBBGCOLOR%" rowspan="2" valign="top" width="1%">
->              <a href="%.WIKIHOMEURL%">
->              <img src="%.PUBURLPATH%/wikiHome.gif" border="0"></a>
->       </td>
->       <td>
->              <b>%.WIKITOOLNAME% . %.WEB% . </b><font size="+2">
->              <B>%.TOPIC%</b> %.TMPL:P{"titleaction"}%</font>
->       </td>
->       </tr>
->       <tr bgcolor="%.WEBBGCOLOR%">
->       <td colspan="2">
->              %.TMPL:P{"webaction"}%
->       </td>
->       </tr>
->     </table>
->     --- ++ %.TMPL:P{"heading"}%
->     %.TMPL:P{"message"}%
->     <table width="100%" border="0" cellpadding="3" cellspacing="0">
->       <tr bgcolor="%.WEBBGCOLOR%">
->       <td valign="top">
->              Topic <b>%TOPIC%</b> . {
->                %.TMPL:P{"topicaction"}%
->              }
->       </td>
->       </tr>
->     </table>
->     </body>
->     </verbatim>
->     </td></tr>
->     </table >
+> <table border="1" cellpadding="1" cellspacing="0">
+>   <tr>
+>     <td><pre>
+> %TMPL:DEF{"sep"}% | %TMPL:END%
+> &lt;html&gt;
+> &lt;head&gt;
+>   &lt;title&gt; %WIKITOOLNAME% . %WEB% . %TOPIC% %.TMPL:P{"titleaction"}%&lt;/title&gt;
+>   &lt;base href="%SCRIPTURL%/view%SCRIPTSUFFIX%/%WEB%/%TOPIC%"&gt;
+>   &lt;meta name="robots" content="noindex"&gt;
+> &lt;/head&gt;
+> &lt;body bgcolor="#FFFFFF"&gt;
+> &lt;table width="100%" border="0" cellpadding="3" cellspacing="0"&gt;
+>   &lt;tr&gt;
+>       &lt;td bgcolor="%WEBBGCOLOR%" rowspan="2" valign="top" width="1%"&gt;
+>              &lt;a href="%WIKIHOMEURL%"&gt;
+>              &lt;img src="%PUBURLPATH%/wikiHome.gif" border="0"&gt;&lt;/a&gt;
+>       &lt;/td&gt;
+>       &lt;td&gt;
+>              &lt;b&gt;%WIKITOOLNAME% . %WEB% . &lt;/b&gt;&lt;font size="+2"&gt;
+>              &lt;B&gt;%TOPIC%&lt;/b&gt; %TMPL:P{"titleaction"}%&lt;/font&gt;
+>       &lt;/td&gt;
+>   &lt;/tr&gt;
+>   &lt;tr bgcolor="%WEBBGCOLOR%"&gt;
+>       &lt;td colspan="2"&gt;
+>              %TMPL:P{"webaction"}%
+>       &lt;/td&gt;
+>   &lt;/tr&gt;
+> &lt;/table&gt;
+> --- ++ %TMPL:P{"heading"}%
+> %TMPL:P{"message"}%
+> &lt;table width="100%" border="0" cellpadding="3" cellspacing="0"&gt;
+>   &lt;tr bgcolor="%WEBBGCOLOR%"&gt;
+>       &lt;td valign="top"&gt;
+>              Topic &lt;b&gt;%TOPIC%&lt;/b&gt; . {
+>                %TMPL:P{"topicaction"}%
+>              }
+>       &lt;/td&gt;
+>   &lt;/tr&gt;
+> &lt;/table&gt;
+> &lt;/body&gt;
+> </pre></td>
+>   </tr>
+> </table>
 
 ### <a name="Test template oopstest.tmpl"></a> Test template oopstest.tmpl
 
@@ -112,24 +110,24 @@ Each oops template basically just defines some variables and includes the base t
 > <table border="1" cellpadding="1" cellspacing="0">
 >   <tr>
 >     <td><pre>
-> %.TMPL:DEF{"titleaction"}% (test =titleaction=) %.TMPL:END%
-> %.TMPL:DEF{"webaction"}% test =webaction= %.TMPL:END%
-> %.TMPL:DEF{"heading"}%
-> Test heading %.TMPL:END%
-> %.TMPL:DEF{"message"}%
+> %TMPL:DEF{"titleaction"}% (test =titleaction=) %TMPL:END%
+> %TMPL:DEF{"webaction"}% test =webaction= %TMPL:END%
+> %TMPL:DEF{"heading"}%
+> Test heading %TMPL:END%
+> %TMPL:DEF{"message"}%
 > Test =message=. Blah blah blah blah blah blah blah blah blah blah blah...
 >
->    * Some more blah blah blah blah blah blah blah blah blah blah...
->    * Param1: %PARAM1%
->    * Param2: %PARAM2%
->    * Param3: %PARAM3%
->    * Param4: %PARAM4%
-> %.TMPL:END%
-> %.TMPL:DEF{"topicaction"}%
+>      * Some more blah blah blah blah blah blah blah blah blah blah...
+>      * Param1: %PARAM1%
+>      * Param2: %PARAM2%
+>      * Param3: %PARAM3%
+>      * Param4: %PARAM4%
+> %TMPL:END%
+> %TMPL:DEF{"topicaction"}%
 > Test =topicaction=:
-> [[%.WEB%.%TOPIC%][OK]] %.TMPL:P{"sep"}%
-> [[%.TWIKIWEB%.TWikiRegistration][Register]] %.TMPL:END%
-> %.TMPL:INCLUDE{"oopsbase"}%
+> [[%WEB%.%TOPIC%][OK]] %TMPL:P{"sep"}%
+> [[%TWIKIWEB%.TWikiRegistration][Register]] %TMPL:END%
+> %TMPL:INCLUDE{"oopsbase"}%
 > </pre></td>
 >   </tr>
 >   <tr>
@@ -147,6 +145,8 @@ With URL: <code>**.../bin/oops/Test/TestTopic2?template=oopstest&amp;param1=WebH
 >   </tr>
 > </table>
 
+## <a name="TWiki master template"></a> TWiki master template
+
 All common template parts are defined in one master template, `twiki.tmpl`, that all other templates include.
 
 <table border="1" cellpadding="0" cellspacing="0">
@@ -180,7 +180,7 @@ All common template parts are defined in one master template, `twiki.tmpl`, that
   </tr>
 </table>
 
-> **Example: `preview.tmpl` template**
+> **Example: `oopspreview.tmpl` template**
 >
 >     %TMPL:INCLUDE{"twiki"}%
 >     %TMPL:DEF{"titleaction"}% (oops) %TMPL:END%