Skins modify the default appearance of document output on a document, directory, or site wide basis. Skins are looked for in the following locations:
Within the skin directory are the following the default sub-directories for document skins:
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.
Documents take on a document skin, if the header of the document specifies a skin to be used.
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.
A site skin, modifies the program default skin.
With SiSU installed sample skins may be found in:
/etc/sisu/skin/doc and /usr/share/doc/sisu/markup-samples/samples/_sisu/skin/doc
(or equivalent directory) and if sisu-markup-samples is installed also under:
Samples of list.yml and promo.yml (which are used to create the right column list) may be found in:
/usr/share/doc/sisu/markup-samples-non-free/samples/_sisu/skin/yml (or equivalent directory)