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 @ *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:32:38 +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]_ ============================================================================== title: SiSU - Skins creator: Ralph Amissah rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 type: information subject: ebook, epublishing, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search date.created: 2002-11-12 date.issued: 2002-11-12 date.available: 2002-11-12 date.modified: 2007-09-16 date: 2007-09-16 ============================================================================== nil Other versions of this document: manifest: http://www.jus.uio.no/sisu/sisu_skin/sisu_manifest.html html: http://www.jus.uio.no/sisu/sisu_skin/toc.html pdf: http://www.jus.uio.no/sisu/sisu_skin/portrait.pdf http://www.jus.uio.no/sisu/sisu_skin/landscape.pdf plaintext (plain text): http://www.jus.uio.no/sisu/sisu_skin/plain.txt at: http://www.jus.uio.no/sisu * 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] * Last Generated on: Mon Sep 24 15:32:40 +0100 2007 * SiSU http://www.jus.uio.no/sisu