none
authorMikeMannix <MikeMannix>
Sun, 16 Sep 2001 06:18:59 +0000 (06:18 +0000)
committerMikeMannix <MikeMannix>
Sun, 16 Sep 2001 06:18:59 +0000 (06:18 +0000)
TWiki/TWikiInstallationGuide.mdwn
TWiki/TWikiMetaData.mdwn
TWiki/TWikiPlugins.mdwn
TWiki/TWikiSkins.mdwn
TWiki/TWikiTemplates.mdwn
TWiki/WikiSyntax.mdwn

index 5ae9078..916301b 100644 (file)
 
 # <a name="TWiki Installation Guide"></a> TWiki Installation Guide
 
-_Installation instructions for the current public release (01-Sep-2001)_
+_Installation instructions for the TWiki 01-Sep-2001 production release_
 
 ## <a name="Overview"></a> Overview
 
 These installation steps are based on the Apache Web server on Linux. TWiki runs on other Web servers and Unix systems, and should be fine with any OS and server that meet the [[system requirements|Main/TWikiImplementationNotes]]. Documentation for other platforms is currently limited. For Windows, check TWiki:Codev/TWikiOnWindows. Search the TWiki:Codev web for other intallation notes.
 
-- **_NOTE:_** This Guide assumes user `nobody` ownership for all files manipulated by the CGI scripts (executed by the Web server), and user `twiki` for all other files. You can:
-  - replace `nobody` with another user if your server executes scripts under a different name (ex: default for Debian is `www-data`).
-  - replace user `twiki` with your own username
-
 <a name="StandardInstallation"></a>
 
 ## <a name="Standard Installation"></a> Standard Installation
 
-Request and download the TWiki 01-Sep-2001 distribution in Unix ZIP format from <http://TWiki.org/download.html>.
+Request and download the TWiki 01-Sep-2001 distribution in Unix ZIP format from <http://TWiki.org/download.html>. _(To install TWiki on SourceForge, for use on a software development project, read TWiki:Codev/SourceForgeHowTo.)_
+
+- **_NOTE:_** This Guide assumes user `nobody` ownership for all files manipulated by the CGI scripts (executed by the Web server), and user `twiki` for all other files. You can:
+  - replace `nobody` with another user if your server executes scripts under a different name (ex: default for Debian is `www-data`).
+  - replace user `twiki` with your own username
 
 ### <a name="Step 1: Create  Configure the Di"></a> Step 1: Create &amp; Configure the Directories
 
-- **_NOTE:_** _If you don't have access to your Web server configuration files - for example, if you're installing on an ISP-hosted account - use the [[alternative Step 1|Main/WebHome#StepOneB]] instead._
-- **_NOTE:_** To install TWiki on SourceForge, for use on a software development project, read TWiki:Codev/SourceForgeHowTo.
+**_NOTE:_** _If you don't have access to your Web server configuration files - for example, if you're installing on an ISP-hosted account - use the [[alternative Step 1|Main/WebHome#StepOneB]] instead._
 
 - Create directory `/home/httpd/twiki` and unzip the TWiki distribution into this directory.
 - The `twiki/bin` directory of TWiki must be set as a cgi-bin directory. Add `/home/httpd/twiki/bin` to file `/etc/httpd/httpd.conf` with only `ExecCGI` option.
index f51ef85..5a2f0cc 100644 (file)
@@ -25,7 +25,7 @@
 
 # <a name="TWiki Meta Data"></a> TWiki Meta Data
 
-_Topic data not editable from main freeform text box, stored in name/value `META` variable pairs_
+_Additional topic data, not editable from main freeform text box, stored in `META` variable name/value pairs_
 
 ## <a name="Overview"></a> Overview
 
index d46e30c..5aac893 100644 (file)
@@ -203,7 +203,7 @@ The Plugin documentation topic contains usage instructions and version details.
 2. **Customize** the template for your Plugin; you'll probably want to post a working version on your local TWiki site.
 3. **Save** your topic as a text file, for use in [[packaging|Main/WebHome#CreatePluginPackage]] and [[publishing|Main/WebHome#PublishPlugin]] your Plugin.
 
-> <span><font>**OUTLINE:** Doc Topic Contents </font></span>
+> **OUTLINE: Doc Topic Contents**
 >
 > <br />
 >
index cff820e..b208a12 100644 (file)
@@ -11,7 +11,7 @@
 
 # <a name="TWiki Skins"></a> TWiki Skins
 
-_Overlay regular templates with alternate header/footer layouts_
+_Skins overlay regular templates with alternate header/footer layouts; topic text is not affected_
 
 ## <a name="Overview"></a> Overview
 
index 35b9da0..f5f9a53 100644 (file)
@@ -1,6 +1,6 @@
 <div>
   <ul>
-    <li><a href="#TWiki Template System"> TWiki Template System</a><ul>
+    <li><a href="#TWiki Templates"> TWiki Templates</a><ul>
         <li><a href="#Overview"> Overview</a></li>
         <li><a href="#Major changes from the previous"> Major changes from the previous template system</a></li>
         <li><a href="#Functional Specifications"> Functional Specifications</a></li>
   </ul>
 </div>
 
-# <a name="TWiki Template System"></a> TWiki Template System
+# <a name="TWiki Templates"></a> TWiki Templates
 
 _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 [[TWikiSkins]].
+The new modular template system offers flexible, easy control over the layout of all TWiki pages. The master template approach groups parts that are shared by several templates - like headers and footers - in a common file. Special variables allow individual layouts to include parts from a master template - variables are mixed with regular HTML mark-up for template-specific content.
 
 ## <a name="Major changes from the previous"></a><a name="Major changes from the previous "></a> Major changes from the previous template system
 
-The main difference is that templates are now defined using variables to include template parts. You change one stored instance of a common element to update all occurrences. The new system:
+Where the old templates were each complete HTML documents, the new templates are defined using variables to include template parts from a master file. You can now change one instance of a common element to update all occurrences; previously, every affected template had to be updated. This simplifies the conversion of templates into XHTML format, and provides a more versatile solution for templates and for [[TWikiSkins]]. The new system:
 
 - separates a set of common template parts into a base template that is included by all of the related templates;
-
 - defines common variables, like a standard separator (ex: "|"), in the base template;
-
 - defines variable text in the individual templates and passes it back to the base template.
 
 ## <a name="Functional Specifications"></a> Functional Specifications
@@ -57,7 +55,7 @@ The main difference is that templates are now defined using variables to include
 - 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 [[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.
+- **_NOTE:_** The template directives work only for templates, they do not get processed in topic text.
 
 ## <a name="TWiki Master Template"></a> TWiki Master Template
 
index aa58c2b..9b05208 100644 (file)
@@ -40,8 +40,8 @@ If you can enter text, write an email, you're ready for TWiki. Use simple, intui
 
 - Use three (or more) consecutive **hyphens** expands into a horizontal rule: `---`
 
-----
-
 - See [[TextFormattingRules]] for more....
 
+----
+
 -- [[MikeMannix]] - 14 Sep 2001 <br />