From 08351230f3ffed071954fe0d5a7dd113d3fa177b Mon Sep 17 00:00:00 2001 From: Joachim Nilsson Date: Fri, 12 Jul 2002 15:07:00 +0000 Subject: none --- TWiki/GnuSkinPlugin.mdwn | 97 +++++++----------------------------------------- 1 file changed, 13 insertions(+), 84 deletions(-) (limited to 'TWiki') diff --git a/TWiki/GnuSkinPlugin.mdwn b/TWiki/GnuSkinPlugin.mdwn index 86a4f3ea..af18356d 100644 --- a/TWiki/GnuSkinPlugin.mdwn +++ b/TWiki/GnuSkinPlugin.mdwn @@ -1,97 +1,28 @@ -* Description - * Set SHORTDESCRIPTION = A complete bare bones skin theme template for TWiki +## Welcome to the %TOPIC% -* Debug plugin? Output can be viewed in data/debug.txt - * Set DEBUG = 0 - -The [[GnuSkin]] makes use of most the [[WebMenu]] concept, first introduced by the [[TigerSkin]]. See it in action on the [[Know/WebHome]]. - -Status: It's at beta stage. Now I only have to start ripping out allt the pieces that still say [[TigerSkin]] and are redundant before I start distributing this. - -Download: Send me an email if you want a snapshot. - -See the [[GnuSkinPluginDev]] for development talk, - --- [[Main/JoachimNilsson]] - 04 Jun 2002 - -## %TOPIC% - -The [[GnuSkin]] plugin is a rip off from the [[TigerSkinPlugin]]. The main intentions are to simplify the design enough to get a basic and yet useful environment suitable for production use by [GNU](http://www.gnu.org/) projects. - -See it in action on the Hurd Wiki web at vmlinux.org, . - -**_Primary goals include:_** - -Issues the current release, v1.0, will address. - -* Basic skin compatible with most browsers: Mozilla 4.xx-6.xx, Lynx, W3M, Links, (X)Emacs/W3 and maybe even Internet Explorer. -* Looks, "skin deep" design � la [The Hurd](http://hurd.gnu.org) web pages. -* User configurable everything, as far as possible. Therefore the TigerSkin's WebMenu parser is integrated. - -**_Secondary goals:_** - -These design goals will go into the v2.0 series of the Gnuskin. - -* Quicker. -* Lesser files. -* Smaller. -* Extended configurability - Edit **all** of the webmenu, change topmenu, etc. - -## Syntax Rules - -* See the TigerSkin's WebMenu for example. -* More to to come... +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. -## ToDo +**_Installation:_** -* Release v1.0 -* Simplify, simplify, simplify! +See [[GnuSkinInstall]] for details of download and installation instructions. -## History +### %TOPIC% Default Settings -This is the [[TWiki/GnuSkin]] plugin. It's designed to more like a general [GNU](http://www.gnu.org) web page and less like the [[TWiki/TigerSkinPlugin]]. - -Lean & simple and yet still good looking and stylish. The [[GnuSkinPlugin]] is a rip-off from the [[TigerSkinPlugin]] with a lot of the useless stuff removed. It is designed to be simple and functional and yet stylish enough to be used in production like environments. - -The [[GnuSkin]] design is a rip-off [the Hurd website](http://hurd.gnu.org/), with a few bells and whistles from TWiki added. - -See the [[GnuSkinPlugin]] page for more information about the [[GnuSkin]] features. Or take a look at the [[Know/WebHome]] for a hint of how it looks and feels. - -## %TOPIC% Settings - -Plugin settings are stored as preferences variables. To reference a plugin setting write **%<plugin>\_<setting>%**, i.e. **%INTERWIKIPLUGIN\_SHORTDESCRIPTION%** +Plugin settings are stored as preferences variables. To reference a plugin setting write **%<plugin>\_<setting>%**, i.e. **%EMPTYPLUGIN\_SHORTDESCRIPTION%** * One line description, is shown in the %TWIKIWEB%.TextFormattingRules topic: - * Set SHORTDESCRIPTION = A complete bare bones skin theme template plugin for TWiki + * Set SHORTDESCRIPTION = Supplements the bare bones [[GnuSkin]] theme for TWiki * Debug plugin: (See output in `data/debug.txt`) * Set DEBUG = 0 -## Plugin Installation Instructions +An example logo, named `logo.png`, is provided in the [[GnuSkin]] library. To provide your own web-specific logo, attach a file named `logo.png` to any [[WebPreferences]] page, or set the WEBLOGO variable on the same page to use a logo with a different name. -* Download the ZIP file from the Plugin web (see below) -* Unzip **%TOPIC%.zip** in your twiki installation directory. Content: - - - - - - - - - - - - - - - - -
File:Description:
data/TWiki/%TOPIC%.txt Plugin topic
data/TWiki/%TOPIC%.txt,v Plugin topic repository
lib/TWiki/Plugins/%TOPIC%.pm Plugin Perl module
-* Check this topic here if the installation was successful -* Test if the plugin is correctly installed: - * Make sure the SKINHANDLER is set to Gnu and the - * SKIN variable is set to gnu. +> * **Set WEBLOGO = %PUBURL%/%MAINWEB%/LogoTopic/my\_project\_logo.png** + +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. + +* 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. See [[WebMenuFormat]] for details. , supplied one cover TWiki, Main and Test Webs ## Plugin Info @@ -135,5 +66,3 @@ Plugin settings are stored as preferences variables. To reference a plugin setti **_Related Topics:_** %TWIKIWEB%.TWikiPreferences, %TWIKIWEB%.TWikiPlugins - --- [[Main/JoachimNilsson]] - 28 May 2002 -- cgit v1.2.3