%META:TOPICINFO{author="guest" date="1046613900" format="1.0" version="1.2"}%
%META:TOPICPARENT{name="GnuSkin"}%
<div align="center"> [ GnuSkin | GnuSkinPlugin | <nop>GnuSkinInstall | %TWIKIWEB%.TWikiPreferences | %TWIKIWEB%.TWikiPlugins ] </div>
---++ <nop>GnuSkin Download & Installation Instructions

__Briefly:__


	* Download ==GnuSkin-1.2.zip== from TWiki:Plugins/GnuSkinInstall
	* Unzip it in your twiki installation directory.<br />Contents:

     | *File:*                                  | *Description:*                 |
     | ==bin/gnusave==                          | The savemulti script           |
     | ==bin/gnusearch==                        | The photonsearch script        |
     | ==data/TWiki/GnuSkin.txt==               | Skin description               |
     | ==data/TWiki/GnuSkinPlugin.txt==         | Plugin description             |
     | ==data/TWiki/GnuSkinInstall.txt==        | Installation notes             |
     | ==lib/TWiki/Plugins/GnuSkinPlugin.pm==   | Plugin Perl module             |
     | ==pub/TWiki/GnuSkin/add-attachment.png== | Attachment icon                |
     | ==pub/TWiki/GnuSkin/arrow-left-24.png==  | Back arrow                     |
     | ==pub/TWiki/GnuSkin/bubble-LL.png==      | Lower left round edege icon    |
     | ==pub/TWiki/GnuSkin/bubble-LR.png==      | Lower right round edege icon   |
     | ==pub/TWiki/GnuSkin/bubble-UL.png==      | Upper left round edege icon    |
     | ==pub/TWiki/GnuSkin/bubble-UR.png==      | Upper right round edege icon   |
     | ==pub/TWiki/GnuSkin/edit.png==           | Edit topic icon                |
     | ==pub/TWiki/GnuSkin/folder.png==         | Folder (more) icon             |
     | ==pub/TWiki/GnuSkin/logo.png==           | Default web logotype icon      |
     | ==pub/TWiki/GnuSkin/page.png==           | View topic icon                |
     | ==pub/TWiki/GnuSkin/print.png==          | View printable icon            |
     | ==pub/TWiki/GnuSkin/rcs_diff.png==       | View diffs icon                |
     | ==pub/TWiki/GnuSkin/search.png==         | Search topics icon             |
     | ==pub/TWiki/GnuSkin/theme.png==          | Select skin/theme icon         |
     | ==pub/TWiki/GnuSkin/twikiblue.css==      | Default blue style             |
     | ==pub/TWiki/GnuSkin/twikigreen.css==     | Green style                    |
     | ==templates/attach.gnu.tmpl==            | Attach file template           |
     | ==templates/changeform.gnu.tmpl==        | Change form template           |
     | ==templates/edit.gnu.tmpl==              | Edit topic template            |
     | ==templates/preview.gnu.tmpl==           | Topic preview template         |
     | ==templates/renamebase.gnu.tmpl==        | Rename/move topic template     |
     | ==templates/rdiff.gnu.tmpl==             | Topic diffs template           |
     | ==templates/search.gnu.tmpl==            | Generic search template        |
     | ==templates/searchbookview.gnu.tmpl==    | Bookview search template       |
     | ==templates/searchformat.gnu.tmpl==      | Search template                |
     | ==templates/searchrenameview.gnu.tmpl==  | Search template                |
     | ==templates/twiki.gnu.tmpl==             | Snippets for generic templates |
     | ==templates/view.gnu.tmpl==              | View topic template            |

	* To verify installation check the %TWIKIWEB%.TWikiPlugins topic, the GnuSkinPlugin should be listed there. See also the %TWIKIWEB%.TWikiSkins topic for help on activating a skin.
	* Briefly, skim through the %TWIKIWEB%.TWikiPreferences or the WebPreferences and:
		* make sure the SKINHANDLER is set to Gnu
		* and the SKIN variable is set to gnu.

__Comprehensively:__

	* Download ==GnuSkin-1.2.zip== from TWiki:Plugins/GnuSkinInstall

	* Unpack the archive inside your TWiki installation directory. (All the GnuSkin files have a Gnu substring embedded to ensure you do not overwrite any of TWiki's original files.)

	* Alternatively, you can check out the latest versions of the GnuSkin and WebMenu from The GNU Savannah CVS repository. http://savannah.gnu.org/projects/twiki-skins/

	* In case you do not have the TWiki:Plugins/TigerSkin installed you also need to download and install the WebMenu package in the same directory. The GnuSkin and the TWiki:Plugins/TigerSkin shares the WebMenu format.

	* Edit the %TWIKIWEB%.WebMenu topic to set the contents of the menu bar. See the %TWIKIWEB%.WebMenuFormat for details.

	* Add the following line to %TWIKIWEB%.TWikiPreferences or to any WebPreferences topic. Remember, six spaces an asterisk and the ==Set== keyword to specify an option.
		* Set SKIN = gnu

	* If using multiple skin handlers then the following line needs to be included in %TWIKIWEB%.TWikiPreferences to set the TWiki wide default or in a specific WebPreferences topic to use the Gnu Skin handler only for that Web.
		* Set SKINHANDLER = Gnu

	* *Note:* If this is the first (and only) skin handler the TWiki skin handler defaults to procssing the SKIN unless SKINHANDLER is set to some value besides Gnu.

	* For more settings see the GnuSkinPlugin topic.


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