diff options
Diffstat (limited to 'data/doc/sisu/html/sisu.8.html')
| -rw-r--r-- | data/doc/sisu/html/sisu.8.html | 229 |
1 files changed, 229 insertions, 0 deletions
diff --git a/data/doc/sisu/html/sisu.8.html b/data/doc/sisu/html/sisu.8.html new file mode 100644 index 00000000..755d1d32 --- /dev/null +++ b/data/doc/sisu/html/sisu.8.html @@ -0,0 +1,229 @@ + <!-- manual page source format generated by PolyglotMan v3.2, --> +<!-- available at http://polyglotman.sourceforge.net/ --> + +<html> +<head> +<title>sisu(8) manual page</title> +</head> +<body bgcolor='white'> +<a href='#toc'>Table of Contents</a><p> + +<h2><a name='sect0' href='#toc0'>Name</a></h2> +<b>SiSU</b> - Structured information, Serialized Units - a document +publishing system +<h2><a name='sect1' href='#toc1'>Synopsis</a></h2> +<b>sisu</b> <b>[-mhwpxXv...] [</b> <i>filename/wildcard</i> <b>]</b> +<h2><a name='sect2' href='#toc2'>Description</a></h2> +A +document publishing system, that from a simple single marked-up document, +produces a multitude of output formats including: html, latex, pdf, info, +and sql output, which can be cross referenced as having the same document +structure and text object numbering, "object citation numbering". Features +include its’ simple syntax; the semantic identification of documents using +the Dublin Core; document management; built to be associated with a revision +control system; text object numbering for the identification of a texts +location in any of the output formats, easy skinning on a site wide, or +per document basis, ... for more see <i>man</i> 1 sisu or <i><<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> +></i> +<p> +<b>SiSU is an alternative way of publishing and managing documents.</b> +<h2><a name='sect3' href='#toc3'>Installation</a></h2> +<p> +Up +to date information on SiSU downloads, and their installation should be +available from: <i><<a href='http://www.jus.uio.no/sisu/SiSU/download.html'>http://www.jus.uio.no/sisu/SiSU/download.html</a> +></i> or at: <i><<a href='http://www.jus.uio.no/sisu/sisu_download/download.html'>http://www.jus.uio.no/sisu/sisu_download/download.html</a> +></i> +<p> +There you should find links to the latest source tarball, and instructions +on how to install SiSU. <p> +Sample marked up documents are are available at +<i>/usr/share/doc/sisu/sisu_markup_samples/dfsg</i> or equivalent directory, or +online at <i><<a href='http://www.jus.uio.no/sisu/sample/markup.html'>http://www.jus.uio.no/sisu/sample/markup.html</a> +></i> or for viewing in html +with syntax highlighting from <i><<a href='http://www.jus.uio.no/sisu/sample/syntax'>http://www.jus.uio.no/sisu/sample/syntax</a> +></i> <p> +A syntax +table is provided at <i>/usr/share/doc/sisu/on_markup.txt</i> or equivalent, and +online at <i><<a href='http://www.jus.uio.no/sisu/sample/on_markup.txt'>http://www.jus.uio.no/sisu/sample/on_markup.txt</a> +></i> <p> +<i>man</i> 1 sisu has a +syntax table along with processing commands. <p> +SiSU also provides some help +via the command: <i>sisu</i> --help and selecting an appropriate subject, e.g. <p> +<i>sisu</i> +--help commands <p> +<i>sisu</i> --help markup <p> +<i>sisu</i> --help headers <p> +<i>sisu</i> --help env <p> +The rest +of this note is on post installation setup +<h2><a name='sect4' href='#toc4'>Post Installation Setup - Quick +start</a></h2> +<p> +After installation of sisu-complete, move to the document samples directory +<p> + cd /usr/share/doc/sisu/sisu_markup_samples/dfsg<br> + <p> +and run <p> + sisu -1 free_as_in_freedom.rms_and_free_software.sam_williams.sst<br> + <p> +or the same: <p> + sisu -NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst<br> + <p> +look at output results, see the "sisu_manifest" page created for the document +<p> +To generate an online document move to a writable directory, (create a +work directory and cd into it) as the file will be downloaded there and +e.g. <p> +<i>sisu</i> -1 <a href='http://www.jus.uio.no/sisu/gpl2.fsf/gpl2.fsf.sst'>http://www.jus.uio.no/sisu/gpl2.fsf/gpl2.fsf.sst</a> + <p> +<i>sisu</i> -3 <a href='http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst'>http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst</a> + +<p> +examine source document, vim has syntax highlighting support <p> +gvim free_as_in_freedom.rms_and_free_software.sam_williams.sst +<p> +additional markup samples in <i><<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a> +></i> <p> +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. +<p> +<i>sisu</i> -3 <a href='http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip'>http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip</a> + <p> +there +is a security issue associated with the running of document skins that +are not your own, so these are turned of by default, and the use of the +following command, which switches on the associated skin is not recommended: +<p> +<i>sisu</i> -3 --trust <a href='http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip'>http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip</a> + +<p> +For help <i>man</i> sisu <p> +<i>sisu</i> --help <p> +<i>sisu</i> --help env for the way sisu "sees/maps" +your system <p> +<i>sisu</i> --help commands for list of commands and so on <p> + <b>Document +markup directory</b> <p> +Perhaps the easiest way to begin is to create a directory +for sisu marked up documents within your home directory, and copy the file +structure (and document samples) provided in the document sample directory: +<i>mkdir</i> ~/sisu_test <p> +<i>cd</i> ~/sisu_test <p> +<i>cp</i> -a /usr/share/doc/sisu/sisu_markup_samples/dfsg/* +~/sisu_test/. <p> +<b>----------</b> <p> +<b>Tip: </b> the markup syntax examples may be of interest <i><<a href='http://www.jus.uio.no/sisu/sample/'>http://www.jus.uio.no/sisu/sample/</a> +></i> +<p> +<b>Tip:</b> <i>sisu</i> -U [sisu markup filename] should printout the different possible +outputs and where sisu would place them. <p> +<b>Tip: </b> if you want to toggle ansi +color add <i>c</i> to your flags. <p> +<b>----------</b> <p> + <b>SiSU configuration file search path is:</b> <p> +<i>./_sisu/sisurc.yaml</i> +<p> +<i>~/.sisu/sisurc.yaml</i> <p> +<i>/etc/sisu/sisurc.yaml</i> <p> + +<h2><a name='sect5' href='#toc5'>Debian INSTALLATION Note</a></h2> +<p> +It is best +you see <i><<a href='http://www.jus.uio.no/sisu/SiSU/download.html#debian'>http://www.jus.uio.no/sisu/SiSU/download.html#debian</a> +></i> for up the most +up to date information. <p> +notes taken from the Debian control file (end edited), +gives an idea of additional packages that SiSU can make use of if available, +(the use/requirement of some of which are interdependent for specific actions +by SiSU): <p> +Package: sisu <p> +Depends: ruby (>= 1.8.4), libwebrick-ruby <p> +Recommends: +sisu-pdf, sisu-sqlite, sisu-postgresql, librmagick-ruby, trang, tidy, librexml-ruby, +zip, unzip, openssl, rsync, openssh-client lsh-client,<br> + keychain, hyperestraier, kdissert<br> + <p> +Suggests: libfcgi-ruby1.8, rcs cvs, lv, texinfo, pinfo, rename <p> +Package: +sisu-complete <p> +Depends: ruby (>= 1.8.4), sisu, sisu-pdf, sisu-postgresql, sisu-sqlite +<p> +Recommends: hyperestraier <p> +Package: sisu-pdf <p> +Depends: sisu, tetex-bin texlive-base-bin, +tetex-extra texlive-latex-extra, texlive-latex-extra, latex-ucs<br> + <p> +Suggests: evince, xpdf <p> +Package: sisu-postgresql <p> +Depends: sisu, postgresql-8.1, +libdbi-ruby, libdbm-ruby, libdbd-pg-ruby <p> +Suggests: pgaccess, libdbd-pgsql, postgresql-contrib-8.1 +<p> +Package: sisu-sqlite <p> +Depends: sisu, sqlite, libdbi-ruby, libdbm-ruby, libdbd-sqlite-ruby +<p> +Suggests: libdbd-sqlite <p> +Package: sisu-markup-samples <p> +Depends: sisu <p> +</pre> +<h2><a name='sect6' href='#toc6'>Document +Resource Configuration</a></h2> +<b>sisu</b> resource configuration information is obtained +from sources (where they exist): <br> +<pre>~/.sisu/sisurc.yaml/etc/sisu/[sisu version]/sisurc.yamlsisu program defaults</pre><p> + +<b>Skins</b> <p> +default document appearance may be modified using skins contained +in sub-directories located at the following paths: <br> +<pre>./_sisu/skin~/.sisu/skin/etc/sisu/skin</pre><p> +more specifically, the following locations +(or their /etc/sisu equivalent) should be used: <p> +<i>~/.sisu/skin/doc</i> skins for +individual documents; <p> +<i>~/.sisu/skin/dir</i> skins for directories of matching +names; <p> +<i>~/.sisu/skin/site</i> site-wide skin modifying the site-wide appearance +of documents. <p> +Usually all skin files are placed in the document skin directory: +<i>~/.sisu/skin/doc</i> with softlinks being made to the skins contained there +from other skin directories as required. +<h2><a name='sect7' href='#toc7'>Further Information</a></h2> +<p> +For more information +on <i>SiSU</i> see: <i><<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a> +></i> <p> +or <i>man</i> sisu +<h2><a name='sect8' href='#toc8'>Author</a></h2> +Ralph Amissah +<i><ralph@amissah.com></i> or <i><ralph.amissah@gmail.com></i> +<h2><a name='sect9' href='#toc9'>See Also</a></h2> +<a href='http:~/bin/man2html?sisu:1'><b>sisu(1)</a> +,</b> <a href='http:~/bin/man2html?sisu_examples:1'><b>sisu_examples(1)</a> +,</b> +<a href='http:~/bin/man2html?sisu_webrick:1'><b>sisu_webrick(1)</a> +,</b> <a href='http:~/bin/man2html?sisu_pdf:1'><b>sisu_pdf(1)</b></a> + <a href='http:~/bin/man2html?sisu_sqlite:1'><b>sisu_sqlite(1)</b></a> + <a href='http:~/bin/man2html?sisu_postgresql:1'><b>sisu_postgresql(1)</b></a> + <a href='http:~/bin/man2html?sisu_termsheet:1'><b>sisu_termsheet(1)</a> +,</b> +<p> + +<hr><p> +<a name='toc'><b>Table of Contents</b></a><p> +<ul> +<li><a name='toc0' href='#sect0'>Name</a></li> +<li><a name='toc1' href='#sect1'>Synopsis</a></li> +<li><a name='toc2' href='#sect2'>Description</a></li> +<li><a name='toc3' href='#sect3'>Installation</a></li> +<li><a name='toc4' href='#sect4'>Post Installation Setup - Quick start</a></li> +<li><a name='toc5' href='#sect5'>Debian INSTALLATION Note</a></li> +<li><a name='toc6' href='#sect6'>Document Resource Configuration</a></li> +<li><a name='toc7' href='#sect7'>Further Information</a></li> +<li><a name='toc8' href='#sect8'>Author</a></li> +<li><a name='toc9' href='#sect9'>See Also</a></li> +</ul> +</body> +</html> |