SiSU - Manual,
Ralph Amissah

  1

What is SiSU?

  2

HowTo

  1463

41. Change Appearance

41. Change Appearance

  1683

41.1 Skins

  1684

"Skins" may be used to change various aspects related to the output documents appearance, including such things as the url for the home page on which the material will be published, information on the credit band, and for html documents colours and icons used in navigation bars. Skins are ruby files which permit changing of the default values set within the program for SiSU output.

  1685

There are a few examples provided, on untarring the source tarball:

  1686

conf/sisu/skin/doc/

  1687

data/sisu-examples/sample/document_samples_sisu_markup/_sisu/skin/doc

  1688

and on installation under:

  1689

/etc/sisu/skin/doc/

  1690

/usr/share/sisu-examples/sample/document_samples_sisu_markup/_sisu/skin/doc

  1691

The following paths are searched:

  1692

./_sisu/skin

  1693

~/.sisu/skin

  1694

/etc/sisu/skin

  1695

Skins under the searched paths in a per document directory, a per directory directory, or a site directory, named:

  1696

doc [may be specified individually in each document]

  1697

dir [used if identifier part of name matches markup directory name]

  1698

site

  1699

It is usual to place all skins in the document directory, with symbolic links as required from dir or site directories.

  1700

41.2 CSS

  1701

The appearance of html and XML related output can be changed for an ouput collection directory by prepareing and placing a new css file in one of the sisu css directories searched in the sisu configuration path. These are located at:

  1702

_./_sisu/css

  1703

~/.sisu/css

  1704

and

  1705

/etc/sisu/css

  1706

The contents of the first directory found in the search path are copied to the corresponding sisu output directory with the commnd:

  1707

sisu -CC

  1708

The SiSU standard css files for SiSU output are:

  1709

dom.css html.css html_tables.css index.css sax.css xhtml.css

  1710

A document may specify its own/bespoke css file using the css header.

  1711

\@css:

  1712

[expand]

  1713

Output generated by SiSU 0.59.0 2007-09-23 (2007w38/0)
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!