Title:
SiSU - Skins [0.58]
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:
Date issued:
Date available:
Date modified:
Date:
2007-09-16
SiSU - Skins [0.58], 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