SISU - SKINS, RALPH AMISSAH
DOCUMENT SKINS - CONFIGURATION
1. SKINS
Skins modify the default appearance of document output on a document, directory, or site wide basis. Skins are looked for in the following locations:
./_sisu/skin
~/.sisu/skin
/etc/sisu/skin
Within the skin directory are the following the default sub-directories for document skins:
./skin/doc
./skin/dir
./skin/site
A skin is placed in the appropriate directory and the file named skin_[name].rb
The skin itself is a ruby file which modifies the default appearances set in the program.
1.1 DOCUMENT SKIN
Documents take on a document skin, if the header of the document specifies a skin to be used.
@skin: skin_united_nations
1.2 DIRECTORY SKIN
A directory may be mapped on to a particular skin, so all documents within that directory take on a particular appearance. If a skin exists in the skin/dir with the same name as the document directory, it will automatically be used for each of the documents in that directory, (except where a document specifies the use of another skin, in the skin/doc directory).
A personal habit is to place all skins within the doc directory, and symbolic links as needed from the site, or dir directories as required.
1.3 SITE SKIN
A site skin, modifies the program default skin.
1.4 SAMPLE
SKINS
With SiSU installed sample skins may be found in:
/etc/sisu/skin/doc
and
/usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc
(or equivalent directory) and if sisu-markup-samples is installed also under:
/usr/share/doc/sisu/sisu_markup_samples/non-free/_sisu/skin/doc
Samples of list.yml and promo.yml (which are used to create the right column list) may be found in:
/usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml
(or equivalent
directory)
DOCUMENT INFORMATION (METADATA)
METADATA
Document Manifest @ <http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/sisu_manifest.html >
Dublin Core (DC)
DC tags included with this document are provided here.
DC Title: SiSU - Skins
DC Creator: Ralph Amissah
DC Rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
DC Type: information
DC Date created: 2002-11-12
DC Date issued: 2002-11-12
DC Date available: 2002-11-12
DC Date modified: 2007-09-16
DC Date: 2007-09-16
Version Information
Sourcefile: sisu_skin.sst
Filetype: SiSU text
insert 0.58
Sourcefile Digest, MD5(sisu_skin.sst)= 8aebfb5312045c3a705ad6c314246f67
Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
20fc43cf3eb6590bc3399a1aef65c5a9
Generated
Document (metaverse) last generated: Mon Sep 24 15:36:15 +0100 2007
Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]