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
SiSU - Skins,
Ralph Amissah 1 Document Skins - configuration 2 1. Skins 3 Skins modify the default appearance of document output on a document, directory, or site wide basis. Skins are looked for in the following locations: 4 ./_sisu/skin 5 ~/.sisu/skin 6 /etc/sisu/skin 7 Within the skin directory are the following the default sub-directories for document skins: 8 ./skin/doc 9 ./skin/dir 10 ./skin/site 11 A skin is placed in the appropriate directory and the file named skin_[name].rb 12 The skin itself is a ruby file which modifies the default appearances set in the program. 13 1.1 Document Skin 14 Documents take on a document skin, if the header of the document specifies a skin to be used. 15 16      @skin: skin_united_nations     1.2 Directory Skin 17 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). 18 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. 19 1.3 Site Skin 20 A site skin, modifies the program default skin. 21 1.4 Sample Skins 22 With SiSU installed sample skins may be found in: 23 /etc/sisu/skin/doc and /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc 24 (or equivalent directory) and if sisu-markup-samples is installed also under: 25 /usr/share/doc/sisu/sisu_markup_samples/non-free/_sisu/skin/doc 26 Samples of list.yml and promo.yml (which are used to create the right column list) may be found in: 27 /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml (or equivalent directory) 28