From 9d1ca9125084ca6f8532ddeeefc3b2e1dbaab145 Mon Sep 17 00:00:00 2001 From: MikeMannix Date: Mon, 10 Sep 2001 00:29:31 +0000 Subject: [PATCH] none --- TWiki/ManagingWebs.mdwn | 7 ++++++- TWiki/TWikiGlossary.mdwn | 35 +++++++++++++++++++++++++++++++++++ TWiki/TWikiSkins.mdwn | 27 +++++++++++++++++++++++---- 3 files changed, 64 insertions(+), 5 deletions(-) create mode 100644 TWiki/TWikiGlossary.mdwn diff --git a/TWiki/ManagingWebs.mdwn b/TWiki/ManagingWebs.mdwn index be00c66..cebe10a 100644 --- a/TWiki/ManagingWebs.mdwn +++ b/TWiki/ManagingWebs.mdwn @@ -19,7 +19,12 @@ Managing TWiki webs requires direct access to the installation files on the host ## How to Add a New Web -- See [[TWikiInstallationGuide|Main/TWikiDocumentation#TWikiInstallationGuide]] +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 **twiki/data/**, ex: `twiki/data/newweb` +2. **Copy** in the contents of `twiki/data/_default`. + +For detailed instructions: [[TWiki Installation Guide: Creating a New Web|Main/TWikiDocumentation#CreateWeb]]. ## How to Rename or Delete a Web diff --git a/TWiki/TWikiGlossary.mdwn b/TWiki/TWikiGlossary.mdwn new file mode 100644 index 0000000..9442615 --- /dev/null +++ b/TWiki/TWikiGlossary.mdwn @@ -0,0 +1,35 @@ +
+ +
+ +# TWiki Glossary + +TWiki uses a handful of general computer and Internet terms in a TWiki-specific way. This _could_ get confusing, but it actually works out fine in use. The TWikiGlossary is also a quick way to get familiar with the overall TWiki set-up... + +**_(Under...construction: this is a rough draft)_** + +**Attachment** _aka_ **File Attachment** - upload files by browser and attach them to any page, where they can be viewed, edited, downloaded; accessed by clicking **Attach** at page bottom ([[FileAttachments]]) + +**Plugin** - a TWiki feature add-on; a Perl module that enhances TWiki, through the Plugin API spec; named `<_>Plugin.pm`, ex: `SomePlugin.pm` ([[TWikiPlugins|Main/TWikiDocumentation#TWiki_Plugins]]) + +**Plugin API** - specs for building TWiki Plugins with Perl modules ([[TWikiPlugins|Main/TWikiDocumentation#TWiki_Plugins]]) + +**Preference** - a customizable TWiki parameter; settings site-wide, by the web, by the topic on [[TWikiPreferences]] and [[WebPreferences]] pages, also on Plugins, user and regular topic pages. + +**site** - a TWiki installation consisting of one or more TWiki _[[webs|Main/WebHome#TWikiWeb]]_ + + **topic** _aka_ **WikiTopic** - a single TWiki page, it has a [[WikiName]] that's unique within its home _[[web|Main/WebHome#TWikiWeb]]_ + +**TWiki** - based on "Wiki", from the original WikiWikiWeb, first OF this style of edit-anything-anywhere Web environment; by chance, also the name of a robot (as in, the robo-head in the TWiki logo) in the old _Buck Rogers_ TV series ([[TWikiSite]]) + +**TWiki.org (twiki.org)** - official home site, center of all development, housed on SourceForge.com + +**variable** - text-strings of the form `%VARIABLE%` that are expanded on the fly into text, image, or any other type of embedded content; predefined variables are coded into the main TWiki package, Plugins variables, and user-specified variables are created in [[TWikiPreferences]], [[WebPreferences]], or single topics + + **web** - with a small "w", as opposed to the Web, World Wide; a collection of TWiki topics under a common name; topics share Preference settings, disk file structure, and are handled as a group by search + +**WikiTopic** - _see: [[topic|Main/WebHome#TWikiTopic]]_ + +-- [[MikeMannix]] - 09 Sep 2001
diff --git a/TWiki/TWikiSkins.mdwn b/TWiki/TWikiSkins.mdwn index cde4427..ca13c94 100644 --- a/TWiki/TWikiSkins.mdwn +++ b/TWiki/TWikiSkins.mdwn @@ -1,17 +1,36 @@ +
+ +
+ # TWiki Skins -Skins are customized [[TWikiTemplate|Main/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_ + +## 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. -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). +--++ 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 - Main.admin - topic. - `Set SKIN = print` + - Add `?skin=name` to the URL, for this example: - (for the print view skin) - (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
-- 1.9.4