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