|
|
|
SiSU
Manual
Ralph Amissah
copy @ SiSU
SiSU - Manual,
|
1 |
What is SiSU? |
2 |
Extracts from man 8 sisu |
1925 |
43. Post Installation Setup |
43. Post Installation Setup |
1926 |
1927 |
After installation of sisu-complete, move to the document samples directory, |
1928 |
1929 |
[this is not where you would normally work but provides sample documents for testing, you may prefer instead to copy the contents of that directory to a local directory before proceeding] |
1930 |
and in that directory, initialise the output directory with the command |
1931 |
1932 |
1933 |
sisu -1 free_as_in_freedom.rms_and_free_software.sam_williams.sst |
1934 |
1935 |
sisu -NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst |
1936 |
look at output results, see the "sisu_manifest" page created for the document |
1937 |
1938 |
1939 |
1940 |
1941 |
To generate a document from a remote url accessible location move to a writable directory, (create a work directory and cd into it) as the file will be downloaded there and e.g. |
1942 |
1943 |
sisu -3 <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst> |
1944 |
examine source document, vim has syntax highlighting support |
1945 |
gvim free_as_in_freedom.rms_and_free_software.sam_williams.sst |
1946 |
1947 |
1948 |
it should also be possible to run sisu against sisupods (prepared zip files, created by running the command sisu -S [filename]), whether stored locally or remotely. |
1949 |
sisu -3 <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip> |
1950 |
sisu -3 --trust <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip> |
1952 |
1953 |
1954 |
1955 |
1956 |
1957 |
1958 |
1960 |
1961 |
cp -a /usr/share/doc/sisu/sisu_markup_samples/dfsg/* ~/sisu_test/. |
1962 |
1963 |
1964 |
1965 |
1966 |
should printout the different possible outputs and where sisu would place them. |
1967 |
1968 |
1969 |
1970 |
1971 |
1972 |
1973 |
1974 |
1975 |
1976 |
1977 |
1978 |
1979 |
1980 |
1982 |
SiSU is a lightweight markup based, command line oriented, document structuring, publishing and search framework for document collections. |
1983 |
SiSU also provides concordance files, document content certificates and manifests of generated output. |
1985 |
1987 |
Dependencies for various features are taken care of in sisu related packages. The package sisu-complete installs the whole of SiSU. |
1988 |
Homepage: <http://www.jus.uio.no/sisu> |
1990 |
1991 |
sisu resource configuration information is obtained from sources (where they exist): |
1992 |
1993 |
1994 |
1995 |
1996 |
Skins default document appearance may be modified using skins contained in sub-directories located at the following paths: |
1997 |
1998 |
1999 |
2000 |
more specifically, the following locations (or their /etc/sisu equivalent) should be used: |
2001 |
2002 |
2003 |
2004 |
2005 |
2006 |
site-wide skin modifying the site-wide appearance of documents. |
2007 |
Usually all skin files are placed in the document skin directory: |
2008 |
2009 |
with softlinks being made to the skins contained there from other skin directories as required. |
2010 |
|
|
|
Output generated by
SiSU
0.59.0 2007-09-23 (2007w38/0)
|
SiSU using:
| |
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.
|