SiSU

Skins

Ralph Amissah

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

  @skin: skin_united_nations

  16

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

Document Information (metadata)

  0

<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/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)= 20fc43cf3eb6590bc3399a1aef65c5a9

Generated

Document (metaverse) last generated: Tue Sep 25 02:53:33 +0100 2007

Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)

Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]

Output generated by SiSU 0.59.1 2007-09-25 (2007w39/2)
SiSU Copyright ^© Ralph Amissah 1997, current 2007. All Rights Reserved.
SiSU is software for document structuring, publishing and search,
www.jus.uio.no/sisu and www.sisudoc.org
w3 since October 3 1993 ralph@amissah.com

SiSU using:
Standard SiSU markup syntax,
Standard SiSU meta-markup syntax, and the
Standard SiSU object citation numbering and system, (object/text positioning system)
Copyright ^© Ralph Amissah 1997, current 2007. All Rights Reserved.

SiSU is released under GPLv3 or later, <http://www.gnu.org/licenses/gpl.html>

SiSU, developed using Ruby on Debian/Gnu/Linux software infrastructure, with the usual GPL (or OSS) suspects.
Better - "performance, reliability, scalability, security & total cost of ownership" [not to mention flexibility & choice] use of and adherence to open standards (where practical and fair) and it is software libre.
Get With the Future Way Better!