<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<?xml-stylesheet type="text/css" href="../_sisu/css/sax.css"?>
<!-- Document processing information:
* 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: Sun Sep 23 04:12:02 +0100 2007
* SiSU http://www.jus.uio.no/sisu
-->
<document>
<head>
<meta>Title:</meta>
<title class="dc">
SiSU - Skins [0.58]
</title>
<br />
<meta>Creator:</meta>
<creator class="dc">
Ralph Amissah
</creator>
<br />
<meta>Rights:</meta>
<rights class="dc">
Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
</rights>
<br />
<meta>Type:</meta>
<type class="dc">
information
</type>
<br />
<meta>Subject:</meta>
<subject class="dc">
ebook, epublishing, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search
</subject>
<br />
<meta>Date created:</meta>
<date_created class="extra">
2002-11-12
</date_created>
<br />
<meta>Date issued:</meta>
<date_issued class="extra">
2002-11-12
</date_issued>
<br />
<meta>Date available:</meta>
<date_available class="extra">
2002-11-12
</date_available>
<br />
<meta>Date modified:</meta>
<date_modified class="extra">
2007-09-16
</date_modified>
<br />
<meta>Date:</meta>
<date class="dc">
2007-09-16
</date>
<br />
</head>
<body>
<object id="1">
<ocn>1</ocn>
<text class="h1">
SiSU - Skins [0.58],<br /> Ralph Amissah
</text>
</object>
<object id="2">
<ocn>2</ocn>
<text class="h2">
Document Skins - configuration
</text>
</object>
<object id="3">
<ocn>3</ocn>
<text class="h4">
1. Skins
</text>
</object>
<object id="4">
<ocn>4</ocn>
<text class="norm">
Skins modify the default appearance of document output on a document,
directory, or site wide basis. Skins are looked for in the following
locations:
</text>
</object>
<object id="5">
<ocn>5</ocn>
<text class="indent1">
./_sisu/skin
</text>
</object>
<object id="6">
<ocn>6</ocn>
<text class="indent1">
~/.sisu/skin
</text>
</object>
<object id="7">
<ocn>7</ocn>
<text class="indent1">
/etc/sisu/skin
</text>
</object>
<object id="8">
<ocn>8</ocn>
<text class="norm">
<b>Within the skin directory</b> are the following the default
sub-directories for document skins:
</text>
</object>
<object id="9">
<ocn>9</ocn>
<text class="indent1">
./skin/doc
</text>
</object>
<object id="10">
<ocn>10</ocn>
<text class="indent1">
./skin/dir
</text>
</object>
<object id="11">
<ocn>11</ocn>
<text class="indent1">
./skin/site
</text>
</object>
<object id="12">
<ocn>12</ocn>
<text class="norm">
A skin is placed in the appropriate directory and the file named
skin_[name].rb
</text>
</object>
<object id="13">
<ocn>13</ocn>
<text class="norm">
The skin itself is a ruby file which modifies the default appearances
set in the program.
</text>
</object>
<object id="14">
<ocn>14</ocn>
<text class="h5">
1.1 Document Skin
</text>
</object>
<object id="15">
<ocn>15</ocn>
<text class="norm">
Documents take on a document skin, if the header of the document
specifies a skin to be used.
</text>
</object>
<object id="16">
<ocn>16</ocn>
<text class="code">
   @skin: skin_united_nations    
</text>
</object>
<object id="17">
<ocn>17</ocn>
<text class="h5">
1.2 Directory Skin
</text>
</object>
<object id="18">
<ocn>18</ocn>
<text class="norm">
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).
</text>
</object>
<object id="19">
<ocn>19</ocn>
<text class="norm">
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.
</text>
</object>
<object id="20">
<ocn>20</ocn>
<text class="h5">
1.3 Site Skin
</text>
</object>
<object id="21">
<ocn>21</ocn>
<text class="norm">
A site skin, modifies the program default skin.
</text>
</object>
<object id="22">
<ocn>22</ocn>
<text class="h5">
1.4 Sample Skins
</text>
</object>
<object id="23">
<ocn>23</ocn>
<text class="norm">
With <b>SiSU</b> installed sample skins may be found in:
</text>
</object>
<object id="24">
<ocn>24</ocn>
<text class="indent1">
/etc/sisu/skin/doc and
/usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc
</text>
</object>
<object id="25">
<ocn>25</ocn>
<text class="norm">
(or equivalent directory) and if sisu-markup-samples is installed also
under:
</text>
</object>
<object id="26">
<ocn>26</ocn>
<text class="indent1">
/usr/share/doc/sisu/sisu_markup_samples/non-free/_sisu/skin/doc
</text>
</object>
<object id="27">
<ocn>27</ocn>
<text class="norm">
Samples of list.yml and promo.yml (which are used to create the right
column list) may be found in:
</text>
</object>
<object id="28">
<ocn>28</ocn>
<text class="indent1">
/usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml (or
equivalent directory)
</text>
</object>
</body>
</document>