%META:TOPICINFO{author="guest" date="1046612100" format="1.0" version="1.5"}%
<div align="center"> [ GnuSkin | <nop>GnuSkinPlugin | GnuSkinInstall | %TWIKIWEB%.TWikiPreferences | %TWIKIWEB%.TWikiPlugins ] </div>

---++ Welcome to the <nop>%TOPIC% 

This is the supplemental plugin for the GnuSkin. It provides a small Perl engine for handling dynamic, user configurable, content. For more information see the GnuSkin page.

---+++ <nop>%TOPIC% Default Settings

Plugin settings are stored as preference variables, meaning you can
put these settings in TWiki.TWikiPreferences, WebPreferences or on 
your home topic. This provides great flexibility giving both users and
system administrators the option to modify behavior as they see fit.

	* The syntax for Preferences variables is the same anywhere in TWiki. In Edit mode, from the start of a new line: <br />[6 spaces] * [space] Set [space] VARIABLENAME [space] = [value] <br /> __Example:__ 
		* ==Set VARIABLENAME = value==

Preferences are used as %TWIKIWEB%.TWikiVariables by enclosing the name in percent signs. 
To reference a plugin setting write ==%<nop>&lt;plugin&gt;_&lt;setting&gt;%==, i.e. ==%<nop>EMPTYPLUGIN_SHORTDESCRIPTION%==. Below are the settings which affect the behavior of the GnuSkin.

	* One line description, is shown in the %TWIKIWEB%.TextFormattingRules topic:
		* Set SHORTDESCRIPTION = Supplements the bare bones GnuSkin theme for TWiki

	* Debug plugin: (See output in =data/debug.txt=)
		* Set DEBUG = 0

	* If there are other skins installed the SKINHANDLER setting must be defined. This is particulary true for sites using the <nop>TigerSkin as well.
		* <nop>Set SKINHANDLER = Gnu

	* To select the GnuSkin to be used set the SKIN variable
		* <nop>Set SKIN = gnu

	* To switch between different style sheets, for better contrast with the WEBBGCOLOR setting, use this variable. Currently only 'green' and 'blue' colors are availble. If unset the GnuSkin defaults to the blue color.
		* <nop>Set SKINSTYLE = green

	* To select different colors for each web use the WEBBGCOLOR (See TWiki.StandardColors), this setting is only applicable to the WebPreferences topic.
		* <nop>Set WEBBGCOLOR = #FFE0B0

<blockquote style="background-color:#f5f5f5">
	* An example logo, named =logo.png=, is provided by the GnuSkin. To setup your own web-specific logo, attach a file named =logo.png= to the topic, WebHome, WebPreferences, or set the WEBLOGO variable to use a logo with a different name. Any logo attached to the above pages have precedence over the WEBLOGO variable - in the above order.
		* ==<nop>Set WEBLOGO = %<nop>PUBURL%/%<nop>MAINWEB%/LogoTopic/my_project_logo.png==
</blockquote>

For non-graphical user agents the =alt= attribute of the WEBLOGO is hard coded to be the ASCII representation of our favourite animal supplemented with the name of the currently displayed wiki web.

	* Diffs, when selecting the "Diffs" operation the NUMREVISIONS variable on this page determines the maximum amount of revisions to show. Prefixed with GNUSKINPLUGIN_ you can use the same variable on your home topic as well. This defaults to 5 revisions if unset.
		* Set NUMREVISIONS = 5

	* In Edit mode the user can select to "Cancel" editing, "Preview" changes or "Save" any changes immediately. If the user chooses to save the checkboxes "Release edit lock" and "Minor changes, don't notify" can be checked. If you want these settings to be be checked from start you can set the following options in [[TWiki.TWikiPreferences][TWiki.TWikiPreferences]] or WebPreferences.
		* Set RELEASEEDITLOCKCHECKBOX = checked
		* <nop>Set DONTNOTIFYCHECKBOX = checked

	* A configurable left hand menu bar - the contents can be set in an editable WebMenu topic - one for the %TWIKIWEB% web and optionally one for other webs. If there is no WebMenu topic in the current web the "Edit Menu" command edits the [[TWiki.WebMenu][TWiki.WebMenu]]. See WebMenuFormat for details. 


---++ Plugin Info

|  Plugin Author:      | HurdWiki:Main/JoachimNilsson                      |
|  Plugin Version:     | 1.2 - March 2nd 2003                              |
|  Change History:     | <!-- versions below in reverse order -->&nbsp;    |
|  02 Mar 2003:        | Version 1.2                                       |
|  14 Sep 2002:        | Version 1.1 - CVS at http://savannah.gnu.org/projects/twiki-skins/ |
|  28 May 2002:        | Project started                                   |
|  CPAN Dependencies:  | none                                              |
|  Other Dependencies: | none                                              |
|  Perl Version:       | 5.005                                             |
|  Skin Home:          | http://TWiki.org/cgi-bin/view/Plugins/GnuSkin     |
|  Installation Help:  | http://TWiki.org/cgi-bin/view/Plugins/GnuSkinInstall |
|  Plugin Home:        | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%     |
|  Feedback:           | http://TWiki.org/cgi-bin/view/Plugins/%TOPIC%Dev  |

-- HurdWiki:Main/JoachimNilsson - March 2nd 2003
