aboutsummaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorRalph Amissah <ralph@amissah.com>2007-09-28 22:41:06 +0100
committerRalph Amissah <ralph@amissah.com>2007-09-28 22:41:06 +0100
commit145f6b74dcb24a795ed85c6094d36be91ea3c585 (patch)
tree3377094a31cabe02efb4cecc25241182ebd45aa4
parentdebian manpage things reverted to use old manpages (diff)
parentremoval of auto-generated manpages (diff)
Merge branch 'upstream' into debian/sid
-rw-r--r--CHANGELOG14
-rw-r--r--data/doc/sisu/html/sisu_commands.1.html553
-rw-r--r--data/doc/sisu/html/sisu_configuration.1.html254
-rw-r--r--data/doc/sisu/html/sisu_doc.7.html121
-rw-r--r--data/doc/sisu/html/sisu_faq.8.html273
-rw-r--r--data/doc/sisu/html/sisu_help.1.html213
-rw-r--r--data/doc/sisu/html/sisu_help_sources.1.html582
-rw-r--r--data/doc/sisu/html/sisu_howto.8.html1447
-rw-r--r--data/doc/sisu/html/sisu_markup.1.html1113
-rw-r--r--data/doc/sisu/html/sisu_quickstart.8.html332
-rw-r--r--data/doc/sisu/html/sisu_remote.8.html189
-rw-r--r--data/doc/sisu/html/sisu_search.8.html512
-rw-r--r--data/doc/sisu/html/sisu_skin.1.html162
-rw-r--r--data/doc/sisu/html/sisu_syntax_highlighting.8.html219
-rw-r--r--data/doc/sisu/sisu_markup_samples/sisu_manual/Rantfile3
-rw-r--r--data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm6
-rw-r--r--lib/sisu/v0/hub.rb2
-rw-r--r--lib/sisu/v0/manpage.rb3
-rw-r--r--lib/sisu/v0/param.rb29
-rw-r--r--man/man1/sisu_commands.1575
-rw-r--r--man/man1/sisu_configuration.1368
-rw-r--r--man/man1/sisu_help.1318
-rw-r--r--man/man1/sisu_help_sources.1729
-rw-r--r--man/man1/sisu_markup.11532
-rw-r--r--man/man1/sisu_skin.1222
-rw-r--r--man/man7/sisu_complete.7181
-rw-r--r--man/man7/sisu_doc.7160
-rw-r--r--man/man7/sisu_pdf.7212
-rw-r--r--man/man7/sisu_postgresql.7223
-rw-r--r--man/man7/sisu_sqlite.7222
-rw-r--r--man/man8/sisu_faq.8402
-rw-r--r--man/man8/sisu_howto.82301
-rw-r--r--man/man8/sisu_quickstart.8513
-rw-r--r--man/man8/sisu_remote.8251
-rw-r--r--man/man8/sisu_search.8639
-rw-r--r--man/man8/sisu_syntax_highlighting.8307
36 files changed, 48 insertions, 15134 deletions
diff --git a/CHANGELOG b/CHANGELOG
index 9dc35163..ed8f23d7 100644
--- a/CHANGELOG
+++ b/CHANGELOG
@@ -29,6 +29,9 @@ http://www.jus.uio.no/sisu/pkg/src/sisu_0.60.0.orig.tar.gz
* sysenv, sisurc.yml allow use of relative output paths, expand to absolute
+ * param, behavior changed to take in multi-lines, affects regex matching,
+ watch
+
* html segmented, bugfix: footnotes for headings levels :A,:B and :C
correctly placed in first segment when batch-processing files/output
@@ -37,6 +40,17 @@ http://www.jus.uio.no/sisu/pkg/src/sisu_0.60.0.orig.tar.gz
* sysenv, syslink issue, additional check
+ * sisu markup, header @man: accepting manpage parameters for: man_section,
+ man_name and man_synopsis
+
+ * REVERT to manually constructed man-pages, sisu auto-generated man-pages
+ pretty good, but not ready without discussion for automatic inclusion in
+ package, sisu -i [filename]
+
+ * NOTE you may be better off doing any diffs between 0.60 and 0.58 branch
+ than against 0.59 which includes a lot of generated within the package
+ documentation, 0.60 adds source only
+
%% sisu_0.59.1.orig.tar.gz (2007-09-25:39/2)
http://www.jus.uio.no/sisu/pkg/src/sisu_0.59.1.orig.tar.gz
cf512ec871aeb7cdabc0b3b35b7e6d05 10952059 sisu_0.59.1.orig.tar.gz
diff --git a/data/doc/sisu/html/sisu_commands.1.html b/data/doc/sisu/html/sisu_commands.1.html
deleted file mode 100644
index e519713e..00000000
--- a/data/doc/sisu/html/sisu_commands.1.html
+++ /dev/null
@@ -1,553 +0,0 @@
-<!-- manual page source format generated by PolyglotMan v3.2, -->
-<!-- available at http://polyglotman.sourceforge.net/ -->
-
-<html>
-<head>
-<title>"sisu_commands"("1") manual page</title>
-</head>
-<body bgcolor='white'>
-<a href='#toc'>Table of Contents</a><p>
-SISU - COMMANDS, RALPH AMISSAH
-<p> SISU COMMANDS
-<p> 1. COMMANDS SUMMARY
-<p> 1.1
-
-<p>SYNOPSIS
-<p> <b>SiSU</b> - Structured information, Serialized Units - a document publishing
-
-<p>system
-<p> sisu &nbsp;[ &nbsp;-abcDdFHhIiMmNnopqRrSsTtUuVvwXxYyZz0-9 &nbsp;] &nbsp;[ &nbsp;filename/
-<p> sisu
-&nbsp;[ &nbsp;-Ddcv &nbsp;] &nbsp;[ &nbsp;instruction &nbsp;]
-<p> sisu &nbsp;[ &nbsp;-CcFLSVvW &nbsp;]
-<p> Note: commands should be
-issued from within the directory that contains the marked up files, cd
-to markup directory.
-<p> 1.2 DESCRIPTION
-<p> <b>SiSU</b> <b>SiSU</b> is a document publishing
-system, that from a simple single marked-up document, produces multiple
-of output formats including: plaintext, html, LaTeX, pdf, xhtml, XML, info,
-and SQL (PostgreSQL and SQLite), which share numbered text objects ( structure
-information. For more see: &lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-&gt;
-<p> 1.3 DOCUMENT PROCESSING
-
-<p>COMMAND FLAGS
-<p>
-<dl>
-
-<dt><b>&nbsp;-a &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>produces plaintext with Unix linefeeds
-and without markup, (object numbers are omitted), has footnotes at end
-of each paragraph that contains them &nbsp;[ -A &nbsp;for &nbsp;equivalent &nbsp;dos &nbsp;(linefeed)
-&nbsp;output &nbsp;file] &nbsp;[see &nbsp;-e &nbsp;for endnotes]. (Options include: --endnotes for endnotes
---footnotes for footnotes at the end of each paragraph --unix for unix linefeed
-(default) --msdos for msdos linefeed)
-<p> </dd>
-
-<dt><b>&nbsp;-b &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>produces xhtml/XML
-output for browser viewing (sax parsing).
-<p> </dd>
-
-<dt><b>&nbsp;-C &nbsp;&nbsp;[--init-site]</b> </dt>
-<dd>configure/initialise
-shared output directory files initialize shared output directory (config
-files such as css and dtd files are not updated if they already exist unless
-modifier is used). -C --init-site configure/initialise site more extensive than
--C on its own, shared output directory files/force update, existing shared
-output config files such as css and dtd files are updated if this modifier
-is used.
-<p> </dd>
-
-<dt><b>&nbsp;-CC</b> </dt>
-<dd>&nbsp;configure/initialise &nbsp;shared &nbsp;output &nbsp;directory &nbsp;files &nbsp;initialize
-shared &nbsp;output &nbsp;directory &nbsp;(config &nbsp;files &nbsp;such &nbsp;as &nbsp;css &nbsp;and &nbsp;dtd is &nbsp;used). &nbsp;The
-&nbsp;equivalent &nbsp;of: &nbsp;-C &nbsp;--init-site configure/initialise &nbsp;site, &nbsp;more &nbsp;extensive &nbsp;than
-&nbsp;-C &nbsp;on &nbsp;its &nbsp;own, &nbsp;shared &nbsp;output &nbsp;directory &nbsp;files/force &nbsp;update, &nbsp;existing &nbsp;shared
-output &nbsp;config &nbsp;files &nbsp;such &nbsp;as &nbsp;css &nbsp;and &nbsp;dtd &nbsp;files &nbsp;are &nbsp;updated if &nbsp;-CC &nbsp;is &nbsp;used.
-such &nbsp;as &nbsp;css &nbsp;and &nbsp;dtd &nbsp;files &nbsp;are &nbsp;updated
-<p> </dd>
-
-<dt><b>&nbsp;-c &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>screen toggle
-ansi screen colour on or off depending on default set (unless -c flag is
-used: if sisurc colour default is set to &rsquo;true&rsquo;, output to screen will be
-with colour, if sisurc colour default is set to &rsquo;false&rsquo; or is undefined screen
-output will be without colour).
-<p> </dd>
-
-<dt><b>&nbsp;-D &nbsp;&nbsp;[instruction] &nbsp;[filename]</b> </dt>
-<dd>database postgresql
-( --pgsql may be used instead) possible instructions, include: --createdb;
---create; --dropall; --import &nbsp;[filename]; --update &nbsp;[filename]; --remove &nbsp;[filename];
-see database section below.
-<p> </dd>
-
-<dt><b>&nbsp;-d &nbsp;&nbsp;[--db-[database &nbsp;type &nbsp;(sqlite|pg)]] --[instruction]
-</dt>
-<dd>[filename] database type default set to sqlite, (for which --sqlite may be
-used instead) or to specify another database --db-[pgsql, &nbsp;sqlite] (however
-see -D) possible instructions include: --createdb; --create; --dropall; --import
-&nbsp;[filename]; --update &nbsp;[filename]; --remove &nbsp;[filename]; see database section
-below.
-<p> </dd>
-
-<dt><b>&nbsp;-F &nbsp;&nbsp;[--webserv=webrick]</b> </dt>
-<dd>generate examples of (naive) cgi search form
-for sqlite and pgsql depends on your already having used sisu to populate
-an sqlite and/or pgsql database, (the sqlite version scans the output directories
-for existing sisu_sqlite databases, so it is first necessary to create
-them, before generating the search form) see -d -D and the database section
-below. If the optional parameter --webserv=webrick is passed, the cgi examples
-created will be set up to use the default port set for use by the webrick
-server, (otherwise the port is left blank and the system setting used,
-usually 80). The samples are dumped in the present work directory which
-must be writable, (with screen instructions given that they be copied to
-the cgi-bin directory). -Fv (in addition to the above) provides some information
-
-<p>on setting up hyperestraier for sisu
-<p> </dd>
-
-<dt><b>&nbsp;-H &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>produces html
-without link suffixes (.html .pdf etc.) ( an appropriately configured web
-server. &nbsp;[behaviour &nbsp;switched &nbsp;after &nbsp;0.35 &nbsp;see &nbsp;-h].
-<p> </dd>
-
-<dt><b>&nbsp;-h &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>produces
-html (with hardlinks i.e. with name suffixes in links/local urls). html, with
-internal document links that include the document suffix, i.e. whether it
-is .html or .pdf (required for browsing directly off a file system, and works
-with most web servers). &nbsp;[behaviour &nbsp;switched &nbsp;after
-<p> </dd>
-
-<dt><b>&nbsp;-I &nbsp;&nbsp;[filename/wildcard]</b>
-</dt>
-<dd>produces texinfo and info file, (view with pinfo).
-<p> </dd>
-
-<dt><b>&nbsp;-L</b> </dt>
-<dd>&nbsp;prints &nbsp;license &nbsp;information.
-
-<p> </dd>
-
-<dt><b>&nbsp;-M &nbsp;&nbsp;[filename/wildcard/url]</b> </dt>
-<dd>maintenance mode files created for processing
-preserved and their locations indicated. (also see -V)
-<p> </dd>
-
-<dt><b>&nbsp;-m &nbsp;&nbsp;[filename/wildcard/url]</b>
-</dt>
-<dd>assumed for most other flags, creates new meta-markup file, (the metaverse
-) that is used in all subsequent processing of other output. This step is
-assumed for most processing flags. To skip it see -n
-<p> </dd>
-
-<dt><b>&nbsp;-N &nbsp;&nbsp;[filename/wildcard/url]</b>
-</dt>
-<dd>document digest or document content certificate ( DCC ) as md5 digest tree
-of the document: the digest for the document, and digests for each object
-contained within the document (together with information on software versions
-that produced it) (digest.txt). -NV for verbose digest output to screen.
-<p> </dd>
-
-<dt><b>&nbsp;-n
-&nbsp;&nbsp;[filename/wildcard/url]</b> </dt>
-<dd>skip meta-markup (building of -m which is otherwise
-assumed by most processing flags.
-<p> </dd>
-
-<dt><b>&nbsp;-o &nbsp;&nbsp;[filename/wildcard/url]</b> </dt>
-<dd>output basic
-document in opendocument file format (opendocument.odt).
-<p> </dd>
-
-<dt><b>&nbsp;-p &nbsp;&nbsp;[filename/wildcard]</b>
-</dt>
-<dd>produces LaTeX pdf (portrait.pdf &amp; landscape.pdf). Default paper size is set
-in config file, or document header, or provided with additional command
-line parameter, e.g. --papersize-a4 preset sizes include: &rsquo;A4&rsquo;, U.S. &rsquo;letter&rsquo; and
-&rsquo;legal&rsquo; and book sizes &rsquo;A5&rsquo; and &rsquo;B5&rsquo; (system defaults to A4).
-<p> </dd>
-
-<dt><b>&nbsp;-q &nbsp;&nbsp;[filename/wildcard]</b>
-</dt>
-<dd>quiet less output to screen.
-<p> </dd>
-
-<dt><b>&nbsp;-R &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>copies sisu output files
-to remote host using rsync. This requires that sisurc.yml has been provided
-with information on hostname and username, and that you have your different
-if -R is used with other flags from if used alone. Alone the rsync --delete
-parameter is sent, useful for cleaning the remote directory (when -R is
-used together with other flags, it is not). Also see -r
-<p> </dd>
-
-<dt><b>&nbsp;-r &nbsp;&nbsp;[filename/wildcard]</b>
-</dt>
-<dd>copies sisu output files to remote host using scp. This requires that sisurc.yml
-has been provided with information on hostname and username, and that you
-
-<p>have your
-<p> </dd>
-
-<dt><b>&nbsp;-S</b> </dt>
-<dd>&nbsp;produces &nbsp;a &nbsp;sisupod &nbsp;a &nbsp;zipped &nbsp;sisu &nbsp;directory &nbsp;of &nbsp;markup local
-&nbsp;configuration &nbsp;file, &nbsp;images &nbsp;and &nbsp;skins. &nbsp;Note: &nbsp;this &nbsp;only includes &nbsp;the &nbsp;configuration
-&nbsp;files &nbsp;or &nbsp;skins &nbsp;contained &nbsp;in &nbsp;./_sisu &nbsp;not &nbsp;those &nbsp;in &nbsp;~/.sisu &nbsp;-S &nbsp;&nbsp;[filename/wildcard]
-option. Note: (this option is tested only with zsh).
-<p> </dd>
-
-<dt><b>&nbsp;-S &nbsp;&nbsp;[filename/wildcard]</b>
-</dt>
-<dd>produces a zipped file of the prepared document specified along with associated
-images, by default named sisupod.zip they may alternatively be named with
-the filename extension .ssp This provides a quick way of gathering the relevant
-parts of a sisu document which can then for example be emailed. A sisupod
-includes sisu markup source file, (along with associated documents if a
-master file, or available in multilingual versions), together with related
-images and skin. <b>SiSU</b> commands can be run directly against a sisupod contained
-in a local directory, or provided as a url on a remote site. As there is
-a security issue with skins provided by other users, they are not applied
-unless the flag --trust or --trusted is added to the command instruction, it
-is recommended that file that are not your own are treated as untrusted.
-The directory structure of the unzipped file is understood by sisu, and
-sisu commands can be run within it. Note: if you wish to send multiple files,
-it quickly becomes more space efficient to zip the sisu markup directory,
-rather than the individual files for sending). See the -S option without
-
-<p> </dd>
-
-<dt><b>&nbsp;-s &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>copies sisu markup file to output directory.
-<p> </dd>
-
-<dt><b>&nbsp;-t &nbsp;&nbsp;[filename/wildcard
-&nbsp;(*.termsheet.rb)]</b> </dt>
-<dd>standard form document builder, preprocessing feature
-<p>
-</dd>
-
-<dt><b>&nbsp;-U &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>prints url output list/map for the available processing
-flags options and resulting files that could be requested, (can be used
-to get a list of processing options in relation to a file, together with
-information on the output that would be produced), -u provides url output
-mapping for those flags requested for processing. The default assumes sisu_webrick
-is running and provides webrick url mappings where appropriate, but these
-
-<p>can be switched to file system paths in sisurc.yml
-<p> </dd>
-
-<dt><b>&nbsp;-u &nbsp;&nbsp;[filename/wildcard]</b>
-</dt>
-<dd>provides url mapping of output files for the flags requested for processing,
-
-<p>also see -U
-<p> </dd>
-
-<dt><b>&nbsp;-V</b> </dt>
-<dd>&nbsp;on &nbsp;its &nbsp;own, &nbsp;provides <b>&nbsp;SiSU</b> &nbsp;version &nbsp;and &nbsp;environment &nbsp;information
-&nbsp;(sisu &nbsp;--help &nbsp;env)
-<p> </dd>
-
-<dt><b>&nbsp;-V &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>even more verbose than the -v flag.
-(also see -M)
-<p> </dd>
-
-<dt><b>&nbsp;-v</b> </dt>
-<dd>&nbsp;on &nbsp;its &nbsp;own, &nbsp;provides <b>&nbsp;SiSU</b> &nbsp;version &nbsp;information
-<p> </dd>
-
-<dt><b>&nbsp;-v &nbsp;&nbsp;[filename/wildcard]</b>
-</dt>
-<dd>provides verbose output of what is being built, where it is being built
-(and error messages if any), as with -u flag provides a url mapping of files
-created for each of the processing flag requests. See also -V
-<p> </dd>
-
-<dt><b>&nbsp;-W</b> </dt>
-<dd>&nbsp;starts &nbsp;ruby&rsquo;s
-&nbsp;webrick &nbsp;webserver &nbsp;points &nbsp;at &nbsp;sisu &nbsp;output &nbsp;the &nbsp;default &nbsp;port &nbsp;is &nbsp;set &nbsp;to &nbsp;8081
-&nbsp;and &nbsp;can &nbsp;be &nbsp;&nbsp;[tip: &nbsp;the &nbsp;so &nbsp;html &nbsp;output &nbsp;should be &nbsp;created &nbsp;using &nbsp;the &nbsp;-h &nbsp;option
-&nbsp;rather &nbsp;than &nbsp;-H; &nbsp;also, &nbsp;note &nbsp;-F &nbsp;webrick &nbsp;].
-<p> </dd>
-
-<dt><b>&nbsp;-w &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>produces concordance
-(wordmap) a rudimentary index of all the words in a document. (Concordance
-files are not generated for documents of over 260,000 words unless this
-limit is increased in the file sisurc.yml)
-<p> </dd>
-
-<dt><b>&nbsp;-X &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>produces
-XML output with deep document structure, in the nature of dom.
-<p> </dd>
-
-<dt><b>&nbsp;-x &nbsp;&nbsp;[filename/wildcard]</b>
-</dt>
-<dd>produces XML output shallow structure (sax parsing).
-<p> </dd>
-
-<dt><b>&nbsp;-Y &nbsp;&nbsp;[filename/wildcard]</b>
-</dt>
-<dd>produces a short sitemap entry for the document, based on html output and
-the sisu_manifest. --sitemaps generates/updates the sitemap index of existing
-sitemaps. (Experimental, &nbsp;[g,y,m &nbsp;announcement &nbsp;this &nbsp;week])
-<p> </dd>
-
-<dt><b>&nbsp;-y &nbsp;&nbsp;[filename/wildcard]</b>
-</dt>
-<dd>produces an html summary of output generated (hyperlinked to content) and
-document specific metadata (sisu_manifest.html). This step is assumed for
-most processing flags.
-<p> </dd>
-
-<dt><b>&nbsp;-Z &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>Zap, if used with other processing
-flags deletes output files of the type about to be processed, prior to
-processing. If -Z is used as the lone processing related flag (or in conjunction
-with a combination of -[mMvVq]), will remove the related document output
-directory.
-<p> </dd>
-
-<dt><b>&nbsp;-z &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>produces php (zend) &nbsp;[this &nbsp;feature &nbsp;is &nbsp;disabled
-&nbsp;for &nbsp;the &nbsp;time being]
-<p> </dd>
-</dl>
-2. COMMAND LINE MODIFIERS
-<p>
-<dl>
-
-<dt><b>&nbsp;--no-ocn</b> </dt>
-<dd>&nbsp;&nbsp;[with &nbsp;-h &nbsp;-H &nbsp;or &nbsp;-p] switches
-off object citation numbering. Produce output without identifying numbers
-in margins of html or LaTeX/pdf output.
-<p> </dd>
-
-<dt><b>&nbsp;--no-annotate</b> </dt>
-<dd>&nbsp;strips &nbsp;output &nbsp;text &nbsp;of
-&nbsp;editor &nbsp;endnotes[^*1] denoted by asterisk or dagger/plus sign
-<p> </dd>
-
-<dt><b>&nbsp;--no-asterisk</b>
-</dt>
-<dd>&nbsp;strips &nbsp;output &nbsp;text &nbsp;of &nbsp;editor &nbsp;endnotes[^*2] denoted by asterisk sign
-<p> </dd>
-
-<dt><b>&nbsp;--no-dagger</b>
-</dt>
-<dd>&nbsp;strips &nbsp;output &nbsp;text &nbsp;of &nbsp;editor &nbsp;endnotes[^+1] denoted by dagger/plus sign
-<p>
-</dd>
-</dl>
-3. DATABASE COMMANDS
-<p> dbi - database interface
-<p> -D or --pgsql set for postgresql
--d or --sqlite default set for sqlite -d is modifiable with --db=[database &nbsp;type
-&nbsp;(pgsql &nbsp;or &nbsp;sqlite)]
-<p>
-<dl>
-
-<dt><b>&nbsp;-Dv &nbsp;--createall</b> </dt>
-<dd>&nbsp;initial &nbsp;step, &nbsp;creates &nbsp;required &nbsp;relations
-&nbsp;(tables, &nbsp;indexes) &nbsp;in &nbsp;existing &nbsp;postgresql &nbsp;database &nbsp;(a &nbsp;database &nbsp;should &nbsp;be
-&nbsp;created manually &nbsp;and &nbsp;given &nbsp;the &nbsp;same &nbsp;name &nbsp;as &nbsp;working &nbsp;directory, &nbsp;as requested)
-&nbsp;(rb.dbi) &nbsp;&nbsp;[ &nbsp;-dv &nbsp;--createall &nbsp;sqlite &nbsp;equivalent] it may be necessary to run sisu
--Dv --createdb initially NOTE: at the present time for postgresql it may be
-necessary to manually create the database. The command would be &rsquo;createdb
-&nbsp;[database &nbsp;name]&rsquo; where database name would be SiSU_[present &nbsp;working &nbsp;directory
-&nbsp;name &nbsp;(without &nbsp;path)]. Please use only alphanumerics and underscores.
-<p> </dd>
-
-<dt><b>&nbsp;-Dv
-&nbsp;--import</b> </dt>
-<dd>&nbsp;&nbsp;[filename/wildcard] imports data specified to postgresql db (rb.dbi)
-&nbsp;[ &nbsp;-dv &nbsp;--import &nbsp;sqlite &nbsp;equivalent]
-<p> </dd>
-
-<dt><b>&nbsp;-Dv &nbsp;--update</b> </dt>
-<dd>&nbsp;&nbsp;[filename/wildcard] updates/imports
-specified data to postgresql db (rb.dbi) &nbsp;[ &nbsp;-dv &nbsp;--update &nbsp;sqlite &nbsp;equivalent]
-
-<p> </dd>
-
-<dt><b>&nbsp;-D &nbsp;--remove</b> </dt>
-<dd>&nbsp;&nbsp;[filename/wildcard] removes specified data to postgresql db (rb.dbi)
-&nbsp;[ &nbsp;-d &nbsp;--remove &nbsp;sqlite &nbsp;equivalent]
-<p> </dd>
-
-<dt><b>&nbsp;-D &nbsp;--dropall</b> </dt>
-<dd>&nbsp;kills &nbsp;data &amp; &nbsp;indexes &nbsp;&nbsp;[ &nbsp;-d &nbsp;--dropall
-&nbsp;sqlite &nbsp;equivalent]
-<p> The v in e.g. -Dv is for verbose output.
-<p> </dd>
-</dl>
-4. SHORTCUTS,
-SHORTHAND FOR MULTIPLE FLAGS
-<p>
-<dl>
-
-<dt><b>&nbsp;--update &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>Checks existing
-file output and runs the flags required to update this output. This means
-that if only html and pdf output was requested on previous runs, only the
--hp files will be applied, and only these will be generated this time, together
-with the summary. This can be very convenient, if you offer different outputs
-of different files, and just want to do the same again.
-<p> </dd>
-
-<dt><b>&nbsp;-0 &nbsp;to &nbsp;-5 &nbsp;&nbsp;[filename
-&nbsp;or &nbsp;wildcard]</b> </dt>
-<dd>Default shorthand mappings (note that the defaults can be
-changed/configured in the sisurc.yml file):
-<p> </dd>
-
-<dt><b>&nbsp;-0</b> </dt>
-<dd>&nbsp;-mNhwpAobxXyYv &nbsp;&nbsp;[this &nbsp;is &nbsp;the
-&nbsp;default &nbsp;action &nbsp;run &nbsp;when &nbsp;no &nbsp;i.e. &nbsp;on &nbsp;&rsquo;sisu &nbsp;&nbsp;[filename]&rsquo;]
-<p> </dd>
-
-<dt><b>&nbsp;-1</b> </dt>
-<dd>&nbsp;-mNHwpy &nbsp;give, &nbsp;i.e. &nbsp;on
-&nbsp;&rsquo;sisu &nbsp;&nbsp;[filename]&rsquo;]
-<p> </dd>
-
-<dt><b>&nbsp;-2</b> </dt>
-<dd>&nbsp;-mNHwpaoy give, &nbsp;i.e. &nbsp;on &nbsp;&rsquo;sisu &nbsp;&nbsp;[filename]&rsquo;]
-<p> </dd>
-
-<dt><b>&nbsp;-3</b> </dt>
-<dd>&nbsp;-mNhwpAobxXyY
-&nbsp;i.e. &nbsp;on &nbsp;&rsquo;sisu &nbsp;&nbsp;[filename]&rsquo;]
-<p> </dd>
-
-<dt><b>&nbsp;-4</b> </dt>
-<dd>&nbsp;-mNhwpAobxXDyY &nbsp;--import &nbsp;&rsquo;sisu &nbsp;&nbsp;[filename]&rsquo;]
-<p> </dd>
-
-<dt><b>&nbsp;-5</b> </dt>
-<dd>&nbsp;-mNhwpAobxXDyY
-&nbsp;--update &nbsp;&rsquo;sisu &nbsp;&nbsp;[filename]&rsquo;]
-<p> add -v for verbose mode and -c for color, e.g. sisu
--2vc &nbsp;[filename &nbsp;or wildcard]
-<p> consider -u for appended url info or -v for
-
-<p>verbose output
-<p> </dd>
-</dl>
-4.0.1 COMMAND LINE WITH FLAGS - BATCH PROCESSING
-<p> In the
-data directory run sisu -mh filename or wildcard eg. cisg.sst documents.
-<p>
-Running sisu (alone without any flags, filenames or wildcards) brings up
-the interactive help, as does any sisu command that is not recognised. Enter
-to escape.
-<p> DOCUMENT INFORMATION (METADATA)
-<p> METADATA
-<p> Document Manifest
-@ &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/sisu_manifest.html</a>
-&gt;
-<p>
- <b>Dublin Core</b> (DC)
-<p> <i>DC</i> tags included with this document are provided here.
-
-<p> DC Title: <i>SiSU</i> - Commands
-<p> DC Creator: <i>Ralph</i> Amissah
-<p> DC Rights: <i>Copyright</i>
-(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
-<p> DC
-Type: <i>information</i>
-<p> DC Date created: <i>2002-08-28</i>
-<p> DC Date issued: <i>2002-08-28</i>
-
-<p> DC Date available: <i>2002-08-28</i>
-<p> DC Date modified: <i>2007-09-16</i>
-<p> DC Date: <i>2007-09-16</i>
-
-<p> <b>Version Information</b>
-<p> Sourcefile: <i>sisu_commands.sst</i>
-<p> Filetype: <i>SiSU</i> text
-
-<p>0.58
-<p> Sourcefile Digest, MD5(sisu_commands.sst)= <i>68a4087f984baffbea779da25e1b6141</i>
-
-<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-
-<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i>
-<p> <b>Generated</b>
-<p> Document (metaverse) last
-generated: <i>Mon</i> Sep 24 15:36:13 +0100 2007
-<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of
-2007w38/0 (2007-09-23)
-<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36)
-&nbsp;[i486-linux]
-<p>
-<dl>
-
-<dt><b>*1.</b> </dt>
-<dd>square brackets </dd>
-
-<dt><b>*2.</b> </dt>
-<dd>square brackets </dd>
-
-<dt><b>+1.</b> </dt>
-<dd>square brackets
-<p>
-</dd>
-
-<dt>Other versions of this document: </dt>
-<dd></dd>
-
-<dt>manifest: &lt;<a href='http://www.jus.uio.no/sisu/sisu_commands/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_commands/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_commands/sisu_manifest.html</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>html: &lt;<a href='http://www.jus.uio.no/sisu/sisu_commands/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_commands/toc.html'>http://www.jus.uio.no/sisu/sisu_commands/toc.html</a>
-</a>
-&gt; </dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_commands/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_commands/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_commands/portrait.pdf</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_commands/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_commands/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_commands/landscape.pdf</a>
-</a>
-&gt; </dt>
-<dd> </dd>
-
-<dt>at: &lt;<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt>
-<dd></dd>
-
-<dt>* Ruby version: ruby
-1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt>
-<dd></dd>
-
-<dt>* Last Generated on: Mon Sep 24
-15:36:30 +0100 2007 </dt>
-<dd></dd>
-
-<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
- </dt>
-<dd></dd>
-</dl>
-<p>
-</body>
-</html>
diff --git a/data/doc/sisu/html/sisu_configuration.1.html b/data/doc/sisu/html/sisu_configuration.1.html
deleted file mode 100644
index e3be86fe..00000000
--- a/data/doc/sisu/html/sisu_configuration.1.html
+++ /dev/null
@@ -1,254 +0,0 @@
-<!-- manual page source format generated by PolyglotMan v3.2, -->
-<!-- available at http://polyglotman.sourceforge.net/ -->
-
-<html>
-<head>
-<title>"sisu_configuration"("1") manual page</title>
-</head>
-<body bgcolor='white'>
-<a href='#toc'>Table of Contents</a><p>
-SISU - CONFIGURATION, RALPH AMISSAH
-<p> CONFIGURATION OF ENVIRONMENT
-<p> 1. CONFIGURATION
-
-<p> 1.1 DETERMINING THE CURRENT CONFIGURATION
-<p> Information on the current
-configuration of <b>SiSU</b> should be available with the help command:
-<p> sisu
--v<br>
-
-<p> which is an alias for:
-<p> sisu --help env<br>
-
-<p> Either of these should be executed from within a directory that contains
-sisu markup source documents.
-<p> 1.2 CONFIGURATION FILES (CONFIG.YML)
-<p> <b>SiSU</b>
-configration parameters are adjusted in the configuration file, which can
-be used to override the defaults set. This includes such things as which
-directory interim processing should be done in and where the generated
-output should be placed.
-<p> The <b>SiSU</b> configuration file is a yaml file, which
-means indentation is significant.
-<p> <b>SiSU</b> resource configuration is determined
-by looking at the following files if they exist:
-<p> ./_sisu/sisurc.yml<br>
-
-<p> ~/.sisu/sisurc.yml<br>
-
-<p> /etc/sisu/sisurc.yml<br>
-
-<p> The search is in the order listed, and the first one found is used.
-<p>
- In the absence of instructions in any of these it falls back to the internal
-program defaults.
-<p> Configuration determines the output and processing directories
-and the database access details.
-<p> If <b>SiSU</b> is installed a sample sisurc.yml
-
-<p>may be found in /etc/sisu/sisurc.yml
-<p> CONFIGURATION OF DOCUMENTS
-<p> 2. SKINS
-
-<p> Skins modify the default appearance of document output on a document,
-directory, or site wide basis. Skins are looked for in the following locations:
-
-<p> ./_sisu/skin<br>
-
-<p> ~/.sisu/skin<br>
-
-<p> /etc/sisu/skin<br>
-
-<p> <b>Within the skin directory</b> are the following the default sub-directories
-for document skins:
-<p> ./skin/doc<br>
-
-<p> ./skin/dir<br>
-
-<p> ./skin/site<br>
-
-<p> A skin is placed in the appropriate directory and the file named skin_[name].rb
-
-<p> The skin itself is a ruby file which modifies the default appearances
-set in the program.
-<p> 2.1 DOCUMENT SKIN
-<p> Documents take on a document skin,
-if the header of the document specifies a skin to be used.
-<p>
-<p> <br>
-<pre> @skin: skin_united_nations
-</pre>
-<p> 2.2 DIRECTORY SKIN
-<p> 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).
-<p> 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.
-
-<p> 2.3 SITE SKIN
-<p> A site skin, modifies the program default skin.
-<p> 2.4 SAMPLE
-
-<p>SKINS
-<p> With <b>SiSU</b> installed sample skins may be found in:
-<p> /etc/sisu/skin/doc
-and<br>
- /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc<br>
-
-<p> (or equivalent directory) and if sisu-markup-samples is installed also
-under:
-<p> /usr/share/doc/sisu/sisu_markup_samples/non-free/_sisu/skin/doc<br>
-
-<p> Samples of list.yml and promo.yml (which are used to create the right
-column list) may be found in:
-<p> /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml
-(or equivalent<br>
- directory)<br>
-
-<p> 3. HOMEPAGES
-<p> <b>SiSU</b> is about the ability to auto-generate documents. Home
-pages are regarded as custom built items, and are not created by <b>SiSU</b>
-<b>SiSU</b> has a default home page, which will not be appropriate for use with
-other sites, and the means to provide your own home page instead in one
-of two ways as part of a site&rsquo;s configuration, these being:
-<p> 1. through
-placing your home page and other custom built documents in the subdirectory
-_sisu/home/ (this probably being the easier and more convenient option)
-
-<p> 2. through providing what you want as the home page in a skin,
-<p> Document
-sets are contained in directories, usually organised by site or subject.
-Each directory can/should have its own homepage. See the section on directory
-structure and organisation of content.
-<p> 3.1 HOME PAGE AND OTHER CUSTOM BUILT
-
-<p>PAGES IN A SUB-DIRECTORY
-<p> Custom built pages, including the home page index.html
-may be placed within the configuration directory _sisu/home/ in any of
-the locations that is searched for the configuration directory, namely
-./_sisu; ~/_sisu; /etc/sisu From there they are copied to the root of the
-output directory with the command:
-<p> sisu -CC<br>
-
-<p> 3.2 HOME PAGE WITHIN A SKIN
-<p> Skins are described in a separate section,
-but basically are a file written in the programming language <b>Ruby</b> that
-may be provided to change the defaults that are provided with sisu with
-respect to individual documents, a directories contents or for a site.
-<p>
- If you wish to provide a homepage within a skin the skin should be in
-the directory _sisu/skin/dir and have the name of the directory for which
-it is to become the home page. Documents in the directory commercial_law
-would have the homepage modified in skin_commercial law.rb; or the directory
-
-<p>poems in skin_poems.rb
-<p>
-<p> <br>
-<pre> class Home
- def homepage
- # place the html content of your homepage here, this will become
-index.html
- &lt;&lt;HOME &lt;html&gt;
- &lt;head&gt;&lt;/head&gt;
- &lt;doc&gt;
- &lt;p&gt;this is my new homepage.&lt;/p&gt;
- &lt;/doc&gt;
- &lt;/html&gt;
- HOME
- end
- end
-</pre>
-<p> DOCUMENT INFORMATION (METADATA)
-<p> METADATA
-<p> Document Manifest @ &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/sisu_manifest.html</a>
-&gt;
-
-<p> <b>Dublin Core</b> (DC)
-<p> <i>DC</i> tags included with this document are provided here.
-
-<p> DC Title: <i>SiSU</i> - Configuration
-<p> DC Creator: <i>Ralph</i> Amissah
-<p> DC Rights:
-
-<p><i>Ralph</i> Amissah
-<p> DC Type: <i>information</i>
-<p> DC Date created: <i>2002-08-28</i>
-<p> DC Date
-issued: <i>2002-08-28</i>
-<p> DC Date available: <i>2007-08-28</i>
-<p> DC Date modified: <i>2007-08-30</i>
-
-<p> DC Date: <i>2007-08-30</i>
-<p> <b>Version Information</b>
-<p> Sourcefile: <i>sisu_configuration._sst</i>
-
-<p> Filetype: <i>SiSU</i> text insert 0.58
-<p> Sourcefile Digest, MD5(sisu_configuration._sst)=
-
-<p><i>491d3da039162d60ae0e2951aa260915</i>
-<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-
-<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i>
-<p> <b>Generated</b>
-<p> Document (metaverse) last
-generated: <i>Mon</i> Sep 24 15:36:17 +0100 2007
-<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of
-2007w38/0 (2007-09-23)
-<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36)
-&nbsp;[i486-linux]
-<p>
-<p>
-<dl>
-
-<dt>Other versions of this document: </dt>
-<dd></dd>
-
-<dt>manifest: &lt;<a href='http://www.jus.uio.no/sisu/sisu_configuration/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_configuration/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_configuration/sisu_manifest.html</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>html: &lt;<a href='http://www.jus.uio.no/sisu/sisu_configuration/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_configuration/toc.html'>http://www.jus.uio.no/sisu/sisu_configuration/toc.html</a>
-</a>
-&gt; </dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_configuration/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_configuration/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_configuration/portrait.pdf</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_configuration/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_configuration/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_configuration/landscape.pdf</a>
-</a>
-&gt; </dt>
-<dd> </dd>
-
-<dt>at: &lt;<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt>
-<dd></dd>
-
-<dt>* Ruby version: ruby
-1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt>
-<dd></dd>
-
-<dt>* Last Generated on: Mon Sep 24
-15:36:32 +0100 2007 </dt>
-<dd></dd>
-
-<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
- </dt>
-<dd></dd>
-</dl>
-<p>
-</body>
-</html>
diff --git a/data/doc/sisu/html/sisu_doc.7.html b/data/doc/sisu/html/sisu_doc.7.html
deleted file mode 100644
index 2496c3b6..00000000
--- a/data/doc/sisu/html/sisu_doc.7.html
+++ /dev/null
@@ -1,121 +0,0 @@
-<!-- manual page source format generated by PolyglotMan v3.2, -->
-<!-- available at http://polyglotman.sourceforge.net/ -->
-
-<html>
-<head>
-<title>"sisu_doc"("1") manual page</title>
-</head>
-<body bgcolor='white'>
-<a href='#toc'>Table of Contents</a><p>
-SISU - SISU-DOC, RALPH AMISSAH
-<p> SISU DOC
-<p> SISU-DOC
-<p> 1.1 NAME
-<p> <b>SiSU</b> - Structured
-information, Serialized Units - a document publishing system.
-<p> Information
-
-<p>related to sisu documentation
-<p> 1.2 DESCRIPTION
-<p> sisu documentation is installed
-
-<p>in /usr/share/doc/sisu/sisu_manual or equivalent directory
-<p> file:///usr/share/doc/sisu/sisu_manual
-
-<p> file:///usr/share/doc/sisu/sisu_manual/sisu_manual/
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual'>http://www.jus.uio.no/sisu/sisu_manual</a>
-&gt;
-
-<p> &lt;<a href='http://www.sisudoc.org/sisu_manual'>http://www.sisudoc.org/sisu_manual</a>
-&gt;
-<p> DOCUMENT INFORMATION (METADATA)
-<p> METADATA
-
-<p> Document Manifest @ &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_doc/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_doc/sisu_manifest.html</a>
-&gt;
-
-<p> <b>Dublin Core</b> (DC)
-<p> <i>DC</i> tags included with this document are provided here.
-
-<p> DC Title: <i>SiSU</i> - sisu-doc
-<p> DC Creator: <i>Ralph</i> Amissah
-<p> DC Rights: <i>Copyright</i>
-(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
-<p> DC
-Type: <i>information</i>
-<p> DC Date created: <i>2007-09-24</i>
-<p> DC Date issued: <i>2007-09-24</i>
-
-<p> DC Date available: <i>2007-09-24</i>
-<p> DC Date modified: <i>2007-09-24</i>
-<p> DC Date: <i>2007-09-24</i>
-
-<p> <b>Version Information</b>
-<p> Sourcefile: <i>sisu_doc.sst</i>
-<p> Filetype: <i>SiSU</i> text 0.58
-
-<p> Sourcefile Digest, MD5(sisu_doc.sst)= <i>00116fb664a23c87ce52dbe0d4c5a702</i>
-
-<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-
-<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i>
-<p> <b>Generated</b>
-<p> Document (metaverse) last
-generated: <i>Mon</i> Sep 24 15:36:19 +0100 2007
-<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of
-2007w38/0 (2007-09-23)
-<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36)
-&nbsp;[i486-linux]
-<p>
-<p>
-<dl>
-
-<dt>Other versions of this document: </dt>
-<dd></dd>
-
-<dt>manifest: &lt;<a href='http://www.jus.uio.no/sisu/sisu_doc/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_doc/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_doc/sisu_manifest.html</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>html: &lt;<a href='http://www.jus.uio.no/sisu/sisu_doc/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_doc/toc.html'>http://www.jus.uio.no/sisu/sisu_doc/toc.html</a>
-</a>
-&gt; </dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_doc/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_doc/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_doc/portrait.pdf</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_doc/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_doc/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_doc/landscape.pdf</a>
-</a>
-&gt; </dt>
-<dd> </dd>
-
-<dt>at: &lt;<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt>
-<dd></dd>
-
-<dt>* Ruby version: ruby
-1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt>
-<dd></dd>
-
-<dt>* Last Generated on: Mon Sep 24
-15:36:32 +0100 2007 </dt>
-<dd></dd>
-
-<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
- </dt>
-<dd></dd>
-</dl>
-<p>
-</body>
-</html>
diff --git a/data/doc/sisu/html/sisu_faq.8.html b/data/doc/sisu/html/sisu_faq.8.html
deleted file mode 100644
index 18284509..00000000
--- a/data/doc/sisu/html/sisu_faq.8.html
+++ /dev/null
@@ -1,273 +0,0 @@
-<!-- manual page source format generated by PolyglotMan v3.2, -->
-<!-- available at http://polyglotman.sourceforge.net/ -->
-
-<html>
-<head>
-<title>"sisu_faq"("1") manual page</title>
-</head>
-<body bgcolor='white'>
-<a href='#toc'>Table of Contents</a><p>
-SISU - FAQ - FREQUENTLY ASKED/ANSWERED QUESTIONS, RALPH AMISSAH
-<p> 1. FAQ -
-FREQUENTLY ASKED/ANSWERED QUESTIONS
-<p> 1.1 WHY ARE URLS PRODUCED WITH THE
--V (AND -U) FLAG THAT POINT TO A WEB SERVER ON PORT 8081?
-<p> Try the following
-rune:
-<p> * sisu -W
-<p> This should start the ruby webserver. It should be done
-after having produced some output as it scans the output directory for
-what to serve.
-<p> 1.2 I CANNOT FIND MY OUTPUT, WHERE IS IT?
-<p> The following
-should provide help on output paths:
-<p> * sisu --help env
-<p> * sisu -V &nbsp;[same
-&nbsp;as &nbsp;the &nbsp;previous &nbsp;command]
-<p> * sisu --help directory
-<p> * sisu --help path
-<p> *
-sisu -U &nbsp;[filename]
-<p> * man sisu
-<p> 1.3 I DO NOT GET ANY PDF OUTPUT, WHY?
-<p>
-<b>SiSU</b> produces LaTeX and pdflatex is run against that to generate pdf files.
-
-<p> If you use <b>Debian</b> the following will install the required dependencies
-
-<p> * aptitude install sisu-pdf
-<p> the following packages are required: tetex-bin,
-tetex-extra, latex-ucs
-<p> 1.4 WHERE IS THE LATEX (OR SOME OTHER INTERIM) OUTPUT?
-
-<p> Try adding -M (for maintenance) to your command flags, e.g.:
-<p> * sisu -HpMv
-&nbsp;[filename]
-<p> this should result in the interim processing output being
-retained, and information being provided on where to find it.
-<p> * sisu --help
-
-<p>directory
-<p> * sisu --help path
-<p> should also provide some relevant information
-as to where it is placed.
-<p> 1.5 WHY ISN&rsquo;T SISU MARKUP XML
-<p> I worked with text
-and (though I find XML immensely valuable) disliked noise ... better to sidestep
-the question and say:
-<p> <b>SiSU</b> currently accurately, converts from three
-forms of XML to native <b>SiSU</b> markup for processing. The three types correspond
-to SAX (structure described), DOM (structure embedded, whole document must
-be read before structure is correctly discernable) and node based (a tree)
-forms of XML document structure representation. Problem is I use them very
-seldom and check that all is as it should be with them seldom, so I would
-not be surprised if something breaks there, but as far as I know they are
-working. I will check and add an XML markup help page before the next release.
-
-<p>There already is a bit of information in the man page under the title <b>SiSU</b>
-
-<p>VERSION CONVERSION
-<p> sisu --to-sax &nbsp;[filename/wildcard]<br>
-
-<p> sisu --to-dom &nbsp;[filename/wildcard]<br>
-
-<p> sisu --to-node &nbsp;[filename/wildcard]<br>
-
-<p> The XML should be well formed... must check, but lacks sensible headers.
-Suggestions welcome as to what to make of them. &nbsp;[For &nbsp;the &nbsp;present &nbsp;time I
-&nbsp;am &nbsp;satisfied &nbsp;that &nbsp;I &nbsp;can &nbsp;convert &nbsp;(both &nbsp;ways) &nbsp;between &nbsp;3 forms &nbsp;of &nbsp;XML &nbsp;representation
-&nbsp;and <b>&nbsp;SiSU</b> &nbsp;markup].
-<p> sisu --from-xml2sst &nbsp;[filename/wildcard]<br>
-
-<p> 1.6 LATEX CLAIMS TO BE A DOCUMENT PREPARATION SYSTEM FOR HIGH-QUALITY TYPESETTING.
-CAN THE SAME BE SAID ABOUT SISU?
-<p> <b>SiSU</b> is not really about type-setting.
-
-<p> LaTeX is the ultimate computer instruction type-setting language for paper
-based publication.
-<p> LaTeX is able to control just about everything that
-happens on page and pixel, position letters kerning, space variation between
-characters, words, paragraphs etc. formula.
-<p> <b>SiSU</b> is not really about type-setting
-at all. It is about a lightweight markup instruction that provides enough
-information for an abstraction of the documents structure and objects,
-from which different forms of representation of the document can be generated.
-
-<p> <b>SiSU</b> with very little markup instruction is able to produce relatively
-high quality pdf by virtue of being able to generate usable default LaTeX;
-it produces populates an SQL database in a useful way with the document
-in object sized chunks and its meta-data. But <b>SiSU</b> works on an abstraction
-of the document&rsquo;s structure and content and custom builds suitable uniform
-output. The html for browser viewing and pdf for paper viewing/publishing
-are rather different things with different needs for layout - as indeed
-is what is needed to store information in a database in searchable objects.
-
-<p> The pdfs or html produced for example by open office based on open document
-format and other office/word processor suits usually attempt to have similar
-looking outputs - your document rendered in html looks much the same, or
-in pdf... sisu is less this way, it seeks to have a starting point with as
-little information about appearance as possible, and to come up with the
-best possible appearance for each output that can be derived based on this
-minimal information.
-<p> Where there are large document sets, it provides
-consistency in appearance in each output format for the documents.
-<p> The
-excuse for going this way is, it is a waste of time to think much about
-appearance when working on substantive content, it is the substantive content
-that is relevant, not the way it looks beyond the basic informational tags
-- and yet you want to be able to take advantage of as many useful different
-ways of representing documents as are available, and for various types
-of output to to be/look as good as it can for each medium/format in which
-it is presented, (with different mediums having different focuses) and
-<b>SiSU</b> tries to achieve this from minimal markup.
-<p> 1.7 HOW DO I CREATE GIN
-
-<p>OR GIST INDEX IN POSTGRESQL FOR USE IN SISU
-<p> This at present needs to
-be done alter the sample search form. The following is a helpful response
-from one of the contributors of GiN to Postgresql Oleg Bartunov 2006-12-06:
-
-<p> I have tsearch2 slides which introduces tsearch2 &lt;<a href='http://www.sai.msu.su/~megera/wiki/tsearch2slides'>http://www.sai.msu.su/~megera/wiki/tsearch2slides</a>
-&gt;
-
-<p> FTS in PostgreSQL is provided by tsearch2, which should works without
-any indices (GiST or GIN) ! Indices provide performance, not functionality.
-
-<p> In your example I&rsquo;d do ( simple way, just for demo):
-<p> <b>0.</b> compile, install
-
-<p>tsearch2 and load tsearch2 into your database
-<p> cd contrib/tsearch2;
-make&amp;&amp;make&amp;&amp;install&amp;&amp;make installcheck; psql DB &amp;lt;<br>
- tsearch2.sql<br>
-
-<p> <b>1.</b> Add column fts, which holds tsvector
-<p> alter table documents add
-column fts tsvector;<br>
-
-<p> <b>2.</b> Fill fts column
-<p> update document set fts = to_tsvector(clean);<br>
-
-<p> <b>3.</b> create index - just for performance !
-<p> create index fts_gin_idx
-on document using gin(fts);<br>
-
-<p> <b>4.</b> Run vacuum
-<p> vacuum analyze document;<br>
-
-<p> That&rsquo;s all.
-<p> Now you can search:
-<p> select lid, metadata_tid, rank_cd(fts,
-q,2)as rank from document, plainto_tsquery(&rsquo;markup syntax&rsquo;) q where q @@
-fts order by rank desc limit 10;
-<p> 1.8 WHERE IS VERSION 1.0?
-<p> <b>SiSU</b> works
-pretty well as it is supposed to. Version 1.0 will have the current markup,
-and directory structure. At this point it is largely a matter of choice
-as to when the name change is made.
-<p> The feature set for html,[^1] LaTeX/pdf
-and opendocument is in place. XML, and plaintext are in order.
-<p> html and
-
-<p>LaTeX/pdf may be regarded as reference copy outputs
-<p> With regard to the
-populating of sql databases (postgresql and sqlite), there is a bit to
-be done.
-<p> We are still almost there.
-<p> DOCUMENT INFORMATION (METADATA)
-<p>
-METADATA
-<p> Document Manifest @ &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/sisu_manifest.html</a>
-&gt;
-
-<p> <b>Dublin Core</b> (DC)
-<p> <i>DC</i> tags included with this document are provided here.
-
-<p> DC Title: <i>SiSU</i> - FAQ - Frequently Asked/Answered Questions
-<p> DC Creator:
-
-<p><i>Ralph</i> Amissah
-<p> DC Rights: <i>Copyright</i> (C) Ralph Amissah 2007, part of SiSU
-documentation, License GPL 3
-<p> DC Type: <i>information</i>
-<p> DC Date created:
-
-<p><i>2006-09-06</i>
-<p> DC Date available: <i>2006-09-06</i>
-<p> DC Date issued: <i>2006-09-06</i>
-<p> DC
-Date modified: <i>2007-09-16</i>
-<p> DC Date: <i>2007-09-16</i>
-<p> <b>Version Information</b>
-<p> Sourcefile:
-
-<p><i>sisu_faq.sst</i>
-<p> Filetype: <i>SiSU</i> text 0.57
-<p> Sourcefile Digest, MD5(sisu_faq.sst)=
-
-<p><i>41577c9fc063cd232914a1a11a59e91a</i>
-<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-
-<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i>
-<p> <b>Generated</b>
-<p> Document (metaverse) last
-generated: <i>Mon</i> Sep 24 15:36:17 +0100 2007
-<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of
-2007w38/0 (2007-09-23)
-<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36)
-&nbsp;[i486-linux]
-<p>
-<ol>
-<b>.</b><li>html w3c compliance has been largely met.
-<p> </dd>
-
-<dt>Other versions of
-this document: </dt>
-<dd></dd>
-
-<dt>manifest: &lt;<a href='http://www.jus.uio.no/sisu/sisu_faq/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_faq/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_faq/sisu_manifest.html</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>html: &lt;<a href='http://www.jus.uio.no/sisu/sisu_faq/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_faq/toc.html'>http://www.jus.uio.no/sisu/sisu_faq/toc.html</a>
-</a>
-&gt; </dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_faq/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_faq/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_faq/portrait.pdf</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_faq/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_faq/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_faq/landscape.pdf</a>
-</a>
-&gt; </dt>
-<dd> </dd>
-
-<dt>at: &lt;<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt>
-<dd></dd>
-
-<dt>* Ruby version: ruby
-1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt>
-<dd></dd>
-
-<dt>* Last Generated on: Mon Sep 24
-15:36:32 +0100 2007 </dt>
-<dd></dd>
-
-<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
- </dt>
-<dd></dd>
-</dl>
-<p>
-</body>
-</html>
diff --git a/data/doc/sisu/html/sisu_help.1.html b/data/doc/sisu/html/sisu_help.1.html
deleted file mode 100644
index 9b820917..00000000
--- a/data/doc/sisu/html/sisu_help.1.html
+++ /dev/null
@@ -1,213 +0,0 @@
-<!-- manual page source format generated by PolyglotMan v3.2, -->
-<!-- available at http://polyglotman.sourceforge.net/ -->
-
-<html>
-<head>
-<title>"sisu_help"("1") manual page</title>
-</head>
-<body bgcolor='white'>
-<a href='#toc'>Table of Contents</a><p>
-SISU - HELP, RALPH AMISSAH
-<p> SISU HELP
-<p> 1. HELP
-<p> 1.1 SISU MANUAL
-<p> The most
-up to date information on sisu should be contained in the sisu_manual,
-available at:
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/'>http://www.jus.uio.no/sisu/sisu_manual/</a>
-&gt;<br>
-
-<p> and (from <b>SiSU</b> 0.59 onwards) installed locally at:
-<p> /usr/share/doc/sisu/sisu_manual/<br>
-
-<p> or equivalent directory
-<p> Within the <b>SiSU</b> tarball at:
-<p> ./data/doc/sisu/sisu_manual/<br>
-
-<p> 1.2 SISU MAN PAGES
-<p> If <b>SiSU</b> is installed on your system usual man commands
-should be available, try:
-<p> man sisu<br>
-
-<p> man sisu_markup<br>
-
-<p> man sisu_commands<br>
-
-<p> Most <b>SiSU</b> man pages are generated directly from sisu documents that
-are used to prepare the sisu manual, the sources files for which are located
-within the <b>SiSU</b> tarball at:
-<p> ./data/doc/sisu/sisu_manual/<br>
-
-<p> Once installed, directory equivalent to:
-<p> /usr/share/doc/sisu/sisu_manual/<br>
-
-<p> Available man pages are converted back to html using man2html:
-<p> /usr/share/doc/sisu/html/<br>
-
-<p> ./data/doc/sisu/html/<br>
-
-<p> The <b>SiSU</b> man pages can be viewed online at:[^1]
-<p> An online version of
-the sisu man page is available here:
-<p> * various sisu man pages &lt;<a href='http://www.jus.uio.no/sisu/man/'>http://www.jus.uio.no/sisu/man/</a>
-&gt;
-&nbsp;[^2]
-<p> * sisu.1 &lt;<a href='http://www.jus.uio.no/sisu/man/sisu.1.html'>http://www.jus.uio.no/sisu/man/sisu.1.html</a>
-&gt; &nbsp;[^3]
-<p> * sisu.8 &lt;<a href='http://www.jus.uio.no/sisu/man/sisu.8.html'>http://www.jus.uio.no/sisu/man/sisu.8.html</a>
-&gt;
-&nbsp;[^4]
-<p> * sisu_examples.1 &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_examples.1.html'>http://www.jus.uio.no/sisu/man/sisu_examples.1.html</a>
-&gt; &nbsp;[^5]
-
-<p> * sisu_webrick.1 &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_webrick.1.html'>http://www.jus.uio.no/sisu/man/sisu_webrick.1.html</a>
-&gt; &nbsp;[^6]
-<p> 1.3
-
-<p>SISU BUILT-IN INTERACTIVE HELP
-<p> This is particularly useful when current
-installation information is obtained as the interactive help is able to
-provide information on your sisu configuration and setup.
-<p> sisu --help<br>
-
-<p> sisu --help &nbsp;[subject]<br>
-
-<p> sisu --help env &nbsp;[for &nbsp;feedback &nbsp;on &nbsp;the &nbsp;way &nbsp;your &nbsp;system &nbsp;is <br>
- setup &nbsp;with &nbsp;regard &nbsp;to &nbsp;sisu]<br>
-
-<p> sisu -V &nbsp;[same &nbsp;as &nbsp;above &nbsp;command]<br>
-
-<p> sisu --help commands<br>
-
-<p> sisu --help markup<br>
-
-<p> Apart from real-time information on your current configuration the <b>SiSU</b>
-manual and man pages are likely to contain more up-to-date information than
-the sisu interactive help (for example on commands and markup).
-<p> NOTE:
-Running the command sisu (alone without any flags, filenames or wildcards)
-brings up the interactive help, as does any sisu command that is not recognised.
-Enter to escape.
-<p> 1.4 HELP SOURCES
-<p> For lists of alternative help sources,
-see:
-<p> <b>man page</b>
-<p> man sisu_help_sources<br>
-
-<p> <b>man2html</b>
-<p> /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html<br>
-
-<p> <b>sisu generated html</b>
-<p> /usr/share/doc/sisu/html/sisu_help_sources/index.html<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_help_sources/index.html'>http://sisudoc.org/sisu_manual/sisu_help_sources/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html</a>
-&gt;<br>
-
-<p> DOCUMENT INFORMATION (METADATA)
-<p> METADATA
-<p> Document Manifest @ &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_help/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_help/sisu_manifest.html</a>
-&gt;
-
-<p> <b>Dublin Core</b> (DC)
-<p> <i>DC</i> tags included with this document are provided here.
-
-<p> DC Title: <i>SiSU</i> - Help
-<p> DC Creator: <i>Ralph</i> Amissah
-<p> DC Rights: <i>Copyright</i>
-(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
-<p> DC
-Type: <i>information</i>
-<p> DC Date created: <i>2002-08-28</i>
-<p> DC Date issued: <i>2002-08-28</i>
-
-<p> DC Date available: <i>2002-08-28</i>
-<p> DC Date modified: <i>2007-08-30</i>
-<p> DC Date: <i>2007-08-30</i>
-
-<p> <b>Version Information</b>
-<p> Sourcefile: <i>sisu_help.sst</i>
-<p> Filetype: <i>SiSU</i> text
-
-<p>0.58
-<p> Sourcefile Digest, MD5(sisu_help.sst)= <i>66d04ba5f3dd4ede774ffa5549b3faba</i>
-
-<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-
-<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i>
-<p> <b>Generated</b>
-<p> Document (metaverse) last
-generated: <i>Mon</i> Sep 24 15:36:13 +0100 2007
-<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of
-2007w38/0 (2007-09-23)
-<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36)
-&nbsp;[i486-linux]
-<p>
-<ol>
-<b>.</b><li>generated from source using rman &lt;<a href='http://polyglotman.sourceforge.net/rman.html'>http://polyglotman.sourceforge.net/rman.html</a>
-&gt;<br>
- With regard to<br>
- <b>SiSU</b> man pages the formatting generated for markup syntax is not quite
-right, for that you might prefer the links under: &lt;<a href='http://www.jus.uio.no/sample'>http://www.jus.uio.no/sample</a>
-&gt;<br>
- </li><b>.</b><li>&lt;<a href='http://www.jus.uio.no/sisu/man/'>http://www.jus.uio.no/sisu/man/</a>
-&gt; </li><b>.</b><li>&lt;<a href='http://www.jus.uio.no/sisu/man/sisu.1.html'>http://www.jus.uio.no/sisu/man/sisu.1.html</a>
-&gt; </li><b>.</b><li>&lt;<a href='http://www.jus.uio.no/sisu/man/sisu.8.html'>http://www.jus.uio.no/sisu/man/sisu.8.html</a>
-&gt;
-</li><b>.</b><li>&lt;<a href='http://www.jus.uio.no/sisu/man/sisu_examples.1.html'>http://www.jus.uio.no/sisu/man/sisu_examples.1.html</a>
-&gt; </li><b>.</b><li>&lt;<a href='http://www.jus.uio.no/sisu/man/sisu_webrick.1.html'>http://www.jus.uio.no/sisu/man/sisu_webrick.1.html</a>
-&gt;
-
-<p> </dd>
-
-<dt>Other versions of this document: </dt>
-<dd></dd>
-
-<dt>manifest: &lt;<a href='http://www.jus.uio.no/sisu/sisu_help/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_help/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_help/sisu_manifest.html</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>html: &lt;<a href='http://www.jus.uio.no/sisu/sisu_help/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_help/toc.html'>http://www.jus.uio.no/sisu/sisu_help/toc.html</a>
-</a>
-&gt; </dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_help/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_help/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_help/portrait.pdf</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_help/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_help/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_help/landscape.pdf</a>
-</a>
-&gt; </dt>
-<dd> </dd>
-
-<dt>at: &lt;<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt>
-<dd></dd>
-
-<dt>* Ruby version: ruby
-1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt>
-<dd></dd>
-
-<dt>* Last Generated on: Mon Sep 24
-15:36:30 +0100 2007 </dt>
-<dd></dd>
-
-<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
- </dt>
-<dd></dd>
-</dl>
-<p>
-</body>
-</html>
diff --git a/data/doc/sisu/html/sisu_help_sources.1.html b/data/doc/sisu/html/sisu_help_sources.1.html
deleted file mode 100644
index 8ff0d1de..00000000
--- a/data/doc/sisu/html/sisu_help_sources.1.html
+++ /dev/null
@@ -1,582 +0,0 @@
-<!-- manual page source format generated by PolyglotMan v3.2, -->
-<!-- available at http://polyglotman.sourceforge.net/ -->
-
-<html>
-<head>
-<title>"sisu_help_sources"("1") manual page</title>
-</head>
-<body bgcolor='white'>
-<a href='#toc'>Table of Contents</a><p>
-SISU - REFERENCES, RALPH AMISSAH
-<p> SISU HELP SOURCES
-<p> 1. HELP SOURCES
-<p>
- For a summary of alternative ways to get help on <b>SiSU</b> try one of the following:
-
-<p> <b>man page</b>
-<p> man sisu_help<br>
-
-<p> <b>man2html</b>
-<p> &lt;file:///usr/share/doc/sisu/html/sisu_help.1.html&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_help.1.html'>http://www.jus.uio.no/sisu/man/sisu_help.1.html</a>
-&gt;<br>
-
-<p> <b>sisu generated output - links to html</b>
-<p> &lt;file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_help/index.html'>http://sisudoc.org/sisu_manual/sisu_help/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html</a>
-&gt;<br>
-
-<p> <b>help sources lists</b>
-<p> Alternative sources for this help sources page
-listed here:
-<p> man sisu_help_sources<br>
-
-<p> &lt;file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html&gt;<br>
-
-<p> &lt;file:///usr/share/doc/sisu/html/sisu_help_sources/index.html&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_help_sources/index.html'>http://sisudoc.org/sisu_manual/sisu_help_sources/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html</a>
-&gt;<br>
-
-<p> 1.1 MAN PAGES
-<p> 1.1.1 MAN
-<p> man sisu<br>
-
-<p> man sisu_commands<br>
-
-<p> man 7 sisu_complete<br>
-
-<p> man sisu_configuration<br>
-
-<p> man 8 sisu_faq<br>
-
-<p> man sisu_filetypes<br>
-
-<p> man sisu_help<br>
-
-<p> man sisu_help_sources<br>
-
-<p> man 8 sisu_howto<br>
-
-<p> man sisu_introduction<br>
-
-<p> man sisu_markup<br>
-
-<p> man sisu_output_overview<br>
-
-<p> man 7 sisu_pdf<br>
-
-<p> man 7 sisu_postgresql<br>
-
-<p> man 8 sisu_quickstart<br>
-
-<p> man 8 sisu_remote<br>
-
-<p> man 8 sisu_search<br>
-
-<p> man sisu_skin<br>
-
-<p> man 7 sisu_sqlite<br>
-
-<p> man 8 sisu_syntax_highlighting<br>
-
-<p> man 7 sisu_vim<br>
-
-<p> man sisu_webrick<br>
-
-<p> 1.2 SISU GENERATED OUTPUT - LINKS TO HTML
-<p> Note <b>SiSU</b> documentation is
-prepared in <b>SiSU</b> and output is available in multiple formats including
-amongst others html, pdf, and odf which may be also be accessed via the
-html pages[^1]
-<p> 1.2.1 LOCALLY INSTALLED
-<p> &lt;file:///usr/share/doc/sisu/sisu_manual/sisu_manual/index.html&gt;
-
-<p> &lt;file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html&gt;
-<p> &lt;file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html&gt;
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_commands/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_complete/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_configuration/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_description/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_examples/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_faq/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_filetypes/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_help/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_howto/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_introduction/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_manual/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_markup/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_output_overview/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_pdf/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_postgresql/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_quickstart/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_remote/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_search/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_skin/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_sqlite/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_syntax_highlighting/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_vim/index.html<br>
-
-<p> /usr/share/doc/sisu/sisu_manual/sisu_webrick/index.html<br>
-
-<p> 1.2.2 WWW.SISUDOC.ORG
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_manual/index.html'>http://sisudoc.org/sisu_manual/sisu_manual/index.html</a>
-&gt;
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu/index.html'>http://sisudoc.org/sisu_manual/sisu/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_commands/index.html'>http://sisudoc.org/sisu_manual/sisu_commands/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_complete/index.html'>http://sisudoc.org/sisu_manual/sisu_complete/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_configuration/index.html'>http://sisudoc.org/sisu_manual/sisu_configuration/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_description/index.html'>http://sisudoc.org/sisu_manual/sisu_description/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_examples/index.html'>http://sisudoc.org/sisu_manual/sisu_examples/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_faq/index.html'>http://sisudoc.org/sisu_manual/sisu_faq/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_filetypes/index.html'>http://sisudoc.org/sisu_manual/sisu_filetypes/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_help/index.html'>http://sisudoc.org/sisu_manual/sisu_help/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_help_sources/index.html'>http://sisudoc.org/sisu_manual/sisu_help_sources/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_howto/index.html'>http://sisudoc.org/sisu_manual/sisu_howto/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_introduction/index.html'>http://sisudoc.org/sisu_manual/sisu_introduction/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_manual/index.html'>http://sisudoc.org/sisu_manual/sisu_manual/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_markup/index.html'>http://sisudoc.org/sisu_manual/sisu_markup/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_output_overview/index.html'>http://sisudoc.org/sisu_manual/sisu_output_overview/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_pdf/index.html'>http://sisudoc.org/sisu_manual/sisu_pdf/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_postgresql/index.html'>http://sisudoc.org/sisu_manual/sisu_postgresql/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_quickstart/index.html'>http://sisudoc.org/sisu_manual/sisu_quickstart/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_remote/index.html'>http://sisudoc.org/sisu_manual/sisu_remote/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_search/index.html'>http://sisudoc.org/sisu_manual/sisu_search/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_skin/index.html'>http://sisudoc.org/sisu_manual/sisu_skin/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_sqlite/index.html'>http://sisudoc.org/sisu_manual/sisu_sqlite/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_syntax_highlighting/index.html'>http://sisudoc.org/sisu_manual/sisu_syntax_highlighting/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_vim/index.html'>http://sisudoc.org/sisu_manual/sisu_vim/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/sisu_manual/sisu_webrick/index.html'>http://sisudoc.org/sisu_manual/sisu_webrick/index.html</a>
-&gt;<br>
-
-<p> 1.2.3 WWW.JUS.UIO.NO/SISU
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html</a>
-&gt;
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_complete/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_complete/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_description/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_description/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_examples/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_examples/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_filetypes/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_filetypes/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_introduction/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_introduction/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_output_overview/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_output_overview/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_pdf/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_pdf/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_search/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_search/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_sqlite/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_sqlite/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_vim/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_vim/index.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_webrick/index.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_webrick/index.html</a>
-&gt;<br>
-
-<p> 1.2.4 MAN2HTML
-<p> 1.2.5 LOCALLY INSTALLED
-<p> &lt;file:///usr/share/doc/sisu/html/sisu_manual.1.html&gt;
-
-<p> &lt;file:///usr/share/doc/sisu/html/sisu_help.1.html&gt;
-<p> &lt;file:///usr/share/doc/sisu/html/sisu_help_sources.1.html&gt;
-
-<p> /usr/share/doc/sisu/html/sisu.1.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_commands.1.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_complete.7.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_configuration.1.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_faq.8.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_help.1.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_help_sources.1.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_howto.8.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_markup.1.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_pdf.7.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_postgresql.7.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_quickstart.8.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_remote.8.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_search.8.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_skin.1.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_sqlite.7.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_syntax_highlighting.8.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_vim.7.html<br>
-
-<p> /usr/share/doc/sisu/html/sisu_webrick.1.html<br>
-
-<p> 1.2.6 WWW.SISUDOC.ORG
-<p> &lt;<a href='http:///sisudoc.org/man/sisu_manual.1.html'>http:///sisudoc.org/man/sisu_manual.1.html</a>
-&gt;
-<p> &lt;<a href='http:///sisudoc.org/man/sisu_help.1.html'>http:///sisudoc.org/man/sisu_help.1.html</a>
-&gt;
-
-<p> &lt;<a href='http:///sisudoc.org/man/sisu_help_sources.1.html'>http:///sisudoc.org/man/sisu_help_sources.1.html</a>
-&gt;
-<p> &lt;<a href='http://sisudoc.org/man/sisu.1.html'>http://sisudoc.org/man/sisu.1.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_commands.1.html'>http://sisudoc.org/man/sisu_commands.1.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_complete.7.html'>http://sisudoc.org/man/sisu_complete.7.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_configuration.1.html'>http://sisudoc.org/man/sisu_configuration.1.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_faq.8.html'>http://sisudoc.org/man/sisu_faq.8.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_help.1.html'>http://sisudoc.org/man/sisu_help.1.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_help_sources.1.html'>http://sisudoc.org/man/sisu_help_sources.1.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_howto.8.html'>http://sisudoc.org/man/sisu_howto.8.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_markup.1.html'>http://sisudoc.org/man/sisu_markup.1.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_pdf.7.html'>http://sisudoc.org/man/sisu_pdf.7.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_postgresql.7.html'>http://sisudoc.org/man/sisu_postgresql.7.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_quickstart.8.html'>http://sisudoc.org/man/sisu_quickstart.8.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_remote.8.html'>http://sisudoc.org/man/sisu_remote.8.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_search.8.html'>http://sisudoc.org/man/sisu_search.8.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_skin.1.html'>http://sisudoc.org/man/sisu_skin.1.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_sqlite.7.html'>http://sisudoc.org/man/sisu_sqlite.7.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_syntax_highlighting.8.html'>http://sisudoc.org/man/sisu_syntax_highlighting.8.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_vim.7.html'>http://sisudoc.org/man/sisu_vim.7.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://sisudoc.org/man/sisu_webrick.1.html'>http://sisudoc.org/man/sisu_webrick.1.html</a>
-&gt;<br>
-
-<p> 1.2.7 WWW.JUS.UIO.NO/SISU
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_manual.1.html'>http://www.jus.uio.no/sisu/man/sisu_manual.1.html</a>
-&gt;
-<p>
- &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_help.1.html'>http://www.jus.uio.no/sisu/man/sisu_help.1.html</a>
-&gt;
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html'>http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html</a>
-&gt;
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu.1.html'>http://www.jus.uio.no/sisu/man/sisu.1.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_commands.1.html'>http://www.jus.uio.no/sisu/man/sisu_commands.1.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_complete.7.html'>http://www.jus.uio.no/sisu/man/sisu_complete.7.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_configuration.1.html'>http://www.jus.uio.no/sisu/man/sisu_configuration.1.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_faq.8.html'>http://www.jus.uio.no/sisu/man/sisu_faq.8.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_help.1.html'>http://www.jus.uio.no/sisu/man/sisu_help.1.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html'>http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_howto.8.html'>http://www.jus.uio.no/sisu/man/sisu_howto.8.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_markup.1.html'>http://www.jus.uio.no/sisu/man/sisu_markup.1.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_pdf.7.html'>http://www.jus.uio.no/sisu/man/sisu_pdf.7.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_postgresql.7.html'>http://www.jus.uio.no/sisu/man/sisu_postgresql.7.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_quickstart.8.html'>http://www.jus.uio.no/sisu/man/sisu_quickstart.8.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_remote.8.html'>http://www.jus.uio.no/sisu/man/sisu_remote.8.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_search.8.html'>http://www.jus.uio.no/sisu/man/sisu_search.8.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_skin.1.html'>http://www.jus.uio.no/sisu/man/sisu_skin.1.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_sqlite.7.html'>http://www.jus.uio.no/sisu/man/sisu_sqlite.7.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_syntax_highlighting.8.html'>http://www.jus.uio.no/sisu/man/sisu_syntax_highlighting.8.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_vim.7.html'>http://www.jus.uio.no/sisu/man/sisu_vim.7.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_webrick.1.html'>http://www.jus.uio.no/sisu/man/sisu_webrick.1.html</a>
-&gt;<br>
-
-<p> DOCUMENT INFORMATION (METADATA)
-<p> METADATA
-<p> Document Manifest @ &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/sisu_manifest.html</a>
-&gt;
-
-<p> <b>Dublin Core</b> (DC)
-<p> <i>DC</i> tags included with this document are provided here.
-
-<p> DC Title: <i>SiSU</i> - References
-<p> DC Creator: <i>Ralph</i> Amissah
-<p> DC Rights: <i>Copyright</i>
-(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
-<p> DC
-Type: <i>information</i>
-<p> DC Date created: <i>2002-11-12</i>
-<p> DC Date issued: <i>2002-11-12</i>
-
-<p> DC Date available: <i>2002-11-12</i>
-<p> DC Date modified: <i>2007-09-16</i>
-<p> DC Date: <i>2007-09-16</i>
-
-<p> <b>Version Information</b>
-<p> Sourcefile: <i>sisu_help_sources.sst</i>
-<p> Filetype: <i>SiSU</i>
-
-<p>text insert 0.58
-<p> Sourcefile Digest, MD5(sisu_help_sources.sst)= <i>ff6812b3008391d7a20d777bbbeb3ec1</i>
-
-<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-
-<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i>
-<p> <b>Generated</b>
-<p> Document (metaverse) last
-generated: <i>Mon</i> Sep 24 15:36:13 +0100 2007
-<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of
-2007w38/0 (2007-09-23)
-<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36)
-&nbsp;[i486-linux]
-<p>
-<ol>
-<b>.</b><li>named index.html or more extensively through sisu_manifest.html
-
-<p> </dd>
-
-<dt>Other versions of this document: </dt>
-<dd></dd>
-
-<dt>manifest: &lt;<a href='http://www.jus.uio.no/sisu/sisu_help_sources/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_help_sources/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_help_sources/sisu_manifest.html</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>html: &lt;<a href='http://www.jus.uio.no/sisu/sisu_help_sources/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_help_sources/toc.html'>http://www.jus.uio.no/sisu/sisu_help_sources/toc.html</a>
-</a>
-&gt; </dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_help_sources/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_help_sources/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_help_sources/portrait.pdf</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_help_sources/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_help_sources/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_help_sources/landscape.pdf</a>
-</a>
-&gt; </dt>
-<dd> </dd>
-
-<dt>at: &lt;<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt>
-<dd></dd>
-
-<dt>* Ruby version: ruby
-1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt>
-<dd></dd>
-
-<dt>* Last Generated on: Mon Sep 24
-15:36:30 +0100 2007 </dt>
-<dd></dd>
-
-<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
- </dt>
-<dd></dd>
-</dl>
-<p>
-</body>
-</html>
diff --git a/data/doc/sisu/html/sisu_howto.8.html b/data/doc/sisu/html/sisu_howto.8.html
deleted file mode 100644
index a5b9adf7..00000000
--- a/data/doc/sisu/html/sisu_howto.8.html
+++ /dev/null
@@ -1,1447 +0,0 @@
-<!-- manual page source format generated by PolyglotMan v3.2, -->
-<!-- available at http://polyglotman.sourceforge.net/ -->
-
-<html>
-<head>
-<title>"sisu_howto"("1") manual page</title>
-</head>
-<body bgcolor='white'>
-<a href='#toc'>Table of Contents</a><p>
-SISU - TECHNICAL, HOWTO, RALPH AMISSAH
-<p> SISU SOME TECHNICAL INFORMATION
-
-<p> HOWTO
-<p> 1. GETTING HELP
-<p> An online manual of sorts should be available
-at:
-<p> &lt;<a href='http://www.jus.uio.no/sisu_manual/'>http://www.jus.uio.no/sisu_manual/</a>
-&gt;
-<p> The manual pages provided with
-<b>SiSU</b> are also available online, and there is an interactive help, which
-is being superseded by the man page, and possibly some document which contains
-this component.
-<p> 1.1 SISU
-<p> If <b>SiSU</b> is installed on your system usual man
-commands should be available, try:
-<p> man sisu
-<p> The <b>SiSU</b> man pages can
-be viewed online at:[^1]
-<p> An online version of the sisu man page is available
-here:
-<p> * various sisu man pages &lt;<a href='http://www.jus.uio.no/sisu/man/'>http://www.jus.uio.no/sisu/man/</a>
-&gt; &nbsp;[^2]
-<p> * sisu.1
-&lt;<a href='http://www.jus.uio.no/sisu/man/sisu.1.html'>http://www.jus.uio.no/sisu/man/sisu.1.html</a>
-&gt; &nbsp;[^3]
-<p> * sisu.8 &lt;<a href='http://www.jus.uio.no/sisu/man/sisu.8.html'>http://www.jus.uio.no/sisu/man/sisu.8.html</a>
-&gt;
-&nbsp;[^4]
-<p> * sisu_examples.1 &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_examples.1.html'>http://www.jus.uio.no/sisu/man/sisu_examples.1.html</a>
-&gt; &nbsp;[^5]
-
-<p> * sisu_webrick.1 &lt;<a href='http://www.jus.uio.no/sisu/man/sisu_webrick.1.html'>http://www.jus.uio.no/sisu/man/sisu_webrick.1.html</a>
-&gt; &nbsp;[^6]
-<p> 1.2
-
-<p>SISU BUILT-IN HELP
-<p> sisu --help<br>
-
-<p> sisu --help &nbsp;[subject]<br>
-
-<p> sisu --help env &nbsp;[for &nbsp;feedback &nbsp;on &nbsp;the &nbsp;way &nbsp;your &nbsp;system &nbsp;is <br>
- setup &nbsp;with &nbsp;regard &nbsp;to &nbsp;sisu]<br>
-
-<p> sisu -V &nbsp;[same &nbsp;as &nbsp;above &nbsp;command]<br>
-
-<p> sisu --help commands<br>
-
-<p> sisu --help markup<br>
-
-<p> 1.3 COMMAND LINE WITH FLAGS - BATCH PROCESSING
-<p> Running sisu (alone without
-any flags, filenames or wildcards) brings up the interactive help, as does
-any sisu command that is not recognised.
-<p> In the data directory run sisu
--mh filename or wildcard eg. cisg.sst documents.
-<p> 2. SETUP, INITIALISATION
-
-<p> 2.1 INITIALISE OUTPUT DIRECTORY
-<p> Images, css files for a document directory
-are copied to their respective locations in the output directory.
-<p> while
-within your document markup/preparation directory, issue the following
-
-<p>command
-<p> sisu -CC<br>
-
-<p> 2.1.1 USE OF SEARCH FUNCTIONALITY, AN EXAMPLE USING SQLITE
-<p> <b>SiSU</b> can populate
-PostgreSQL and Sqlite databases and provides a sample search form for querying
-these databases.
-<p> This note provides an example to get you started and
-
-<p>will use sqlite
-<p> It is necessary to:
-<p> (1) make sure the required dependencies
-
-<p>have been installed
-<p> (2) have a directory with sisu markup samples that
-
-<p>is writable
-<p> (3) use sisu to create a database
-<p> (4) use sisu tp populate
-
-<p>a database
-<p> (5) use sisu to start the webrick (httpd) server
-<p> (6) use
-
-<p>sisu to create a search form
-<p> (7) copy the search form to the cgi directory
-
-<p> (8) open up the form in your browser
-<p> (9) query the database using the
-
-<p>search form
-<p> <b>(1) make sure the required dependencies have been installed</b>
-
-<p> if you use <b>Debian</b> , the following command will install the required dependencies
-
-<p> aptitude install sisu-sqlite
-<p> <b>(2) have a directory with sisu markup samples
-
-<p>that is writable</b>
-<p> ideally copy the sisu-examples directory to your home
-directory (because the directory in which you run this example should be
-writable)
-<p> cp -rv /usr/share/sisu-examples/sample/document_samples_sisu_markup
-~/.
-<p> <b>(3) use sisu to create an sqlite database</b>
-<p> within the sisu-examples
-
-<p>directory
-<p> sisu -dv createall
-<p> <b>(4) use sisu tp populate a database with
-
-<p>some text</b>
-<p> within the sisu-examples directory
-<p> sisu -div free_*.sst
-<p> or
-
-<p> sisu -dv import free_*.sst debian_constitution_v1.2.sst debian_social_contract_v1.1.sst
-
-<p>gpl2.fsf.sst
-<p> <b>(5) use sisu to start the webrick (httpd) server (if it has
-not already</b> been started):
-<p> sisu -W
-<p> <b>(6) use sisu to create a search form
-(for use with the webrick server, and</b> your sample documents)
-<p> within the
-
-<p>sisu-examples directory
-<p> sisu -F webrick
-<p> #here i run into a problem, you
-are working from a read only #directory..., not my usual mode of operation,
-
-<p>to complete the example #the following is necessary sudo touch sisu_sqlite.cgi
-
-<p>sisu_pgsql.cgi sudo -P chown $USER sisu_sqlite.cgi sisu_pgsql.cgi
-<p> #now this
-should be possible: sisu -F webrick
-<p> <b>(7) copy the search form to the cgi
-
-<p>directory</b>
-<p> the string should be provided as output from the previous command
-
-<p> sudo cp -vi /usr/share/sisu-examples/sample/document_samples_sisu_markup/sisu_sqlite.cgi
-
-<p>/usr/lib/cgi-bin
-<p> sudo chmod -v 755 /usr/lib/cgi-bin/sisu_sqlite.cgi
-<p> <b>(8)
-
-<p>open up the form in your browser and query it</b>
-<p> url:
-<p> &lt;<a href='http://localhost:8081/cgi-bin/sisu_sqlite.cgi'>http://localhost:8081/cgi-bin/sisu_sqlite.cgi</a>
-&gt;
-
-<p> or as instructed by command sisu -F webrick
-<p> <b>(9) query the database using
-
-<p>the search form</b>
-<p> if there are other options in the dropdown menu select
-
-<p> document_samples_sisu_markup
-<p> and search for some text, e.g.:
-<p> aim OR
-
-<p>project
-<p> * selecting the <b>index</b> radio button gives an index of results
-
-<p>using the object numbers
-<p> * selecting the <b>text</b> radio button gives the
-
-<p>content of the matched paragraphs with the match highlighted
-<p> <b>(10) to
-
-<p>start again with a new database</b>
-<p> to start from scratch you can drop the
-
-<p>database with the command
-<p> sisu -dv dropall
-<p> and go to step 3
-<p> to get
-
-<p>to step 3 in one step with a single command
-<p> sisu -dv recreate
-<p> continue
-
-<p>subsequent steps
-<p> 2.2 MISC
-<p> 2.2.1 URL FOR OUTPUT FILES -U -U
-<p> sisu -uv[and
-&nbsp;other &nbsp;flags] &nbsp;[filename/wildcard]<br>
-
-<p> sisu -Uv &nbsp;[filename/wildcard]<br>
-
-<p> 2.2.2 TOGGLE SCREEN COLOR
-<p> sisu -cv[and &nbsp;processing &nbsp;flags] &nbsp;[filename/wildcard]<br>
-
-<p> 2.2.3 VERBOSE MODE
-<p> sisu -v[and &nbsp;processing &nbsp;flags] &nbsp;[filename/wildcard]<br>
-
-<p> sisu -V[and &nbsp;processing &nbsp;flags] &nbsp;[filename/wildcard]<br>
-
-<p> 2.2.4 QUIET MODE
-<p> sisu -q[and &nbsp;processing &nbsp;flags] &nbsp;[filename/wildcard]<br>
-
-<p> 2.2.5 MAINTENANCE MODE INTERMEDIATE FILES KEPT -M
-<p> sisu -Mv[and &nbsp;other
-&nbsp;flags] &nbsp;[filename/wildcard]<br>
-
-<p> 2.2.6 START THE WEBRICK SERVER
-<p> sisu -W<br>
-
-<p> 2.3 REMOTE PLACEMENT OF OUTPUT
-<p> configuration is necessary
-<p> scp
-<p>
-sisu -vr[and &nbsp;processing &nbsp;flags] &nbsp;[filename/wildcard]<br>
-
-<p> rsync
-<p> sisu -vR[and &nbsp;processing &nbsp;flags] &nbsp;[filename/wildcard]<br>
-
-<p> 3. CONFIGURATION FILES
-<p> Sample provided, on untarring the source tarball:
-
-<p> conf/sisu/sisurc.yaml<br>
-
-<p> and on installation under:
-<p> /etc/sisu/sisurc.yaml<br>
-
-<p> The following paths are searched:
-<p> ./_sisu/sisurc.yaml<br>
-
-<p> ~/.sisu/sisurc.yaml<br>
-
-<p> ./etc/sisu/sisurc.yaml<br>
-
-<p> 4. MARKUP
-<p> See sample markup provided on
-<p> &lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-&gt;
-<p>
- &lt;<a href='http://www.jus.uio.no/sisu_markup'>http://www.jus.uio.no/sisu_markup</a>
-&gt;
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU'>http://www.jus.uio.no/sisu/SiSU</a>
-&gt;
-<p> in particular
-for each of the document output samples provided, the source document is
-
-<p>provided as well
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU/2#books'>http://www.jus.uio.no/sisu/SiSU/2#books</a>
-&gt;
-<p> on untarring
-the source tarball:
-<p> data/sisu-examples/sample/document_samples_sisu_markup/<br>
-
-<p> or the same once source is installed (or sisu-examples) under:
-<p> /usr/share/sisu-examples/sample/document_samples_sisu_markup/<br>
-
-<p> Some notes are contained within the man page, <b>man sisu</b> and within sisu
-
-<p>help via the commands <b>sisu help markup</b> and <b>sisu help headers</b>
-<p> <b>SiSU</b> is
-for literary and legal text, also for some social science material. In particular
-it does not do formula, and is not particularly suited to technical documentation.
-Despite the latter caveat, some notes will be provided here and added to
-over time:
-<p> 4.1 HEADERS
-<p> Headers @headername: provide information related
-to the document, this may relate to
-<p> 1. how it is to be processed, such
-as whether headings are to be numbered, what skin is to be used and markup
-instructions, such as the document structure, or words to be made bold
-
-<p>within the document
-<p> 2. semantic information about the document including
-
-<p>the dublin core
-<p> 4.2 FONT FACE
-<p> Defaults are set. You may change the face
-to: bold, italics, underscore, strikethrough, ...
-<p> 4.2.1 BOLD
-<p> @bold: &nbsp;[list
-&nbsp;of &nbsp;words &nbsp;that &nbsp;should &nbsp;be &nbsp;made &nbsp;bold &nbsp;within or document]
-<p> <b>bold line</b>
-<p> !_
-
-<p>bold line
-<p> <b>bold word or sentence</b>
-<p> !{ bold word or sentence }!
-<p> *{ bold
-word or sentence }*
-<p> <b>boldword</b> or <b>boldword</b>
-<p> *boldword* or !boldword!
-<p>
-
-<p>4.2.2 ITALICS
-<p> @italics: &nbsp;[list &nbsp;of &nbsp;words &nbsp;that &nbsp;should &nbsp;be &nbsp;italicised &nbsp;within
-
-<p> <i>italicise</i> word or sentence
-<p> /{ italicise word or sentence }/
-<p> <i>italicisedword</i>
-
-<p> /italicisedword/
-<p> 4.2.3 UNDERSCORE
-<p> <i>underscore</i> word or sentence
-<p> _{ underscore
-word or sentence }_
-<p> <i>underscoreword</i>
-<p> 4.2.4 STRIKETHROUGH
-<p> &lt;del&gt; strikethrough
-word or sentence &lt;/del&gt;
-<p> -{ strikethrough word or sentence }-
-<p> &lt;del&gt;strikeword&lt;/del&gt;
-
-<p> -strikeword-
-<p> 4.3 ENDNOTES
-<p> There are two forms of markup for endnotes,
-
-<p>they cannot be mixed within the same document
-<p> here[^7]
-<p> 1. preferred endnote
-
-<p>markup
-<p> here~{ this is an endnote }~
-<p> 2. alternative markup equivalent,
-
-<p>kept because it is possible to search and replace to get markup in existing
-
-<p>texts such as Project Gutenberg
-<p> here~^
-<p> ^~ this is an endote
-<p> 4.4 LINKS
-
-<p> SiSU &lt;<a href='http://sisudoc.org'>http://sisudoc.org</a>
-&gt;
-<p> { <b>SiSU</b> }<a href='http://sisudoc.org'>http://sisudoc.org</a>
-
-<p> sisu.png 120x39 &lt;<a href='http://sisudoc.org'>http://sisudoc.org</a>
-&gt;
-
-<p> {sisu.png }<a href='http://sisudoc.org'>http://sisudoc.org</a>
-
-<p> [ tux.png ]
-<p> { tux.png 64x80 }image
-<p> SiSU
-&lt;<a href='http://sisudoc.org'>http://sisudoc.org</a>
-&gt; &nbsp;[^8]
-<p> { <b>SiSU</b> }<a href='http://sisudoc.org'>http://sisudoc.org</a>
-
-<p> is equivalent to:
-<p>
- { <b>SiSU</b> }<a href='http://sisudoc.org'>http://sisudoc.org</a>
- ~{ &lt;<a href='http://sisudoc.org'>http://sisudoc.org</a>
-&gt; }~
-<p> the same can be done
-with an image:
-<p> sisu.png 120x39
-<p> { sisu.png <b>SiSU</b> }<a href='http://sisudoc.org'>http://sisudoc.org</a>
-<br>
-
-<p> 4.5 NUMBER TITLES
-<p> Set with the header @markup:
-<p> 4.6 LINE OPERATIONS
-<p>
- Line Operations (marker placed at start of line)
-<p> !_ bold line
-<p> <b>bold
-
-<p>line</b>
-<p> _1 indent paragraph one level
-<p> indent paragraph one level<br>
-
-<p> _2 indent paragraph two steps
-<p> indent paragraph two steps<br>
-
-<p> _* bullet paragraph
-<p> * bullet paragraph
-<p> # number paragraph (see headers
-for numbering document headings)
-<p> 1. number paragraph (see headers for
-numbering document headings)
-<p> _# number paragraph level 2 (see headers
-for numbering document headings)
-<p> a. number paragraph level 2 (see headers
-for numbering document headings)<br>
-
-<p> 4.7 TABLES
-<p> Table markup sample
-<p>
-<p> table{~h c3; 26; 32; 32; <p>
-
-<p>
-<p> This is
-a table, column1 <p>
-this would become row one of column two <p>
-column three of
-row one is here <p>
-
-<p>
-<p> column one row 2 <p>
-column two of row two <p>
-column three of
-row two, and so on <p>
-
-<p>
-<p> column one row three <p>
-and so on <p>
-here <p>
-
-<p>
-<p> }table <p>
-
-<p> Alternative
-
-<p>form of table markup
-<p>
-<p> <br>
-<pre> {t~h}
- |Mon|Tue|Wed|Thu|Fri|Sat|Sun
- 0 | * | * | * | * | * | * | *
- 1 | * | * | * | * | | |
- 2 | - | * | * | * | * | * |
- 3 | - | * | * | * | * | * | *
- 4 | - | | | * | * | * |
- 5 | * | * | * | * | * | * | *
-</pre>
-<p> 4.8 GROUPED TEXT
-<p>
-<p> <br>
-<pre> 5.times { puts &rsquo;Ruby&rsquo; }
-</pre>
-<p> code{
-<p>
-<p> <br>
-<pre> 5.times { puts &rsquo;Ruby&rsquo; }
-</pre>
-<p> }code
-<p>
-<p> A Limerick <p>
-
-<p>
-<p> There was a young lady from Clyde, <p>
-who ate a green
-apple and died, <p>
-but the apple fermented inside the lamented, <p>
-and made cider
-inside her inside. <p>
-
-<p>
-<p> poem{ <p>
-
-<p>
-<p> There was a young lady from Clyde, <p>
-who ate
-a green apple and died, <p>
-but the apple fermented inside the lamented, <p>
-and
-made cider inside her inside. <p>
-
-<p>
-<p> }poem <p>
-
-<p> 4.9 COMPOSITE DOCUMENT
-<p> To import
-another document, the master document or importing document should be named
-filename.r3 (r for require)
-<p> &amp;lt;&amp;lt; { filename.sst }
-<p> &amp;lt;&amp;lt; { filename.ssi
-}
-<p> 5. CHANGE APPEARANCE
-<p> 5.1 SKINS
-<p> Skins 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 <b>SiSU</b> output.
-<p> There are a few examples provided,
-on untarring the source tarball:
-<p> conf/sisu/skin/doc/<br>
-
-<p> data/sisu-examples/sample/document_samples_sisu_markup/_sisu/skin/doc<br>
-
-<p> and on installation under:
-<p> /etc/sisu/skin/doc/<br>
-
-<p> /usr/share/sisu-examples/sample/document_samples_sisu_markup/_sisu/skin/doc<br>
-
-<p> The following paths are searched:
-<p> ./_sisu/skin<br>
-
-<p> ~/.sisu/skin<br>
-
-<p> /etc/sisu/skin<br>
-
-<p> Skins under the searched paths in a per document directory, a per directory
-directory, or a site directory, named:
-<p> doc &nbsp;[may &nbsp;be &nbsp;specified &nbsp;individually
-&nbsp;in &nbsp;each &nbsp;document]
-<p> dir &nbsp;[used &nbsp;if &nbsp;identifier &nbsp;part &nbsp;of &nbsp;name &nbsp;matches &nbsp;markup
-&nbsp;directory &nbsp;name]
-<p> site
-<p> It is usual to place all skins in the document
-directory, with symbolic links as required from dir or site directories.
-
-<p> 5.2 CSS
-<p> 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:
-<p> _./_sisu/css
-<p> ~/.sisu/css
-<p> and
-<p> /etc/sisu/css
-
-<p> The contents of the first directory found in the search path are copied
-to the corresponding sisu output directory with the commnd:
-<p> sisu -CC
-<p>
- The <b>SiSU</b> standard css files for <b>SiSU</b> output are:
-<p> dom.css html.css html_tables.css
-
-<p>index.css sax.css xhtml.css
-<p> A document may specify its own/bespoke css file
-using the css header.
-<p> @css:
-<p> [expand]
-<p> EXTRACTS FROM THE README
-<p> 6. README
-
-<p> <b>SiSU</b> 0.55 2007w27/6 2007-07-07
-<p> Homepage: &lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-&gt;
-<p> <b>Description</b>
-
-<p> <b>SiSU</b> is lightweight markup based document creation and publishing framework
-that is controlled from the command line. Prepare documents for <b>SiSU</b> using
-your text editor of choice, then use <b>SiSU</b> to generate various output document
-formats.
-<p> With minimal preparation of a plain-text (UTF-8) file using its
-native markup-syntax, <b>SiSU</b> produces: plain-text, HTML, XHTML, XML, ODF:ODT
-(Opendocument), LaTeX, PDF, and populates an SQL database (PostgreSQL or
-SQLite) in paragraph sized chunks so that document searches are done at
-
-<p>this
-<p> Outputs share a common citation numbering system, and any semantic
-meta-data provided about the document.
-<p> <b>SiSU</b> also provides concordance files,
-document content certificates and manifests of generated output.
-<p> <b>SiSU</b>
-takes advantage of well established open standard ways of representing
-text, and provides a bridge to take advantage of the strengths of each,
-while remaining simple. <b>SiSU</b> implements across document formats a &nbsp;from &nbsp;a
-&nbsp;humanities, &nbsp;law, &nbsp;and &nbsp;possibly &nbsp;social &nbsp;sciences &nbsp;rather &nbsp;than &nbsp;technical &nbsp;or
-&nbsp;scientific &nbsp;writing] ... focus is primarily on content and data integrity rather
-than appearance, (though outputs in the various formats are respectable).
-
-<p> A vim syntax highlighting file and an ftplugin with folds for sisu markup
-is provided. Vim 7 includes syntax highlighting for <b>SiSU</b>
-<p> man pages, and
-interactive help are provided.
-<p> Dependencies for various features are taken
-care of in sisu related packages. The package sisu-complete installs the
-whole of <b>SiSU</b>
-<p> Additional document markup samples are provided in the
-package sisu-markup-samples which is found in the non-free archive the licenses
-for the substantive content of the marked up documents provided is that
-provided by the author or original publisher.
-<p> Homepage: &lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-&gt;
-
-<p> <b>SiSU</b> - simple information structuring universe, is a publishing tool,
-document generation and management, (and search enabling) tool primarily
-for literary, academic and legal published works.
-<p> <b>SiSU</b> can be used for
-Internet, Intranet, local filesystem or cd publishing.
-<p> <b>SiSU</b> can be used
-directly off the filesystem, or from a database.
-<p> <b>SiSU</b> &rsquo;s scalability, is
-be dependent on your hardware, and filesystem (in my case Reiserfs), and/or
-database Postgresql.
-<p> Amongst it&rsquo;s characteristics are:
-<p> * simple mnemonoic
-markup style,
-<p> * the ability to produce multiple output formats, including
-html, structured XML, LaTeX, pdf (via LaTeX), stream to a relational database
-whilst retaining document structure - Postgresql and Sqlite,
-<p> * that all
-share a common citation system (a simple idea from which much good), possibly
-most exciting, the following: if fed into a relational database (as it
-can be automatically), the document set is searchable, with results displayed
-at a paragraph level, or the possibility of an indexed display of documents
-in which the match is found together with a hyperlinked listing for each
-of each paragraph in which the match is found. In any event citations using
-this system (with or without the relational database) are relevant for
-all output formats.
-<p> * it is command line driven, and can be set up on
-
-<p>a remote server
-<p> * Documents are marked up in <b>SiSU</b> syntax in your favourite
-editor. <b>SiSU</b> syntax may be regarded as a type of smart ascii - which in its
-basic form is simpler than the most elementary html. There is currently
-a syntax highlighter, and folding for Vim. Syntax highlighters for other
-editors are welcome.
-<p> Input files should be UTF-8
-<p> Once set up it is simple
-to use.
-<p> 6.1 ONLINE INFORMATION, PLACES TO LOOK
-<p> &lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-&gt;
-
-<p> Download Sources:
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU/download.html#current'>http://www.jus.uio.no/sisu/SiSU/download.html#current</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU/download.html#debian'>http://www.jus.uio.no/sisu/SiSU/download.html#debian</a>
-&gt;<br>
-
-<p> 6.2 INSTALLATION
-<p> NB. Platform is Unix / Linux.
-<p> 6.2.1 DEBIAN
-<p> If you use
-<b>Debian</b> use the <b>Debian</b> packages, check the information at:
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU/download.html#debian'>http://www.jus.uio.no/sisu/SiSU/download.html#debian</a>
-&gt;<br>
-
-<p> (A) <b>SiSU</b> is available directly off the <b>Debian</b> archives for Sid and testing.
-It should necessary only to run as root:
-<p> aptitude update<br>
-
-<p> aptitude install sisu-complete<br>
-
-<p> (B) If there are newer versions of <b>SiSU</b> upstream of the <b>Debian</b> archives,
-
-<p>they will be available by adding the following to your /etc/apt/sources.list
-
-<p> deb &lt;<a href='http://www.jus.uio.no/sisu/archive'>http://www.jus.uio.no/sisu/archive</a>
-&gt; unstable main non-free<br>
-
-<p> deb-src &lt;<a href='http://www.jus.uio.no/sisu/archive'>http://www.jus.uio.no/sisu/archive</a>
-&gt; unstable main non-free<br>
-
-<p> [the &nbsp;non-free &nbsp;line &nbsp;is &nbsp;for &nbsp;document &nbsp;markup &nbsp;samples, &nbsp;for &nbsp;which &nbsp;the &nbsp;substantive
-&nbsp;text &nbsp;is &nbsp;provided &nbsp;under &nbsp;the &nbsp;author &nbsp;or which original &nbsp;publisher&rsquo;s &nbsp;license
-&nbsp;and &nbsp;which &nbsp;in &nbsp;most &nbsp;cases &nbsp;will
-<p> Then as root run:
-<p> aptitude update<br>
-
-<p> aptitude install sisu-complete<br>
-
-<p> 6.2.2 RPM
-<p> RPMs are provided though untested, they are prepared by running
-alien against the source package, and against the debs.
-<p> They may be downloaded
-from:
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU/download.html#rpm'>http://www.jus.uio.no/sisu/SiSU/download.html#rpm</a>
-&gt;<br>
-
-<p> 6.2.3 SOURCE PACKAGE .TGZ
-<p> Otherwise to install <b>SiSU</b> from source, check
-information at:
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU/download.html#current'>http://www.jus.uio.no/sisu/SiSU/download.html#current</a>
-&gt;<br>
-
-<p> alternative modes of installation from source are provided, setup.rb
-(by Minero Aoki), rake (by Jim Weirich) built install file, rant (by Stefan
-Lang) built install file,
-<p> <b>Ruby</b> is the essential dependency for the basic
-
-<p>operation of <b>SiSU</b>
-<p> 1. Download the latest source (information available)
-from:
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU/download.html#current'>http://www.jus.uio.no/sisu/SiSU/download.html#current</a>
-&gt;<br>
-
-<p> 2. Unpack the source
-<p> Note however, that additional external package
-dependencies, such as texlive or postgresql should you desire to use it
-are not taken care of for you.
-<p> 6.2.4 TO USE SETUP.RB
-<p> this is a three step
-process, in the root directory of the unpacked <b>SiSU</b> as root type:
-<p> ruby
-setup.rb config<br>
-
-<p> ruby setup.rb setup<br>
-
-<p> as root:
-<p> ruby setup.rb install<br>
-
-<p> further information:
-<p> &lt;<a href='http://i.loveruby.net/en/projects/setup/'>http://i.loveruby.net/en/projects/setup/</a>
-&gt;<br>
-
-<p> &lt;<a href='http://i.loveruby.net/en/projects/setup/doc/usage.html'>http://i.loveruby.net/en/projects/setup/doc/usage.html</a>
-&gt;<br>
-
-<p> 6.2.5 TO USE INSTALL (PRAPARED WITH
-<p> Rake must be installed on your system:
-
-<p> &lt;<a href='http://rake.rubyforge.org/'>http://rake.rubyforge.org/</a>
-&gt;<br>
-
-<p> &lt;<a href='http://rubyforge.org/frs/?group_id=50'>http://rubyforge.org/frs/?group_id=50</a>
-&gt;<br>
-
-<p> in the root directory of the unpacked <b>SiSU</b> as root type:
-<p> rake<br>
-
-<p> or
-<p> rake base<br>
-
-<p> This makes use of Rake (by Jim Weirich) and the provided Rakefile
-<p>
-For a list of alternative actions you may type:
-<p> rake help<br>
-
-<p> rake -T<br>
-
-<p> 6.2.6 TO USE INSTALL (PRAPARED WITH
-<p> (you may use the instructions above
-for rake substituting rant if rant is installed on your system, or you
-may use an independent installer created using rant as follows:)
-<p> in the
-root directory of the unpacked <b>SiSU</b> as root type:
-<p> ruby ./sisu-install<br>
-
-<p> or
-<p> ruby ./sisu-install base<br>
-
-<p> This makes use of Rant (by Stefan Lang) and the provided Rantfile. It
-has been configured to do post installation setup setup configuration and
-generation of first test file. Note however, that additional external package
-dependencies, such as tetex-extra are not taken care of for you.
-<p> further
-information:
-<p> &lt;<a href='http://make.rubyforge.org/'>http://make.rubyforge.org/</a>
-&gt;<br>
-
-<p> &lt;<a href='http://rubyforge.org/frs/?group_id=615'>http://rubyforge.org/frs/?group_id=615</a>
-&gt;<br>
-
-<p> For a list of alternative actions you may type:
-<p> ruby ./sisu-install
-help<br>
-
-<p> ruby ./sisu-install -T<br>
-
-<p> 6.3 DEPENDENCIES
-<p> Once installed see &rsquo;man 8 sisu&rsquo; for some information
-on additional programs that sisu makes use of, and that you may need or
-wish to install. (this will depend on such factors as whether you want to
-generate pdf, whether you will be using <b>SiSU</b> with or without a database,
-...) &rsquo;man sisu_markup-samples&rsquo; may also be of interest if the sisu-markup-samples
-package has also been installed.
-<p> The information in man 8 may not be most
-up to date, and it is possible that more useful information can be gleaned
-from the following notes taken from the <b>Debian</b> control file (end edited),
-gives an idea of additional packages that <b>SiSU</b> can make use of if available,
-(the use/requirement of some of which are interdependent for specific actions
-by <b>SiSU</b> ).
-<p> The following is from the debian/control file of sisu-0.58.2,
-which amongst other things provides the dependencies of sisu within <b>Debian</b>
-
-<p>
-<p> <br>
-<pre> Package: sisu
- Architecture: all
- Depends: ruby (&gt;= 1.8.2), libwebrick-ruby, unzip, zip
- Conflicts: vim-sisu, sisu-vim, sisu-remote
- Replaces: vim-sisu, sisu-vim
- Recommends: sisu-pdf, sisu-sqlite, sisu-postgresql, librmagick-ruby, trang,
- tidy, librexml-ruby, openssl, rsync, openssh-client | lsh-client, keychain,
- hyperestraier, kdissert, vim-addon-manager
- Suggests: rcs | cvs, lv, texinfo, pinfo
- Package: sisu-complete
- Depends: ruby (&gt;= 1.8.4), sisu, sisu-pdf, sisu-postgresql, sisu-sqlite
- Recommends: hyperestraier
- Package: sisu-pdf
- Architecture: all
- Depends: sisu, texlive-latex-base, texlive-fonts-recommended,
- texlive-latex-recommended, texlive-latex-extra
- Suggests: evince, xpdf
- Package: sisu-postgresql
- Depends: sisu, postgresql-8.1, libdbi-ruby, libdbm-ruby, libdbd-pg-ruby
- Suggests: pgaccess, libdbd-pgsql, postgresql-contrib-8.1
- Package: sisu-sqlite
- Depends: sisu, sqlite, libdbi-ruby, libdbm-ruby, libdbd-sqlite-ruby
- Suggests: libdbd-sqlite
- Package: sisu-markup-samples
- Depends: sisu
-</pre>
-<p>
-<p> <br>
-<pre> Source: sisu
- Section: text
- Priority: optional
- Maintainer: Ralph Amissah &lt;ralph@amissah.com&gt;
- Build-Depends: debhelper (&gt;= 5)
- Standards-Version: 3.7.2
- Package: sisu
- Architecture: all
- Depends: ruby (&gt;= 1.8.2), libwebrick-ruby, unzip, zip
- Conflicts: vim-sisu, sisu-vim, sisu-remote
- Replaces: vim-sisu, sisu-vim
- Recommends: sisu-pdf, sisu-sqlite, sisu-postgresql, hyperestraier, keychain,
-librmagick-ruby, librexml-ruby, openssl, openssh-client | lsh-client, rsync,
-tidy, vim-addon-manager
- Suggests: kdissert, lv, rcs | cvs, pinfo, texinfo, trang
- Description: documents - structuring, publishing in multiple formats and
-search
- SiSU is a lightweight markup based, command line oriented, document
- structuring, publishing and search framework for document collections.
- .
- With minimal preparation of a plain-text, (UTF-8) file, using its native
- markup syntax in your text editor of choice, SiSU can generate various
- document formats (most of which share a common object numbering system
-for
- locating content), including plain text, HTML, XHTML, XML, OpenDocument
-text
- (ODF:ODT), LaTeX, PDF files, and populate an SQL database with objects
- (roughly paragraph-sized chunks) so searches may be performed and matches
- returned with that degree of granularity: your search criteria is met
-by these
- documents and at these locations within each document. Object numbering
-is
- particularly suitable for
- works that are frequently changed or updated) for which it provides
-a fixed
- means of reference of content. Document outputs also share semantic meta-data
- provided.
- .
- SiSU also provides concordance files, document content certificates
-and
- manifests of generated output.
- .
- A vim syntax highlighting file and an ftplugin with folds for sisu markup
-is
- provided, as are syntax highlighting files for kate, kwrite, gedit and
- diakonos. Vim 7 includes syntax highlighting for SiSU.
- .
- man pages, and interactive help are provided.
- .
- Dependencies for various features are taken care of in sisu related
-packages.
- The package sisu-complete installs the whole of SiSU.
- .
- Additional document markup samples are provided in the package
- sisu-markup-samples which is found in the non-free archive the licenses
-for
- the substantive content of the marked up documents provided is that
-provided
- by the author or original publisher.
- .
- Homepage: &lt;http://www.jus.uio.no/sisu&gt;
-</pre>
-<p>
-<p> <br>
-<pre> Package: sisu-complete
- Architecture: all
- Depends: ruby (&gt;= 1.8.2), sisu, sisu-pdf, sisu-postgresql, sisu-sqlite
- Recommends: hyperestraier
- Description: installs all SiSU related packages
- This package installs SiSU and related packages that enable sisu to
-produce
- pdf and to populate postgresql and sqlite databases.
- .
- SiSU is a lightweight markup based document publishing framework.
- .
- See sisu for a description of the package.
- .
- Homepage: &lt;http://www.jus.uio.no/sisu&gt;
-</pre>
-<p>
-<p> <br>
-<pre> Package: sisu-pdf
- Architecture: all
- Depends: sisu, texlive-latex-base, texlive-fonts-recommended, texlive-latex-recommended,
-texlive-latex-extra
- #Suggests: evince, xpdf
- Description: dependencies to convert SiSU LaTeX output to pdf
- This package enables the conversion of SiSU LaTeX output to pdf.
- .
- SiSU is a lightweight markup based document publishing framework.
- .
- Homepage: &lt;http://www.jus.uio.no/sisu&gt;
-</pre>
-<p>
-<p> <br>
-<pre> Package: sisu-postgresql
- Architecture: all
- Depends: sisu, libdbd-pg-ruby, libdbi-ruby, libdbm-ruby, postgresql
- Recommends: libfcgi-ruby
- Suggests: postgresql-contrib
- Description: SiSU dependencies for use with postgresql database
- This package enables SiSU to populate a postgresql database. This is
-done at
- an object/paragraph level, making granular searches of documents possible.
- .
- This relational database feature of SiSU is not required but provides
- interesting possibilities, including that of granular searches of documents
- for matching units of text, primarily paragraphs that can be displayed
-or
- identified by object citation number, from which an index of documents
- matched and each matched paragraph within them can be displayed.
- .
- SiSU is a lightweight markup based document publishing framework.
- .
- Homepage: &lt;http://www.jus.uio.no/sisu&gt;
-</pre>
-<p>
-<p> <br>
-<pre> Package: sisu-sqlite
- Architecture: all
- Depends: sisu, sqlite, libdbd-sqlite-ruby, libdbi-ruby, libdbm-ruby
- Recommends: libfcgi-ruby
- Description: SiSU dependencies for use with sqlite database
- This package enables SiSU to populate an sqlite database. This is done
-at an
- object/paragraph level, making granular searches of documents possible.
- .
- This relational database feature of SiSU is not required but provides
- interesting possibilities, including that of granular searches of documents
- for matching units of text, primarily paragraphs that can be displayed
-or
- identified by object citation number, from which an index of documents
- matched and each matched paragraph within them can be displayed.
- .
- SiSU is a lightweight markup based document publishing framework.
- .
- Homepage: &lt;http://www.jus.uio.no/sisu&gt;
-</pre>
-<p> 6.4 QUICK START
-<p> Most of the installation should be taken care of by the
-aptitude or rant install. (The rant install if run in full will also test
-run the generation of the first document).
-<p> After installation of sisu-complete,
-
-<p>move to the document samples directory
-<p> cd /usr/share/doc/sisu/sisu_markup_samples/dfsg<br>
-
-<p> and run
-<p> sisu -3 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
-<p> or to generate an online document
-move to a writable directory, as the file will be downloaded there and
-e.g.
-<p> sisu -3 &lt;<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>
-&gt;
-
-<p> the database stuff is extra perhaps, the latex stuff could be considered
-
-<p>extra perhaps but neither needs to be installed for most of sisu output
-
-<p>to work
-<p> examine source document, vim has syntax support
-<p> gvim free_as_in_freedom.rms_and_free_software.sam_williams.sst
-
-<p> additional markup samples in
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a>
-&gt;<br>
-
-<p> For help
-<p> man sisu<br>
-
-<p> or
-<p> sisu --help<br>
-
-<p> e.g.
-<p> for the way sisu
-<p> sisu --help env<br>
-
-<p> for list of commands and so on
-<p> sisu --help commands<br>
-
-<p> 6.5 CONFIGURATION FILES
-<p> The default configuration/setup is contained
-
-<p>within the program and is altered by configuration settings in <i>etc</i> [sisu
-
-<p>&nbsp;version]/sisurc.yml or in ~/.sisu/sisurc.yml
-<p> * configuration file - a yaml
-
-<p>file
-<p> /etc/sisu/[sisu &nbsp;version]/sisurc.yml<br>
-
-<p> ~/.sisu/sisurc.yml<br>
-
-<p> * directory structure - setting up of output and working directory.
-<p>
-* skins - changing the appearance of a project, directory or individual
-
-<p>documents within ~/.sisu/skin
-<p> ~/.sisu/skin/doc contains individual skins,
-with symbolic links from<br>
-
-<p> ~/.sisu/skin/dir if the contents of a directory are to take a particular<br>
- document skin.<br>
-
-<p> * additional software - eg. Tex and LaTeX (tetex, tetex-base, tetex-extra
-on <b>Debian</b> ), Postgresql, &nbsp;[sqlite], trang, tidy, makeinfo, ... none of which
-are required for basic html or XML processing.
-<p> * if you use Vim as editor
-there is a syntax highlighter and fold resource config file for <b>SiSU</b> <i>hope</i>
-more syntax highlighters follow.
-<p> There are post installation steps (which
-are really part of the overall installation)
-<p> sisu -C in your marked up
-document directory, should do some auto-configuring provided you have the
-right permissions for the output directories. (and provided the output directories
-have already been specified if you are not using the defaults).
-<p> 6.6 USE
-
-<p>GENERAL OVERVIEW
-<p> Documents are marked up in <b>SiSU</b> syntax and kept in an
-ordinary text editable file, named with the suffix .sst, or .ssm
-<p> Marked
-
-<p>up <b>SiSU</b> documents are usually kept in a sub-directory of your choosing
-<p>
- use the interactive help and man pages
-<p> sisu --help<br>
-
-<p> man sisu<br>
-
-<p> 6.7 HELP
-<p> interactive help described below, or man page:
-<p> man sisu<br>
-
-<p> man 8 sisu<br>
-
-<p> &rsquo;man sisu_markup-samples&rsquo; &nbsp;[if &nbsp;the &nbsp;sisu-markup-samples &nbsp;package &nbsp;is &nbsp;also &nbsp;installed]
-
-<p> Once installed an interactive help is available typing &rsquo;sisu&rsquo; (without)
-any flags, and select an option:
-<p> sisu<br>
-
-<p> alternatively, you could type e.g.
-<p> sisu --help commands<br>
-
-<p> sisu --help env<br>
-
-<p> sisu --help headers<br>
-
-<p> sisu --help markup<br>
-
-<p> sisu --help headings<br>
-
-<p> etc.
-<p> for questions about mappings, output paths etc.
-<p> sisu --help env<br>
-
-<p> sisu --help path<br>
-
-<p> sisu --help directory<br>
-
-<p> 6.8 DIRECTORY STRUCTURE
-<p> Once installed, type:
-<p> sisu --help env<br>
-
-<p> or
-<p> sisu -V<br>
-
-<p> 6.9 CONFIGURATION FILE
-<p> The defaults can be changed via <b>SiSU</b> &rsquo;s configure
-file sisurc.yml which the program expects to find in ./_sisu ~/.sisu or /etc/sisu
-(searched in that order, stopping on the first one found)
-<p> 6.10 MARKUP
-<p>
- See man pages.
-<p> man sisu<br>
-
-<p> man 8 sisu<br>
-
-<p> Once installed there is some information on <b>SiSU</b> Markup in its help:
-
-<p> sisu --help markup<br>
-
-<p> and
-<p> sisu --help headers<br>
-
-<p> Sample marked up document are provided with the download tarball in
-the directory:
-<p> ./data/doc/sisu/sisu_markup_samples/dfsg<br>
-
-<p> These are installed on the system usually at:
-<p> /usr/share/doc/sisu/sisu_markup_samples/dfsg<br>
-
-<p> More markup samples are available in the package sisu-markup-samples
-<p>
- &lt;<a href='http://www.jus.uio.no/sisu/SiSU/download.html#sisu-markup-samples'>http://www.jus.uio.no/sisu/SiSU/download.html#sisu-markup-samples</a>
-&gt;<br>
-
-<p> Many more are available online off:
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a>
-&gt;<br>
-
-<p> 6.11 ADDITIONAL THINGS
-<p> There is syntax support for some editors provided
-(together with a README file) in
-<p> ./data/sisu/conf/syntax<br>
-
-<p> usually installed to:
-<p> /usr/share/sisu/conf/syntax<br>
-
-<p> 6.12 LICENSE
-<p> License: GPL 3 or later see the copyright file in
-<p> ./data/doc/sisu<br>
-
-<p> usually installed to:
-<p> /usr/share/doc/sisu<br>
-
-<p> 6.13 SISU STANDARD
-<p> <b>SiSU</b> uses:
-<p> * Standard <b>SiSU</b> markup syntax,
-<p> * Standard
-<b>SiSU</b> meta-markup syntax, and the
-<p> * Standard <b>SiSU</b> object citation numbering
-
-<p>and system
-<p> �&copy; Ralph Amissah 1997, current 2006 All Rights Reserved.
-<p> *
-
-<p>however note the License section
-<p> CHANGELOG
-<p> ./CHANGELOG<br>
-
-<p> and see
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU/changelog.html'>http://www.jus.uio.no/sisu/SiSU/changelog.html</a>
-&gt;<br>
-
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU/changelog_markup_samples.html'>http://www.jus.uio.no/sisu/SiSU/changelog_markup_samples.html</a>
-&gt;<br>
-
-<p> EXTRACTS FROM MAN 8 SISU
-<p> 7. POST INSTALLATION SETUP
-<p> 7.1 POST INSTALLATION
-SETUP - QUICK START
-<p> After installation of sisu-complete, move to the document
-samples directory,
-<p> cd /usr/share/doc/sisu/sisu_markup_samples/dfsg<br>
-
-<p> [this &nbsp;is &nbsp;not &nbsp;where &nbsp;you &nbsp;would &nbsp;normally &nbsp;work &nbsp;but &nbsp;provides sample &nbsp;documents
-&nbsp;for &nbsp;testing, &nbsp;you &nbsp;may &nbsp;prefer &nbsp;instead &nbsp;to &nbsp;copy &nbsp;the &nbsp;contents &nbsp;of &nbsp;that &nbsp;directory
-&nbsp;to &nbsp;a &nbsp;local &nbsp;directory &nbsp;before &nbsp;proceeding]
-<p> and in that directory, initialise
-
-<p>the output directory with the command
-<p> sisu -CC<br>
-
-<p> then 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
-<p> for an overview of your current sisu
-setup, type:
-<p> sisu --help env<br>
-
-<p> or
-<p> sisu -V<br>
-
-<p> 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.
-<p> sisu -1 &lt;<a href='http://www.jus.uio.no/sisu/gpl3.fsf/gpl3.fsf.sst'>http://www.jus.uio.no/sisu/gpl3.fsf/gpl3.fsf.sst</a>
-&gt;<br>
-
-<p> sisu -3<br>
- &lt;<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>
-&gt;<br>
-
-<p> examine source document, vim has syntax highlighting support
-<p> gvim
-
-<p>free_as_in_freedom.rms_and_free_software.sam_williams.sst
-<p> additional markup
-
-<p>samples in
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a>
-&gt;<br>
-
-<p> it should also be possible to run sisu against sisupods (prepared zip
-files, created by running the command sisu -S &nbsp;[filename]), whether stored
-locally or remotely.
-<p> sisu -3<br>
- &lt;<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>
-&gt;<br>
-
-<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> sisu -3 --trust<br>
- &lt;<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>
-&gt;<br>
-
-<p> For help
-<p> man sisu<br>
-
-<p> sisu --help<br>
-
-<p> sisu --help env for the way sisu<br>
-
-<p> sisu --help commands for list of commands and so on<br>
-
-<p> 7.2 DOCUMENT MARKUP DIRECTORY
-<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:
-<p> mkdir ~/sisu_test<br>
-
-<p> cd ~/sisu_test<br>
-
-<p> cp -a /usr/share/doc/sisu/sisu_markup_samples/dfsg/* ~/sisu_test/.<br>
-
-<p> <b>Tip:</b> the markup syntax examples may be of interest
-<p> &lt;<a href='http://www.jus.uio.no/sisu/sample/'>http://www.jus.uio.no/sisu/sample/</a>
-&gt;<br>
-
-<p> <b>Tip:</b>
-<p> sisu -U &nbsp;[sisu &nbsp;markup &nbsp;filename]<br>
-
-<p> should printout the different possible outputs and where sisu would
-place them.
-<p> <b>Tip:</b> if you want to toggle ansi color add
-<p> c<br>
-
-<p> to your flags.
-<p> 7.2.1 CONFIGURATION FILES
-<p> <b>SiSU</b> configuration file search
-path is:
-<p> ./_sisu/sisurc.yaml<br>
-
-<p> ~/.sisu/sisurc.yaml<br>
-
-<p> /etc/sisu/sisurc.yaml<br>
-
-<p> <b>Debian</b> Installation Note
-<p> 7.2.2 DEBIAN INSTALLATION NOTE
-<p> It is best
-
-<p>you see
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU/download.html#debian'>http://www.jus.uio.no/sisu/SiSU/download.html#debian</a>
-&gt;<br>
-
-<p> for up the most up to date information.
-<p> notes taken from the <b>Debian</b>
-control file (end edited), gives an idea of additional packages that <b>SiSU</b>
-can make use of if available, (the use/requirement of some of which are
-interdependent for specific actions by <b>SiSU</b> ):
-<p> Package: sisu
-<p> <b>SiSU</b> is
-a lightweight markup based, command line oriented, document structuring,
-publishing and search framework for document collections.
-<p> With minimal
-preparation of a plain-text, (UTF-8) file, using its native markup syntax
-in your text editor of choice, <b>SiSU</b> can generate various document formats
-(most of which share a common object numbering system for locating content),
-including plain text, HTML, XHTML, XML, OpenDocument text (ODF:ODT), LaTeX,
-PDF files, and populate an SQL database with objects (roughly paragraph-sized
-chunks) so searches may be performed and matches returned with that degree
-of granularity: your search criteria is met by these documents and at these
-locations within each document. Object numbering is particularly suitable
-for opposed to works that are frequently changed or updated) for which
-it provides a fixed means of reference of content. Document outputs also
-share semantic meta-data provided.
-<p> <b>SiSU</b> also provides concordance files,
-document content certificates and manifests of generated output.
-<p> A vim
-syntax highlighting file and an ftplugin with folds for sisu markup is
-provided, as are syntax highlighting files for kate, kwrite, gedit and
-diakonos. Vim 7 includes syntax highlighting for <b>SiSU</b>
-<p> man pages, and
-interactive help are provided.
-<p> Dependencies for various features are taken
-care of in sisu related packages. The package sisu-complete installs the
-whole of <b>SiSU</b>
-<p> Additional document markup samples are provided in the
-package sisu-markup-samples which is found in the non-free archive the licenses
-for the substantive content of the marked up documents provided is that
-provided by the author or original publisher.
-<p> Homepage: &lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-&gt;
-
-<p> 7.2.3 DOCUMENT RESOURCE CONFIGURATION
-<p> <b>sisu</b> resource configuration information
-is obtained from sources (where they exist):
-<p> ~/.sisu/sisurc.yaml<br>
-
-<p> /etc/sisu/[sisu &nbsp;version]/sisurc.yaml<br>
-
-<p> sisu program defaults<br>
-
-<p> 7.2.4 SKINS
-<p> <b>Skins</b> default document appearance may be modified using skins
-contained in sub-directories located at the following paths:
-<p> ./_sisu/skin<br>
-
-<p> ~/.sisu/skin<br>
-
-<p> /etc/sisu/skin<br>
-
-<p> more specifically, the following locations (or their /etc/sisu equivalent)
-should be used:
-<p> ~/.sisu/skin/doc<br>
-
-<p> skins for individual documents;
-<p> ~/.sisu/skin/dir<br>
-
-<p> skins for directories of matching names;
-<p> ~/.sisu/skin/site<br>
-
-<p> site-wide skin modifying the site-wide appearance of documents.
-<p> Usually
-all skin files are placed in the document skin directory:
-<p> ~/.sisu/skin/doc<br>
-
-<p> with softlinks being made to the skins contained there from other skin
-directories as required.
-<p> DOCUMENT INFORMATION (METADATA)
-<p> METADATA
-<p>
-Document Manifest @ &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/sisu_manifest.html</a>
-&gt;
-
-<p> <b>Dublin Core</b> (DC)
-<p> <i>DC</i> tags included with this document are provided here.
-
-<p> DC Title: <i>SiSU</i> - Technical, Howto
-<p> DC Creator: <i>Ralph</i> Amissah
-<p> DC Rights:
-<i>Copyright</i> (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-
-<p>3
-<p> DC Type: <i>information</i>
-<p> DC Date created: <i>2002-11-12</i>
-<p> DC Date issued:
-
-<p><i>2002-11-12</i>
-<p> DC Date available: <i>2002-11-12</i>
-<p> DC Date modified: <i>2007-09-16</i>
-<p> DC
-Date: <i>2007-09-16</i>
-<p> <b>Version Information</b>
-<p> Sourcefile: <i>sisu_howto.sst</i>
-<p> Filetype:
-
-<p><i>SiSU</i> text insert 0.57
-<p> Sourcefile Digest, MD5(sisu_howto.sst)= <i>bb17770a0fa5b4ef035ebf0bcfca3faa</i>
-
-<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-
-<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i>
-<p> <b>Generated</b>
-<p> Document (metaverse) last
-generated: <i>Mon</i> Sep 24 15:36:16 +0100 2007
-<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of
-2007w38/0 (2007-09-23)
-<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36)
-&nbsp;[i486-linux]
-<p>
-<ol>
-<b>.</b><li>generated from source using rman &lt;<a href='http://polyglotman.sourceforge.net/rman.html'>http://polyglotman.sourceforge.net/rman.html</a>
-&gt;<br>
- With regard to<br>
- <b>SiSU</b> man pages the formatting generated for markup syntax is not quite
-right, for that you might prefer the links under: &lt;<a href='http://www.jus.uio.no/sample'>http://www.jus.uio.no/sample</a>
-&gt;<br>
- </li><b>.</b><li>&lt;<a href='http://www.jus.uio.no/sisu/man/'>http://www.jus.uio.no/sisu/man/</a>
-&gt; </li><b>.</b><li>&lt;<a href='http://www.jus.uio.no/sisu/man/sisu.1.html'>http://www.jus.uio.no/sisu/man/sisu.1.html</a>
-&gt; </li><b>.</b><li>&lt;<a href='http://www.jus.uio.no/sisu/man/sisu.8.html'>http://www.jus.uio.no/sisu/man/sisu.8.html</a>
-&gt;
-</li><b>.</b><li>&lt;<a href='http://www.jus.uio.no/sisu/man/sisu_examples.1.html'>http://www.jus.uio.no/sisu/man/sisu_examples.1.html</a>
-&gt; </li><b>.</b><li>&lt;<a href='http://www.jus.uio.no/sisu/man/sisu_webrick.1.html'>http://www.jus.uio.no/sisu/man/sisu_webrick.1.html</a>
-&gt;
-</li><b>.</b><li>this is an endnote </li><b>.</b><li>&lt;<a href='http://sisudoc.org'>http://sisudoc.org</a>
-&gt; </li><b>.</b><li>&lt;<a href='http://sisudoc.org'>http://sisudoc.org</a>
-&gt;
-<p> </dd>
-
-<dt>Other versions
-of this document: </dt>
-<dd></dd>
-
-<dt>manifest: &lt;<a href='http://www.jus.uio.no/sisu/sisu_howto/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_howto/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_howto/sisu_manifest.html</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>html: &lt;<a href='http://www.jus.uio.no/sisu/sisu_howto/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_howto/toc.html'>http://www.jus.uio.no/sisu/sisu_howto/toc.html</a>
-</a>
-&gt; </dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_howto/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_howto/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_howto/portrait.pdf</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_howto/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_howto/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_howto/landscape.pdf</a>
-</a>
-&gt; </dt>
-<dd> </dd>
-
-<dt>at: &lt;<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt>
-<dd></dd>
-
-<dt>* Ruby version: ruby
-1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt>
-<dd></dd>
-
-<dt>* Last Generated on: Mon Sep 24
-15:36:31 +0100 2007 </dt>
-<dd></dd>
-
-<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
- </dt>
-<dd></dd>
-</dl>
-<p>
-</body>
-</html>
diff --git a/data/doc/sisu/html/sisu_markup.1.html b/data/doc/sisu/html/sisu_markup.1.html
deleted file mode 100644
index 3be61258..00000000
--- a/data/doc/sisu/html/sisu_markup.1.html
+++ /dev/null
@@ -1,1113 +0,0 @@
-<!-- manual page source format generated by PolyglotMan v3.2, -->
-<!-- available at http://polyglotman.sourceforge.net/ -->
-
-<html>
-<head>
-<title>"sisu_markup"("1") manual page</title>
-</head>
-<body bgcolor='white'>
-<a href='#toc'>Table of Contents</a><p>
-SISU - MARKUP, RALPH AMISSAH
-<p> SISU MARKUP
-<p> 1. INTRODUCTION TO SISU MARKUP[^1]
-
-<p> 1.1 SUMMARY
-<p> <b>SiSU</b> source documents are plaintext (UTF-8)[^2] files
-<p> All
-paragraphs are separated by an empty line.
-<p> Markup is comprised of:
-<p> *
-at the top of a document, the document header made up of semantic meta-data
-about the document and if desired additional processing instructions (such
-an instruction to automatically number headings from a particular level
-down)
-<p> * followed by the prepared substantive text of which the most important
-single characteristic is the markup of different heading levels, which
-define the primary outline of the document structure. Markup of substantive
-text includes:
-<p> * heading levels defines document structure<br>
-
-<p> * text basic attributes, italics, bold etc.<br>
-
-<p> * grouped text (objects), which are to be treated differently, such
-as code<br>
- blocks or poems.<br>
-
-<p> * footnotes/endnotes<br>
-
-<p> * linked text and images<br>
-
-<p> * paragraph actions, such as indent, bulleted, numbered-lists, etc.<br>
-
-<p> Some interactive help on markup is available, by typing sisu and selecting
-
-<p>markup or sisu --help markup
-<p> 1.2 MARKUP EXAMPLES
-<p> 1.2.1 ONLINE
-<p> Online markup
-examples are available together with the respective outputs produced from
-&lt;<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a>
-&gt; or from &lt;<a href='http://www.jus.uio.no/sisu/sisu_examples/'>http://www.jus.uio.no/sisu/sisu_examples/</a>
-&gt;
-
-<p> There is of course this document, which provides a cursory overview of
-sisu markup and the respective output produced: &lt;<a href='http://www.jus.uio.no/sisu/sisu_markup/'>http://www.jus.uio.no/sisu/sisu_markup/</a>
-&gt;
-
-<p> Some example marked up files are available as html with syntax highlighting
-for viewing: &lt;<a href='http://www.jus.uio.no/sisu/sample/syntax'>http://www.jus.uio.no/sisu/sample/syntax</a>
-&gt;
-<p> an alternative presentation
-of markup syntax: &lt;<a href='http://www.jus.uio.no/sisu/sample/on_markup.txt'>http://www.jus.uio.no/sisu/sample/on_markup.txt</a>
-&gt;
-<p> 1.2.2 INSTALLED
-
-<p> With <b>SiSU</b> installed sample skins may be found in: /usr/share/doc/sisu/sisu_markup_samples/dfsg
-(or equivalent directory) and if sisu-markup-samples is installed also under:
-
-<p>/usr/share/doc/sisu/sisu_markup_samples/non-free
-<p> 2. MARKUP OF HEADERS
-<p>
- Headers consist of semantic meta-data about a document, which can be used
-by any output module of the program; and may in addition include extra
-processing instructions.
-<p> Note: the first line of a document may include
-information on the markup version used in the form of a comment. Comments
-are a percentage mark at the start of a paragraph (and as the first character
-in a line of text) followed by a space and the comment:
-<p>
-<p> <br>
-<pre> % this would be a comment
-</pre>
-<p> 2.1 SAMPLE HEADER
-<p> This current document has a header similar to this
-one (without the comments):
-<p>
-<p> <br>
-<pre> % SiSU 0.57
- @title: SiSU
- @subtitle: Markup
- @creator: Ralph Amissah
- @rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation,
-License GPL 3
- @type: information
- @subject: ebook, epublishing, electronic book, electronic publishing,
-electronic document, electronic citation, data structure, citation systems,
-search
- @date.created: 2002-08-28
- @date.issued: 2002-08-28
- @date.available: 2002-08-28
- @date.modified: 2007-09-16
- @date: 2007-09-16
- @level: new=C; break=1; num_top=1
- % comment: in this @level header num_top=1 starts automatic heading numbering
-at heading level 1 (numbering continues 3 levels down); the new and break
-instructions are used by the LaTeX/pdf and odf output to determine where
-to put page breaks (that are not used by html output or say sql database
-population).
- @skin: skin_sisu_manual
- % skins modify the appearance of a document and are placed in a sub-directory
-under ./_sisu/skin ~/.sisu/skin or /etc/sisu/skin. A skin may affect single
-documents that request them, all documents in a directory, or be site-wide.
-(A document is affected by a single skin)
- @bold: /Gnu|Debian|Ruby|SiSU/
- @links: { SiSU Manual }http://www.jus.uio.no/sisu/sisu_manual/
- { Book Samples and Markup Examples }http://www.jus.uio.no/sisu/SiSU/2.html
- { SiSU @ Wikipedia }http://en.wikipedia.org/wiki/SiSU
- { SiSU @ Freshmeat }http://freshmeat.net/projects/sisu/
- { SiSU @ Ruby Application Archive }http://raa.ruby-lang.org/project/sisu/
- { SiSU @ Debian }http://packages.qa.debian.org/s/sisu.html
- { SiSU Download }http://www.jus.uio.no/sisu/SiSU/download.html
- { SiSU Changelog }http://www.jus.uio.no/sisu/SiSU/changelog.html
-</pre>
-<p> 2.2 AVAILABLE HEADERS
-<p> Header tags appear at the beginning of a document
-and provide meta information on the document (such as the Dublin Core),
-or information as to how the document as a whole is to be processed. All
-header instructions take either the form @headername: or 0~headername. All
-
-<p>Dublin Core meta tags are available
-<p> <b>@indentifier:</b> information or instructions
-
-<p> where the information
-<p> Note: a header where used should only be used
-once; all headers apart from @title: are optional; the @structure: header
-is used to describe document structure, and can be useful to know.
-<p> This
-
-<p>is a sample header
-<p> <b>% SiSU 0.38</b> &nbsp;[declared &nbsp;file-type &nbsp;identifier &nbsp;with &nbsp;markup
-&nbsp;version]
-<p> <b>@title:</b> &nbsp;[title &nbsp;text] This is the title of the document and used
-as such, this header is the only one that is <i>mandatory</i>
-<p> <b>@subtitle:</b> The
-
-<p>Subtitle if any
-<p> <b>@creator:</b> &nbsp;[or &nbsp;@author:] Name of Author
-<p> <b>@subject:</b> (whatever
-your subject)
-<p> <b>@description:</b>
-<p> <b>@publisher:</b>
-<p> <b>@contributor:</b>
-<p> <b>@translator:</b>
-&nbsp;[or &nbsp;@translated_by:]
-<p> <b>@illustrator:</b> &nbsp;[or &nbsp;@illustrated_by:]
-<p> <b>@prepared_by:</b>
-&nbsp;[or &nbsp;@digitized_by:]
-<p> <b>@date: 2000-08-27</b> &nbsp;[ &nbsp;also &nbsp;@date.created: &nbsp;@date.issued:
-&nbsp;@date.available: &nbsp;@date.valid: &nbsp;@date.modified: &nbsp;]
-<p> <b>@type: article</b>
-<p> <b>@format:</b>
-
-<p> <b>@identifier:</b>
-<p> <b>@source:</b>
-<p> <b>@language:</b> &nbsp;[or &nbsp;@language.document:] &nbsp;[country
-&nbsp;code &nbsp;for &nbsp;language &nbsp;if available, &nbsp;or &nbsp;language, &nbsp;English, &nbsp;en &nbsp;is &nbsp;the &nbsp;default
-&nbsp;setting] (en - English, fr - French, de - German, it - Italian, es - Spanish,
-pt - Portuguese, sv - Swedish, da - Danish, fi - Finnish, no - Norwegian, is
-- Icelandic, nl - Dutch, et - Estonian, hu - Hungarian, pl - Polish, ro - Romanian,
-ru - Russian, el - Greek, uk - Ukranian, tr - Turkish, sk - Slovak, sl - Slovenian,
-hr - Croatian, cs - Czech, bg - Bul garian ) [however, &nbsp;encodings &nbsp;are &nbsp;not &nbsp;available
-&nbsp;for &nbsp;all &nbsp;of &nbsp;the languages &nbsp;listed.]
-<p> [@language.original: &nbsp;original &nbsp;language
-&nbsp;in &nbsp;which &nbsp;the &nbsp;work &nbsp;was published]
-<p> <b>@papersize:</b> (A4|US_letter|book_B5|book_A5|US_legal)
-
-<p> <b>@relation:</b>
-<p> <b>@coverage:</b>
-<p> <b>@rights:</b> Copyright (c) Name of Right Holder,
-all rights reserved, or as granted: public domain, copyleft, creative commons
-variant, etc.
-<p> <b>@owner:</b>
-<p> <b>@keywords:</b> text document generation processing
-management latex pdf structured xml citation &nbsp;[your &nbsp;keywords &nbsp;here, &nbsp;used
-&nbsp;for &nbsp;example &nbsp;by &nbsp;rss &nbsp;feeds, &nbsp;and &nbsp;in &nbsp;sql &nbsp;searches]
-<p> <b>@abstract:</b> &nbsp;[paper &nbsp;abstract,
-&nbsp;placed &nbsp;after &nbsp;table &nbsp;of &nbsp;contents]
-<p> <b>@comment:</b> &nbsp;[...]
-<p> <b>@catalogue:</b> loc=[Library
-&nbsp;of &nbsp;Congress &nbsp;classification]; dewey=[Dewey &nbsp;rss &nbsp;feeds, classification]; isbn=[ISBN];
-pg=[Project &nbsp;Gutenberg &nbsp;text &nbsp;number]
-<p> <b>@classify_loc:</b> &nbsp;[Library &nbsp;of &nbsp;Congress
-&nbsp;classification]
-<p> <b>@classify_dewey:</b> &nbsp;[Dewey &nbsp;classification]
-<p> <b>@classify_isbn:</b>
-&nbsp;[ISBN]
-<p> <b>@classify_pg:</b> &nbsp;[Project &nbsp;Gutenberg &nbsp;text &nbsp;number]
-<p> <b>@prefix:</b> &nbsp;[prefix
-&nbsp;is &nbsp;placed &nbsp;just &nbsp;after &nbsp;table &nbsp;of &nbsp;contents]
-<p> <b>@prefix_a:</b> &nbsp;[prefix &nbsp;is &nbsp;placed
-&nbsp;just &nbsp;before &nbsp;table &nbsp;of &nbsp;contents &nbsp;- &nbsp;not implemented]
-<p> <b>@prefix_b:</b>
-<p> <b>@rcs:</b> $Id:
-sisu_markup.sst,v 1.2 2007/09/08 17:12:47 ralph Exp $ &nbsp;[used &nbsp;by &nbsp;rcs &nbsp;or &nbsp;cvs
-&nbsp;to &nbsp;embed &nbsp;version &nbsp;(revision &nbsp;control) &nbsp;information &nbsp;into under ./_sisu/skin
-~/.sisu/skin or /etc/sisu/skin. A skin may affect single documents that request
-them, all documents in a directory, or be site-wide. (A document is affected
-by a single skin) document, &nbsp;rcs &nbsp;or &nbsp;cvs &nbsp;can &nbsp;usefully &nbsp;provide &nbsp;a &nbsp;history &nbsp;of
-under ./_sisu/skin ~/.sisu/skin or /etc/sisu/skin. A skin may affect single
-documents that request them, all documents in a directory, or be site-wide.
-(A document is affected by a single skin) updates &nbsp;to &nbsp;a &nbsp;document &nbsp;]
-<p> <b>@structure:</b>
-PART; CHAPTER; SECTION; ARTICLE; none; none; optional, document structure
-can be defined by words to match or regular expression (the regular expression
-is assumed to start at the beginning of a line of text i.e. ^) default markers
-:A~ to :C~ and 1~ to 6~ can be used within text instead, without this header
-tag, and may be used to supplement the instructions provided in this header
-tag if provided (@structure: is a synonym for @toc:)
-<p> <b>@level:</b> newpage=3;
-breakpage=4 &nbsp;[paragraph &nbsp;level, &nbsp;used &nbsp;by &nbsp;latex &nbsp;to &nbsp;breakpages, &nbsp;the &nbsp;page &nbsp;in
-&nbsp;newpage]
-<p> <b>@markup:</b> information on the markup used, e.g. new=1,2,3; break=4;
-num_top=4 &nbsp;[or newpage=1,2,3; &nbsp;breakpage=4; &nbsp;num_top=4] newpage and breakpage,
-heading level, used by LaTeX to breakpages. breakpage: starts on a new page
-in single column text and on a new column in double column text; newpage:
-starts on a new page for both single and double column texts. num_top=4
-&nbsp;[auto-number &nbsp;document, &nbsp;starting &nbsp;at &nbsp;level &nbsp;4. &nbsp;the new default &nbsp;is &nbsp;to &nbsp;provide
-&nbsp;3 &nbsp;levels, &nbsp;as &nbsp;in &nbsp;1 &nbsp;level &nbsp;4, &nbsp;1.1 &nbsp;1.1.1 &nbsp;level &nbsp;6, &nbsp;markup &nbsp;to &nbsp;be &nbsp;merged &nbsp;within &nbsp;level]
-num_extract &nbsp;[take &nbsp;numbering &nbsp;of &nbsp;headings &nbsp;provided &nbsp;(manually &nbsp;in &nbsp;and &nbsp;use
-&nbsp;for &nbsp;numbering &nbsp;of &nbsp;Available &nbsp;where &nbsp;a &nbsp;clear &nbsp;numbering &nbsp;structure &nbsp;is &nbsp;without
-&nbsp;the &nbsp;repetition &nbsp;of &nbsp;a &nbsp;number in &nbsp;a &nbsp;header.] &nbsp;[In &nbsp;0.38 &nbsp;notation, &nbsp;you &nbsp;would &nbsp;map
-&nbsp;to &nbsp;the equivalent &nbsp;levels, &nbsp;the &nbsp;examples &nbsp;provided &nbsp;would &nbsp;map &nbsp;to &nbsp;the following
-&nbsp;new=A,B,C; &nbsp;break=1; &nbsp;num_top=1 &nbsp;&nbsp;[or &nbsp;newpage=A,B,C; breakpage=1; &nbsp;num_top=1]
-see headings]
-<p> <b>@bold:</b> &nbsp;[regular &nbsp;expression &nbsp;of &nbsp;words/phrases &nbsp;to &nbsp;be &nbsp;made
-&nbsp;bold]
-<p> <b>@italics:</b> &nbsp;[regular &nbsp;expression &nbsp;of &nbsp;words/phrases &nbsp;to &nbsp;italicise]
-<p>
-<b>@vocabulary:</b> name of taxonomy/vocabulary/wordlist to use against document
-
-<p> <b>@skin:</b> skin_doc_[name_of_desired_document_skin] skins change default
-settings related to the appearance of documents generated, such as the
-urls of the home site, and the icon/logo for the document or site.
-<p> <b>@links:</b>
-{ <b>SiSU</b> }<a href='http://www.jus.uio.no/sisu/;'>http://www.jus.uio.no/sisu/;</a>
- { FSF }<a href='http://www.fsf.org'>http://www.fsf.org</a>
-
-<p> <b>@promo:</b> sisu,
-ruby, search_libre_docs, open_society &nbsp;[places &nbsp;content &nbsp;in &nbsp;right &nbsp;pane &nbsp;in
-&nbsp;html, &nbsp;makes &nbsp;use &nbsp;of list.yml &nbsp;and &nbsp;promo.yml, &nbsp;commented &nbsp;out &nbsp;sample &nbsp;in &nbsp;document
-sample: and &nbsp;promo.yml, &nbsp;commented &nbsp;out &nbsp;sample &nbsp;in &nbsp;document free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst]
-
-<p> 3. MARKUP OF SUBSTANTIVE TEXT
-<p> 3.1 HEADING LEVELS
-<p> Heading levels are
-:A~ ,:B~ ,:C~ ,1~ ,2~ ,3~ ... :A - :C being part / section headings, followed
-by other heading levels, and 1 -6 being headings followed by substantive
-text or sub-headings. :A~ usually the title :A~? conditional level 1 heading
-(used where a stand-alone document may be imported into another)
-<p> <b>:A~ &nbsp;[heading
-&nbsp;text]</b> Top level heading &nbsp;[this &nbsp;usually &nbsp;has &nbsp;similar &nbsp;content &nbsp;to &nbsp;the &nbsp;] NOTE:
-the heading levels described here are in 0.38 notation, see heading
-<p> <b>:B~
-&nbsp;[heading &nbsp;text]</b> Second level heading &nbsp;[this &nbsp;is &nbsp;a &nbsp;heading &nbsp;level &nbsp;divider]
-<p>
- <b>:C~ &nbsp;[heading &nbsp;text]</b> Third level heading &nbsp;[this &nbsp;is &nbsp;a &nbsp;heading &nbsp;level &nbsp;divider]
-
-<p> <b>1~ &nbsp;[heading &nbsp;text]</b> Top level heading preceding substantive text of document
-or sub-heading 2, the heading level that would normally be marked 1. or 2.
-or 3. etc. in a document, and the level on which sisu by default would break
-html output into named segments, names are provided automatically if none
-are given (a number), otherwise takes the form 1~my_filename_for_this_segment
-
-<p> <b>2~ &nbsp;[heading &nbsp;text]</b> Second level heading preceding substantive text of
-document or sub-heading 3, the heading level that would normally be marked
-1.1 or 1.2 or 1.3 or 2.1 etc. in a document.
-<p> <b>3~ &nbsp;[heading &nbsp;text]</b> Third level
-heading preceding substantive text of document, that would normally be
-marked 1.1.1 or 1.1.2 or 1.2.1 or 2.1.1 etc. in a document
-<p>
-<p> <br>
-<pre> 1~filename level 1 heading,
- % the primary division such as Chapter that is followed by substantive
-text, and may be further subdivided (this is the level on which by default
-html segments are made)
-</pre>
-<p> 3.2 FONT ATTRIBUTES
-<p> <b>markup example:</b>
-<p>
-<p> <br>
-<pre> normal text !{emphasis}! *{bold text}* _{underscore}_ /{italics}/
- normal text
- !{emphasis}!
- *{bold text}*
- _{underscore}
- /{italics}/
-
- ^{superscript}^
- ,{subscript},
- +{inserted text}+
- -{strikethrough}-
-</pre>
-<p> <b>resulting output:</b>
-<p> normal text &lt;em&gt;emphasis&lt;/em&gt; <b>bold text</b> <i>underscore</i> <i>italics</i>
-&lt;cite&gt;citation&lt;/cite&gt; ^superscript^ &nbsp;[subscript] &lt;ins&gt;inserted text&lt;/ins&gt; &lt;del&gt;strikethrough&lt;/del&gt;
-
-<p> normal text
-<p> &lt;em&gt;emphasis&lt;/em&gt;
-<p> <b>bold text</b>
-<p> <i>underscore</i>
-<p> <i>italics</i>
-<p> &lt;cite&gt;citation&lt;/cite&gt;
-
-<p> ^superscript^
-<p> [subscript]
-<p> &lt;ins&gt;inserted text&lt;/ins&gt;
-<p> &lt;del&gt;strikethrough&lt;/del&gt;
-
-<p> 3.3 INDENTATION AND BULLETS
-<p> <b>markup example:</b>
-<p>
-<p> <br>
-<pre> ordinary paragraph
- _1 indent paragraph one step
- _2 indent paragraph two steps
- _9 indent paragraph nine steps
-</pre>
-<p> <b>resulting output:</b>
-<p> ordinary paragraph
-<p> indent paragraph one step<br>
-
-<p> indent paragraph two steps<br>
-
-<p> indent paragraph nine steps<br>
-
-<p> <b>markup example:</b>
-<p>
-<p> <br>
-<pre> * bullet text
- _1* bullet text, first indent
- _2* bullet text, two step indent
-</pre>
-<p> <b>resulting output:</b>
-<p> * bullet text
-<p> * bullet text, first indent<br>
-
-<p> * bullet text, two step indent<br>
-
-<p> Numbered List (not to be confused with headings/titles, (document structure))
-
-<p> <b>markup example:</b>
-<p>
-<p> <br>
-<pre> # numbered list numbered list 1., 2., 3, etc.
- _# numbered list numbered list indented a., b., c., d., etc.
-</pre>
-<p> 3.4 FOOTNOTES / ENDNOTES
-<p> Footnotes and endnotes not distinguished in
-markup. They are automatically numbered. Depending on the output file format
-(html, odf, pdf etc.), the document output selected will have either footnotes
-or endnotes.
-<p> <b>markup example:</b>
-<p>
-<p> <br>
-<pre> ~{ a footnote or endnote }~
-</pre>
-<p> <b>resulting output:</b>
-<p> [^3]
-<p> <b>markup example:</b>
-<p>
-<p> <br>
-<pre> normal text~{ self contained endnote marker &amp; endnote in one }~ continues
-</pre>
-<p> <b>resulting output:</b>
-<p> normal text[^4] continues
-<p> <b>markup example:</b>
-<p>
-<p> <br>
-<pre> normal text ~{* unnumbered asterisk footnote/endnote, insert multiple
-asterisks if required }~ continues
- normal text ~{** another unnumbered asterisk footnote/endnote }~ continues
-</pre>
-<p> <b>resulting output:</b>
-<p> normal text &nbsp;[^*] continues
-<p> normal text &nbsp;[^**] continues
-
-<p> <b>markup example:</b>
-<p>
-<p> <br>
-<pre> normal text ~[* &nbsp;editors &nbsp;notes, &nbsp;numbered &nbsp;asterisk &nbsp;footnote/endnote &nbsp;series
-&nbsp;]~ continues
- normal text ~[+ &nbsp;editors &nbsp;notes, &nbsp;numbered &nbsp;asterisk &nbsp;footnote/endnote &nbsp;series
-&nbsp;]~ continues
-</pre>
-<p> <b>resulting output:</b>
-<p> normal text &nbsp;[^*1] continues
-<p> normal text &nbsp;[^+1] continues
-
-<p> <b>Alternative endnote pair notation for footnotes/endnotes:</b>
-<p>
-<p> <br>
-<pre>
- % note the endnote marker
- normal text~^ continues
- ^~ endnote text following the paragraph in which the marker occurs
-</pre>
-<p> the standard and pair notation cannot be mixed in the same document
-<p>
-
-<p>3.5 LINKS
-<p> 3.5.1 NAKED URLS WITHIN TEXT, DEALING WITH URLS
-<p> urls are found
-within text and marked up automatically. A url within text is automatically
-hyperlinked to itself and by default decorated with angled braces, unless
-they are contained within a code block (in which case they are passed as
-normal text), or escaped by a preceding underscore (in which case the decoration
-is omitted).
-<p> <b>markup example:</b>
-<p>
-<p> <br>
-<pre> normal text http://www.jus.uio.no/sisu continues
-</pre>
-<p> <b>resulting output:</b>
-<p> normal text &lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-&gt; continues
-<p> An
-
-<p>escaped url without decoration
-<p> <b>markup example:</b>
-<p>
-<p> <br>
-<pre> normal text http://www.jus.uio.no/sisu continues
- deb http://www.jus.uio.no/sisu/archive unstable main non-free
-</pre>
-<p> <b>resulting output:</b>
-<p> normal text <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
- continues
-<p> deb
-
-<p><a href='http://www.jus.uio.no/sisu/archive'>http://www.jus.uio.no/sisu/archive</a>
- unstable main non-free
-<p> where a code block
-is used there is neither decoration nor hyperlinking, code blocks are discussed
-
-<p>later in this document
-<p> <b>resulting output:</b>
-<p>
-<p> <br>
-<pre> deb http://www.jus.uio.no/sisu/archive unstable main non-free
- deb-src http://www.jus.uio.no/sisu/archive unstable main non-free
-</pre>
-<p> To link text or an image to a url the markup is as follows
-<p> <b>markup example:</b>
-
-<p>
-<p> <br>
-<pre> about { SiSU }http://url.org markup
-</pre>
-<p> 3.5.2 LINKING TEXT
-<p> <b>resulting output:</b>
-<p> about SiSU &lt;<a href='http://www.jus.uio.no/sisu/'>http://www.jus.uio.no/sisu/</a>
-&gt;
-
-<p>markup
-<p> A shortcut notation is available so the url link may also be provided
-
-<p>automatically as a footnote
-<p> <b>markup example:</b>
-<p>
-<p> <br>
-<pre> about {~^ SiSU }http://url.org markup
-</pre>
-<p> <b>resulting output:</b>
-<p> about SiSU &lt;<a href='http://www.jus.uio.no/sisu/'>http://www.jus.uio.no/sisu/</a>
-&gt; &nbsp;[^5] markup
-<p> 3.5.3
-
-<p>LINKING IMAGES
-<p> <b>markup example:</b>
-<p>
-<p> <br>
-<pre> [ tux.png ]
- % various url linked images
- [ tux.png ]
- [ GnuDebianLinuxRubyBetterWay.png ]
- {~^ ruby_logo.png
-</pre>
-<p> <b>resulting output:</b>
-<p> [ tux.png ]
-<p> tux.png 64x80
-<p> [ &nbsp;ruby_logo &nbsp;(png &nbsp;missing)
-&nbsp;] &nbsp;[^6]
-<p> GnuDebianLinuxRubyBetterWay.png 100x101 and Ruby
-<p> <b>linked url footnote
-
-<p>shortcut</b>
-<p>
-<p> <br>
-<pre> {~^ &nbsp;[text &nbsp;to &nbsp;link] }http://url.org
- % maps to: { &nbsp;[text &nbsp;to &nbsp;link] }http://url.org ~{ http://url.org }~
- % which produces hyper-linked text within a document/paragraph, with an
-endnote providing the url for the text location used in the hyperlink
-</pre>
-<p>
-<p> <br>
-<pre> text marker *~name
-</pre>
-<p> note at a heading level the same is automatically achieved by providing
-names to headings 1, 2 and 3 i.e. 2~[name] and 3~[name] or in the case of
-auto-heading numbering, without further intervention.
-<p> 3.6 GROUPED TEXT
-<p> 3.6.1
-
-<p>TABLES
-<p> Tables may be prepared in two either of two forms
-<p> <b>markup example:</b>
-
-<p>
-<p> <br>
-<pre> table{ c3; 40; 30; 30;
- This is a table
- this would become column two of row one
- column three of row one is here
- And here begins another row
- column two of row two
- column three of row two, and so on
- }table
-</pre>
-<p> <b>resulting output:</b>
-<p> &nbsp;[table &nbsp;omitted, &nbsp;see &nbsp;other &nbsp;document &nbsp;formats]<br>
-
-<p> a second form may be easier to work with in cases where there is not
-
-<p>much information in each column
-<p> <b>markup example:</b> [^7]
-<p>
-<p> <br>
-<pre> !_ Table 3.1: Contributors to Wikipedia, January 2001 - June 2005
- {table~h 24; 12; 12; 12; 12; 12; 12;}
- |Jan. 2001|Jan. 2002|Jan. 2003|Jan. 2004|July
-2004|June 2006
- Contributors* | 10| 472| 2,188| 9,653|
- 25,011| 48,721
- Active contributors** | 9| 212| 846| 3,228|
- 8,442| 16,945
- Very active contributors*** | 0| 31| 190| 692|
- 1,639| 3,016
- No. of English language articles| 25| 16,000| 101,000| 190,000|
-320,000| 630,000
- No. of articles, all languages | 25| 19,000| 138,000| 490,000|
-862,000|1,600,000
- \* Contributed at least ten times; \** at least 5 times in last month;
-\* more than 100 times in last month.
-</pre>
-<p> <b>resulting output:</b>
-<p> <b>Table 3.1: Contributors to Wikipedia, January 2001
-- June 2005</b>
-<p> &nbsp;[table &nbsp;omitted, &nbsp;see &nbsp;other &nbsp;document &nbsp;formats]<br>
-
-<p> * Contributed at least ten times; ** at least 5 times in last month;
-*** more than 100 times in last month.
-<p> 3.6.2 POEM
-<p> <b>basic markup:</b>
-<p>
-<p> <br>
-<pre> poem{
- Your poem here
- }poem
- Each verse in a poem is given a separate object number.
-</pre>
-<p> <b>markup example:</b>
-<p>
-<p> <br>
-<pre> poem{
- &rsquo;Fury said to a
- mouse, That he
- met in the
- house,
-
- both go to
- law: I will
- prosecute
- YOU. --Come,
- I&rsquo;ll take no
- denial; We
- must have a
- trial: For
- really this
- morning I&rsquo;ve
- nothing
- to do.
- Said the
- mouse to the
- cur,
- a trial,
- dear Sir,
- With
- no jury
- or judge,
- would be
- wasting
- our
- breath.
-
- judge, I&rsquo;ll
- be jury,
- Said
- cunning
- old Fury:
-
- try the
- whole
- cause,
- and
- condemn
- you
- to
- death.
- }poem
-</pre>
-<p> <b>resulting output:</b>
-<p>
-<p> &rsquo;Fury said to a<br>
- <p>
- mouse, That he<br>
- <p>
- met in the<br>
- <p>
- house,<br>
- <p>
- <br>
- <p>
- both go to<br>
- <p>
- law: I will<br>
- <p>
- prosecute<br>
- <p>
- YOU. --Come,<br>
- <p>
- I&rsquo;ll take no<br>
- <p>
- denial; We<br>
- <p>
- must have a<br>
- <p>
- trial: For<br>
- <p>
- really this<br>
- <p>
- morning I&rsquo;ve<br>
- <p>
- nothing<br>
- <p>
- to do.<br>
- <p>
- Said the<br>
- <p>
- mouse to the<br>
- <p>
- cur,<br>
- <p>
- a trial,<br>
- <p>
- dear Sir,<br>
- <p>
- With<br>
- <p>
- no jury<br>
- <p>
- or judge,<br>
- <p>
- would be<br>
- <p>
- wasting<br>
- <p>
- our<br>
- <p>
- breath.<br>
- <p>
- <br>
- <p>
- judge, I&rsquo;ll<br>
- <p>
- be jury,<br>
- <p>
- Said<br>
- <p>
- cunning<br>
- <p>
- old Fury:<br>
- <p>
- <br>
- <p>
- try the<br>
- <p>
- whole<br>
- <p>
- cause,<br>
- <p>
- and<br>
- <p>
- condemn<br>
- <p>
- you<br>
- <p>
- to<br>
- <p>
- death.<br>
- <p>
-
-<p> 3.6.3 GROUP
-<p> <b>basic markup:</b>
-<p>
-<p> <br>
-<pre> group{
- Your grouped text here
- }group
- A group is treated as an object and given a single object number.
-</pre>
-<p> <b>markup example:</b>
-<p>
-<p> <br>
-<pre> group{
- &rsquo;Fury said to a
- mouse, That he
- met in the
- house,
-
- both go to
- law: I will
- prosecute
- YOU. --Come,
- I&rsquo;ll take no
- denial; We
- must have a
- trial: For
- really this
- morning I&rsquo;ve
- nothing
- to do.
- Said the
- mouse to the
- cur,
- a trial,
- dear Sir,
- With
- no jury
- or judge,
- would be
- wasting
- our
- breath.
-
- judge, I&rsquo;ll
- be jury,
- Said
- cunning
- old Fury:
-
- try the
- whole
- cause,
- and
- condemn
- you
- to
- death.
- }group
-</pre>
-<p> <b>resulting output:</b>
-<p>
-<p> &rsquo;Fury said to a<br>
- <p>
- mouse, That he<br>
- <p>
- met in the<br>
- <p>
- house,<br>
- <p>
- <br>
- <p>
- both go to<br>
- <p>
- law: I will<br>
- <p>
- prosecute<br>
- <p>
- YOU. --Come,<br>
- <p>
- I&rsquo;ll take no<br>
- <p>
- denial; We<br>
- <p>
- must have a<br>
- <p>
- trial: For<br>
- <p>
- really this<br>
- <p>
- morning I&rsquo;ve<br>
- <p>
- nothing<br>
- <p>
- to do.<br>
- <p>
- Said the<br>
- <p>
- mouse to the<br>
- <p>
- cur,<br>
- <p>
- a trial,<br>
- <p>
- dear Sir,<br>
- <p>
- With<br>
- <p>
- no jury<br>
- <p>
- or judge,<br>
- <p>
- would be<br>
- <p>
- wasting<br>
- <p>
- our<br>
- <p>
- breath.<br>
- <p>
- <br>
- <p>
- judge, I&rsquo;ll<br>
- <p>
- be jury,<br>
- <p>
- Said<br>
- <p>
- cunning<br>
- <p>
- old Fury:<br>
- <p>
- <br>
- <p>
- try the<br>
- <p>
- whole<br>
- <p>
- cause,<br>
- <p>
- and<br>
- <p>
- condemn<br>
- <p>
- you<br>
- <p>
- to<br>
- <p>
- death.<br>
- <p>
-
-<p> 3.6.4 CODE
-<p> Code tags are used to escape regular sisu markup, and have
-been used extensively within this document to provide examples of <b>SiSU</b>
-markup. You cannot however use code tags to escape code tags. They are however
-used in the same way as group or poem tags.
-<p> A code-block is treated as
-an object and given a single object number. &nbsp;[an more than 100 times in last
-month. option &nbsp;to &nbsp;number &nbsp;each &nbsp;line &nbsp;of &nbsp;code &nbsp;may &nbsp;be &nbsp;considered &nbsp;at more than
-100 times in last month. some &nbsp;later &nbsp;time]
-<p> <b>use of code tags instead of
-poem compared, resulting output:</b>
-<p>
-<p> <br>
-<pre> &rsquo;Fury said to a
- mouse, That he
- met in the
- house,
-
- both go to
- law: I will
- prosecute
- YOU. --Come,
- I&rsquo;ll take no
- denial; We
- must have a
- trial: For
- really this
- morning I&rsquo;ve
- nothing
- to do.
- Said the
- mouse to the
- cur,
- a trial,
- dear Sir,
- With
- no jury
- or judge,
- would be
- wasting
- our
- breath.
-
- judge, I&rsquo;ll
- be jury,
- Said
- cunning
- old Fury:
-
- try the
- whole
- cause,
- and
- condemn
- you
- to
- death.
-</pre>
-<p> 4. COMPOSITE DOCUMENTS MARKUP
-<p> It is possible to build a document by
-creating a master document that requires other documents. The documents
-required may be complete documents that could be generated independently,
-or they could be markup snippets, prepared so as to be easily available
-to be placed within another text. If the calling document is a master document
-(built from other documents), it should be named with the suffix <b>.ssm</b> Within
-this document you would provide information on the other documents that
-should be included within the text. These may be other documents that would
-be processed in a regular way, or markup bits prepared only for inclusion
-within a master document <b>.sst</b> regular markup file, or <b>.ssi</b> (insert/information)
-
-<p>A secondary file of the composite document is built prior to processing
-
-<p>with the same prefix and the suffix <b>._sst</b>
-<p> basic markup for importing a
-
-<p>document into a master document
-<p>
-<p> <br>
-<pre> &lt;&lt; |filename1.sst|@|^|
- &lt;&lt; |filename2.ssi|@|^|
-</pre>
-<p> The form described above should be relied on. Within the Vim editor it
-results in the text thus linked becoming hyperlinked to the document it
-is calling in which is convenient for editing. Alternative markup for importation
-of documents under consideration, and occasionally supported have been.
-
-<p>
-<p> <br>
-<pre> r{filename}
- {filename.ssi}require
- &lt;&lt; {filename.ssi}
- % using textlink alternatives
- |filename.ssi|@|^|require
- &lt;&lt; |filename.ssi|@|^|
- % using thlnk alternatives
- &lt;url:filename.ssi&gt;require
- &lt;&lt; &lt;url:filename.ssi&gt;
-</pre>
-<p> MARKUP SYNTAX HISTORY
-<p> 5. NOTES RELATED TO FILES-TYPES AND MARKUP SYNTAX
-
-<p> 0.38 is substantially current, depreciated 0.16 supported, though file
-
-<p>names were changed at 0.37
-<p> <b>0.52</b> (2007w14/6) declared document type identifier
-at start of text/document:
-<p> .B SiSU<br>
- 0.52
-<p> or, backward compatible using the comment marker:
-<p> %<br>
- <b>SiSU</b> 0.38
-<p> variations include &rsquo; <b>SiSU</b> (text|master|insert) &nbsp;[version]&rsquo; and &rsquo;sisu-[version]&rsquo;
-
-<p> <b>0.51</b> (2007w13/6) skins changed (simplified), markup unchanged
-<p> <b>0.42</b> (2006w27/4)
-* (asterisk) type endnotes, used e.g. in relation to author
-<p> <b>0.38</b> (2006w15/7)
-introduced new/alternative notation for headers, e.g. @title: (instead of
-0~title), and accompanying document structure markup, :A,:B,:C,1,2,3 (maps
-to previous 1,2,3,4,5,6)
-<p> <b>0.37</b> (2006w09/7) introduced new file naming convention,
-.sst (text), .ssm (master), .ssi (insert), markup syntax unchanged
-<p> <b>0.35</b> (2005w52/3)
-sisupod, zipped content file introduced
-<p> <b>0.23</b> (2005w36/2) utf-8 for markup
-
-<p>file
-<p> <b>0.22</b> (2005w35/3) image dimensions may be omitted if rmagick is available
-
-<p>to be relied upon
-<p> <b>0.20.4</b> (2005w33/4) header 0~links
-<p> <b>0.16</b> (2005w25/2) substantial
-changes introduced to make markup cleaner, header 0~title type, and headings
-&nbsp;[1-6]~ introduced, also percentage sign (%) at start of a text line as comment
-
-<p>marker
-<p> DOCUMENT INFORMATION (METADATA)
-<p> METADATA
-<p> Document Manifest
-@ &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/sisu_manifest.html</a>
-&gt;
-<p> <b>Dublin
-Core</b> (DC)
-<p> <i>DC</i> tags included with this document are provided here.
-<p> DC
-Title: <i>SiSU</i> - Markup
-<p> DC Creator: <i>Ralph</i> Amissah
-<p> DC Rights: <i>Copyright</i>
-(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
-<p> DC
-Type: <i>information</i>
-<p> DC Date created: <i>2002-08-28</i>
-<p> DC Date issued: <i>2002-08-28</i>
-
-<p> DC Date available: <i>2002-08-28</i>
-<p> DC Date modified: <i>2007-09-16</i>
-<p> DC Date: <i>2007-09-16</i>
-
-<p> <b>Version Information</b>
-<p> Sourcefile: <i>sisu_markup.sst</i>
-<p> Filetype: <i>SiSU</i> text
-
-<p>0.58
-<p> Sourcefile Digest, MD5(sisu_markup.sst)= <i>6848f40f5844e0a7d59dbb86b3ddae92</i>
-
-<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-
-<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i>
-<p> <b>Generated</b>
-<p> Document (metaverse) last
-generated: <i>Mon</i> Sep 24 15:36:14 +0100 2007
-<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of
-2007w38/0 (2007-09-23)
-<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36)
-&nbsp;[i486-linux]
-<p>
-<ol>
-<b>.</b><li>From sometime after SiSU 0.58 it should be possible to describe
-SiSU markup using SiSU, which though not an original design goal is useful.
-</li><b>.</b><li>files should be prepared using UTF-8 character encoding </li><b>.</b><li>a footnote or endnote
-</li><b>.</b><li>self contained endnote marker &amp; endnote in one </dd>
-
-<dt><b>*.</b> </dt>
-<dd>unnumbered asterisk footnote/endnote,
-insert multiple asterisks if required </dd>
-
-<dt><b>**.</b> </dt>
-<dd>another unnumbered asterisk footnote/endnote
-</dd>
-
-<dt><b>*1.</b> </dt>
-<dd>editors notes, numbered asterisk footnote/endnote series </dd>
-
-<dt><b>+1.</b> </dt>
-<dd>editors
-notes, numbered asterisk footnote/endnote series </li><b>.</b><li>&lt;<a href='http://www.jus.uio.no/sisu/'>http://www.jus.uio.no/sisu/</a>
-&gt;
-</li><b>.</b><li>&lt;<a href='http://www.ruby-lang.org/en/'>http://www.ruby-lang.org/en/</a>
-&gt; </li><b>.</b><li>Table from the Wealth of Networks by Yochai Benkler
- &lt;<a href='http://www.jus.uio.no/sisu/the_wealth_of_networks.yochai_benkler'>http://www.jus.uio.no/sisu/the_wealth_of_networks.yochai_benkler</a>
-&gt;<br>
-
-<p> </dd>
-
-<dt>Other versions of this document: </dt>
-<dd></dd>
-
-<dt>manifest: &lt;<a href='http://www.jus.uio.no/sisu/sisu_markup/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_markup/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_markup/sisu_manifest.html</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>html: &lt;<a href='http://www.jus.uio.no/sisu/sisu_markup/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_markup/toc.html'>http://www.jus.uio.no/sisu/sisu_markup/toc.html</a>
-</a>
-&gt; </dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_markup/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_markup/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_markup/portrait.pdf</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_markup/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_markup/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_markup/landscape.pdf</a>
-</a>
-&gt; </dt>
-<dd> </dd>
-
-<dt>at: &lt;<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt>
-<dd></dd>
-
-<dt>* Ruby version: ruby
-1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt>
-<dd></dd>
-
-<dt>* Last Generated on: Mon Sep 24
-15:36:30 +0100 2007 </dt>
-<dd></dd>
-
-<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
- </dt>
-<dd></dd>
-</dl>
-<p>
-</body>
-</html>
diff --git a/data/doc/sisu/html/sisu_quickstart.8.html b/data/doc/sisu/html/sisu_quickstart.8.html
deleted file mode 100644
index 6afe5b27..00000000
--- a/data/doc/sisu/html/sisu_quickstart.8.html
+++ /dev/null
@@ -1,332 +0,0 @@
-<!-- manual page source format generated by PolyglotMan v3.2, -->
-<!-- available at http://polyglotman.sourceforge.net/ -->
-
-<html>
-<head>
-<title>"sisu_quickstart"("1") manual page</title>
-</head>
-<body bgcolor='white'>
-<a href='#toc'>Table of Contents</a><p>
-SISU - QUICKSTART, INSTALLATION AND USE, RALPH AMISSAH
-<p> QUICKSTART - SISU
-INSTALLATION AND USE
-<p> 1. QUICKSTART - GETTING STARTED HOWTO
-<p> 1.1 INSTALLATION
-
-<p> Installation is currently most straightforward and tested on the <b>Debian</b>
-platform, as there are packages for the installation of sisu and all requirements
-for what it does.
-<p> 1.1.1 DEBIAN INSTALLATION
-<p> <b>SiSU</b> is available directly
-from the <b>Debian</b> Sid and testing archives (and possibly Ubuntu), assuming
-your /etc/apt/sources.list is set accordingly:
-<p>
-<p> <br>
-<pre> aptitude update
- aptitude install sisu-complete
-</pre>
-<p> The following /etc/apt/sources.list setting permits the download of additional
-markup samples:
-<p>
-<p> <br>
-<pre> #/etc/apt/sources.list
- deb http://ftp.fi.debian.org/debian/ unstable main non-free contrib
- deb-src http://ftp.fi.debian.org/debian/ unstable main non-free contrib
- d
-</pre>
-<p> The aptitude commands become:
-<p>
-<p> <br>
-<pre> aptitude update
- aptitude install sisu-complete sisu-markup-samples
-</pre>
-<p> If there are newer versions of <b>SiSU</b> upstream of the <b>Debian</b> archives,
-
-<p>they will be available by adding the following to your /etc/apt/sources.list
-
-<p>
-<p> <br>
-<pre> #/etc/apt/sources.list
- deb http://www.jus.uio.no/sisu/archive unstable main non-free
- deb-src http://www.jus.uio.no/sisu/archive unstable main non-free
-</pre>
-<p> repeat the aptitude commands
-<p>
-<p> <br>
-<pre> aptitude update
- aptitude install sisu-complete sisu-markup-samples
-</pre>
-<p> Note however that it is not necessary to install sisu-complete if not
-all components of sisu are to be used. Installing just the package sisu
-will provide basic functionality.
-<p> 1.1.2 RPM INSTALLATION
-<p> RPMs are provided
-though untested, they are prepared by running alien against the source
-package, and against the debs.
-<p> They may be downloaded from:
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU/download.html#rpm'>http://www.jus.uio.no/sisu/SiSU/download.html#rpm</a>
-&gt;<br>
-
-<p> as root type:
-<p> rpm -i &nbsp;[rpm &nbsp;package &nbsp;name]<br>
-
-<p> 1.1.3 INSTALLATION FROM SOURCE
-<p> To install <b>SiSU</b> from source check information
-at:
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU/download.html#current'>http://www.jus.uio.no/sisu/SiSU/download.html#current</a>
-&gt;<br>
-
-<p> * download the source package
-<p> * Unpack the source
-<p> Two alternative
-modes of installation from source are provided, setup.rb (by Minero Aoki)
-and a rant(by Stefan Lang) built install file, in either case: the first
-steps are the same, download and unpack the source file:
-<p> For basic use
-<b>SiSU</b> is only dependent on the programming language in which it is written
-<b>Ruby</b> , and <b>SiSU</b> will be able to generate html, various XMLs, including
-ODF (and will also produce LaTeX). Dependencies required for further actions,
-though it relies on the installation of additional dependencies which the
-source tarball does not take care of, for things like using a database
-(postgresql or sqlite)[^1] or converting LaTeX to pdf.
-<p> <b>setup.rb</b>
-<p> This is
-a standard ruby installer, using setup.rb is a three step process. In the
-root directory of the unpacked <b>SiSU</b> as root type:
-<p>
-<p> <br>
-<pre> ruby setup.rb config
- ruby setup.rb setup
- #[and &nbsp;as &nbsp;root:]
- ruby setup.rb install
-</pre>
-<p> further information on setup.rb is available from:
-<p> &lt;<a href='http://i.loveruby.net/en/projects/setup/'>http://i.loveruby.net/en/projects/setup/</a>
-&gt;<br>
-
-<p> &lt;<a href='http://i.loveruby.net/en/projects/setup/doc/usage.html'>http://i.loveruby.net/en/projects/setup/doc/usage.html</a>
-&gt;<br>
-
-<p> <b></b>
-<p> The root directory of the unpacked <b>SiSU</b> as root type:
-<p> ruby install
-base<br>
-
-<p> or for a more complete installation:
-<p> ruby install<br>
-
-<p> or
-<p> ruby install base<br>
-
-<p> This makes use of Rant (by Stefan Lang) and the provided Rantfile. It
-has been configured to do post installation setup setup configuration and
-generation of first test file. Note however, that additional external package
-dependencies, such as tetex-extra are not taken care of for you.
-<p> Further
-
-<p>information on
-<p> &lt;<a href='http://make.rubyforge.org/'>http://make.rubyforge.org/</a>
-&gt;<br>
-
-<p> &lt;<a href='http://rubyforge.org/frs/?group_id=615'>http://rubyforge.org/frs/?group_id=615</a>
-&gt;<br>
-
-<p> For a list of alternative actions you may type:
-<p> ruby install help<br>
-
-<p> ruby install -T<br>
-
-<p> 1.2 TESTING SISU, GENERATING OUTPUT
-<p> To check which version of sisu is
-installed:
-<p> sisu -v
-<p> Depending on your mode of installation one or a number
-of markup sample files may be found either in the directory:
-<p>
-<p> or
-<p>
-
-<p> change directory to the appropriate one:
-<p> cd /usr/share/doc/sisu/sisu_markup_samples/dfsg
-
-<p> 1.2.1 BASIC TEXT, PLAINTEXT, HTML, XML, ODF
-<p> Having moved to the directory
-that contains the markup samples (see instructions above if necessary),
-
-<p>choose a file and run sisu against it
-<p> sisu -NhwoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst
-
-<p> this will generate html including a concordance file, opendocument text
-format, plaintext, XHTML and various forms of XML, and OpenDocument text
-
-<p> 1.2.2 LATEX / PDF
-<p> Assuming a LaTeX engine such as tetex or texlive is
-installed with the required modules (done automatically on selection of
-sisu-pdf in <b>Debian</b> )
-<p> Having moved to the directory that contains the markup
-samples (see instructions above if necessary), choose a file and run sisu
-
-<p>against it
-<p> sisu -pv free_as_in_freedom.rms_and_free_software.sam_williams.sst
-
-<p> sisu -3 free_as_in_freedom.rms_and_free_software.sam_williams.sst
-<p> should
-generate most available output formats: html including a concordance file,
-opendocument text format, plaintext, XHTML and various forms of XML, and
-
-<p>OpenDocument text and pdf
-<p> 1.2.3 RELATIONAL DATABASE - POSTGRESQL, SQLITE
-
-<p> Relational databases need some setting up - you must have permission to
-create the database and write to it when you run sisu.
-<p> Assuming you have
-
-<p>the database installed and the requisite permissions
-<p> sisu --sqlite --recreate
-
-<p> sisu --sqlite -v --import free_as_in_freedom.rms_and_free_software.sam_williams.sst
-
-<p> sisu --pgsql --recreate
-<p> sisu --pgsql -v --import free_as_in_freedom.rms_and_free_software.sam_williams.sst
-
-<p> 1.3 GETTING HELP
-<p> 1.3.1 THE MAN PAGES
-<p> Type:
-<p> man sisu<br>
-
-<p> The man pages are also available online, though not always kept as up
-to date as within the package itself:
-<p> * sisu.1 &lt;<a href='http://www.jus.uio.no/sisu/man/sisu.1'>http://www.jus.uio.no/sisu/man/sisu.1</a>
-&gt;
-&nbsp;[^2]
-<p> * sisu.8 &lt;<a href='http://www.jus.uio.no/sisu/man/sisu.8'>http://www.jus.uio.no/sisu/man/sisu.8</a>
-&gt; &nbsp;[^3]
-<p> * man directory &lt;<a href='http://www.jus.uio.no/sisu/man'>http://www.jus.uio.no/sisu/man</a>
-&gt;
-&nbsp;[^4]
-<p> 1.3.2 BUILT IN HELP
-<p> sisu --help
-<p> sisu --help --env
-<p> sisu --help --commands
-
-<p> sisu --help --markup
-<p> 1.3.3 THE HOME PAGE
-<p> &lt;<a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-&gt;
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU'>http://www.jus.uio.no/sisu/SiSU</a>
-&gt;
-
-<p> 1.4 MARKUP SAMPLES
-<p> A number of markup samples (along with output) are
-available off:
-<p> &lt;<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a>
-&gt;
-<p> Additional markup
-samples are packaged separately in the file:
-<p> <b>*</b>
-<p> On <b>Debian</b> they are available
-in non-free[^5] to include them it is necessary to include non-free in your
-/etc/apt/source.list or obtain them from the sisu home site.
-<p> DOCUMENT INFORMATION
-(METADATA)
-<p> METADATA
-<p> Document Manifest @ &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/sisu_manifest.html</a>
-&gt;
-
-<p> <b>Dublin Core</b> (DC)
-<p> <i>DC</i> tags included with this document are provided here.
-
-<p> DC Title: <i>SiSU</i> - Quickstart, installation and use
-<p> DC Creator: <i>Ralph</i>
-
-<p>Amissah
-<p> DC Rights: <i>Copyright</i> (C) Ralph Amissah 2007, part of SiSU documentation,
-
-<p>License GPL 3
-<p> DC Type: <i>information</i>
-<p> DC Date created: <i>2006-09-06</i>
-<p> DC Date
-available: <i>2006-09-06</i>
-<p> DC Date issued: <i>2006-09-06</i>
-<p> DC Date modified: <i>2007-09-16</i>
-
-<p> DC Date: <i>2007-09-16</i>
-<p> <b>Version Information</b>
-<p> Sourcefile: <i>sisu_quickstart.sst</i>
-
-<p> Filetype: <i>SiSU</i> text 0.57
-<p> Sourcefile Digest, MD5(sisu_quickstart.sst)=
-
-<p><i>e76db98ca0d8c2bfe526dad55622fa7a</i>
-<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-
-<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i>
-<p> <b>Generated</b>
-<p> Document (metaverse) last
-generated: <i>Mon</i> Sep 24 15:36:15 +0100 2007
-<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of
-2007w38/0 (2007-09-23)
-<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36)
-&nbsp;[i486-linux]
-<p>
-<ol>
-<b>.</b><li>There is nothing to stop MySQL support being added in future.
-</li><b>.</b><li>&lt;<a href='http://www.jus.uio.no/sisu/man/sisu.1'>http://www.jus.uio.no/sisu/man/sisu.1</a>
-&gt; </li><b>.</b><li>&lt;<a href='http://www.jus.uio.no/sisu/man/sisu.8'>http://www.jus.uio.no/sisu/man/sisu.8</a>
-&gt; </li><b>.</b><li>&lt;<a href='http://www.jus.uio.no/sisu/man'>http://www.jus.uio.no/sisu/man</a>
-&gt;
-</li><b>.</b><li>the .B Debian Free Software guidelines require that everything distributed
-within .B Debian can be changed - and the documents are authors&rsquo; works that
-while freely distributable are not freely changeable.
-<p> </dd>
-
-<dt>Other versions of
-this document: </dt>
-<dd></dd>
-
-<dt>manifest: &lt;<a href='http://www.jus.uio.no/sisu/sisu_quickstart/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_quickstart/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_quickstart/sisu_manifest.html</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>html: &lt;<a href='http://www.jus.uio.no/sisu/sisu_quickstart/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_quickstart/toc.html'>http://www.jus.uio.no/sisu/sisu_quickstart/toc.html</a>
-</a>
-&gt; </dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_quickstart/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_quickstart/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_quickstart/portrait.pdf</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_quickstart/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_quickstart/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_quickstart/landscape.pdf</a>
-</a>
-&gt; </dt>
-<dd> </dd>
-
-<dt>at: &lt;<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt>
-<dd></dd>
-
-<dt>* Ruby version: ruby
-1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt>
-<dd></dd>
-
-<dt>* Last Generated on: Mon Sep 24
-15:36:31 +0100 2007 </dt>
-<dd></dd>
-
-<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
- </dt>
-<dd></dd>
-</dl>
-<p>
-</body>
-</html>
diff --git a/data/doc/sisu/html/sisu_remote.8.html b/data/doc/sisu/html/sisu_remote.8.html
deleted file mode 100644
index 6d453b15..00000000
--- a/data/doc/sisu/html/sisu_remote.8.html
+++ /dev/null
@@ -1,189 +0,0 @@
-<!-- manual page source format generated by PolyglotMan v3.2, -->
-<!-- available at http://polyglotman.sourceforge.net/ -->
-
-<html>
-<head>
-<title>"sisu_remote"("1") manual page</title>
-</head>
-<body bgcolor='white'>
-<a href='#toc'>Table of Contents</a><p>
-SISU - REMOTE OPERATIONS, RALPH AMISSAH
-<p> SISU REMOTE OPERATIONS
-<p> 1. REMOTE
-SOURCE DOCUMENTS
-<p> <b>SiSU</b> processing instructions can be run against remote
-source documents by providing the url of the documents against which the
-processing instructions are to be carried out. The remote <b>SiSU</b> documents
-can either be sisu marked up files in plaintext .sst or .ssm or; zipped sisu
-files, sisupod.zip or filename.ssp
-<p> <b>.sst / .ssm - sisu text files</b>
-<p> <b>SiSU</b> can
-be run against source text files on a remote machine, provide the processing
-instruction and the url. The source file and any associated parts (such
-as images) will be downloaded and generated locally.
-<p>
-<p> <br>
-<pre> sisu -3 http://[provide &nbsp;url &nbsp;to &nbsp;valid &nbsp;.sst &nbsp;or &nbsp;.ssm &nbsp;file]
-</pre>
-<p> Any of the source documents in the sisu examples page can be used in
-this way, see &lt;<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a>
-&gt; and use the url for the
-desired document.
-<p> NOTE: to set up a remote machine to serve <b>SiSU</b> documents
-in this way, images should be in the directory relative to the document
-
-<p>source ../_sisu/image
-<p> <b>sisupod - zipped sisu files</b>
-<p> A sisupod is the zipped
-content of a sisu marked up text or texts and any other associated parts
-to the document such as images.
-<p> <b>SiSU</b> can be run against a sisupod on a
-(local or) remote machine, provide the processing instruction and the url,
-the sisupod will be downloaded and the documents it contains generated
-locally.
-<p>
-<p> <br>
-<pre> sisu -3 http://[provide &nbsp;url &nbsp;to &nbsp;valid &nbsp;sisupod.zip &nbsp;or &nbsp;.ssp &nbsp;file]
-</pre>
-<p> Any of the source documents in the sisu examples page can be used in
-this way, see &lt;<a href='http://www.jus.uio.no/sisu/SiSU/2.html'>http://www.jus.uio.no/sisu/SiSU/2.html</a>
-&gt; and use the url for the
-desired document.
-<p> REMOTE DOCUMENT OUTPUT
-<p> 2. REMOTE OUTPUT
-<p> Once properly
-configured <b>SiSU</b> output can be automatically posted once generated to a
-designated remote machine using either rsync, or scp.
-<p> In order to do this
-some ssh authentication agent and keychain or similar tool will need to
-be configured. Once that is done the placement on a remote host can be done
-seamlessly with the -r (for scp) or -R (for rsync) flag, which may be used
-in conjunction with other processing flags, e.g.
-<p>
-<p> <br>
-<pre> sisu -3R sisu_remote.sst
-</pre>
-<p> 2.1 COMMANDS
-<p>
-<dl>
-
-<dt><b>&nbsp;-R &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>copies sisu output files to remote
-host using rsync. This requires that sisurc.yml has been provided with information
-on hostname and username, and that you have your different if -R is used
-with other flags from if used alone. Alone the rsync --delete parameter is
-sent, useful for cleaning the remote directory (when -R is used together
-with other flags, it is not). Also see -r
-<p> </dd>
-
-<dt><b>&nbsp;-r &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>copies sisu
-output files to remote host using scp. This requires that sisurc.yml has
-been provided with information on hostname and username, and that you have
-
-<p>your
-<p> </dd>
-</dl>
-2.2 CONFIGURATION
-<p> [expand &nbsp;on &nbsp;the &nbsp;setting &nbsp;up &nbsp;of &nbsp;an &nbsp;ssh-agent &nbsp;/ &nbsp;keychain]
-
-<p> 3. REMOTE SERVERS
-<p> As <b>SiSU</b> is generally operated using the command line,
-and works within a Unix type environment, <b>SiSU</b> the program and all documents
-can just as easily be on a remote server, to which you are logged on using
-a terminal, and commands and operations would be pretty much the same as
-they would be on your local machine.
-<p> DOCUMENT INFORMATION (METADATA)
-<p>
-METADATA
-<p> Document Manifest @ &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/sisu_manifest.html</a>
-&gt;
-
-<p> <b>Dublin Core</b> (DC)
-<p> <i>DC</i> tags included with this document are provided here.
-
-<p> DC Title: <i>SiSU</i> - Remote Operations
-<p> DC Creator: <i>Ralph</i> Amissah
-<p> DC Rights:
-<i>Copyright</i> (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-
-<p>3
-<p> DC Type: <i>information</i>
-<p> DC Date created: <i>2002-08-28</i>
-<p> DC Date issued:
-
-<p><i>2002-08-28</i>
-<p> DC Date available: <i>2002-08-28</i>
-<p> DC Date modified: <i>2007-09-16</i>
-<p> DC
-Date: <i>2007-09-16</i>
-<p> <b>Version Information</b>
-<p> Sourcefile: <i>sisu_remote.sst</i>
-<p> Filetype:
-
-<p><i>SiSU</i> text 0.58
-<p> Sourcefile Digest, MD5(sisu_remote.sst)= <i>9bdac464998dc3f034fbd8f80df23b83</i>
-
-<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-
-<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i>
-<p> <b>Generated</b>
-<p> Document (metaverse) last
-generated: <i>Mon</i> Sep 24 15:36:17 +0100 2007
-<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of
-2007w38/0 (2007-09-23)
-<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36)
-&nbsp;[i486-linux]
-<p>
-<p>
-<dl>
-
-<dt>Other versions of this document: </dt>
-<dd></dd>
-
-<dt>manifest: &lt;<a href='http://www.jus.uio.no/sisu/sisu_remote/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_remote/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_remote/sisu_manifest.html</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>html: &lt;<a href='http://www.jus.uio.no/sisu/sisu_remote/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_remote/toc.html'>http://www.jus.uio.no/sisu/sisu_remote/toc.html</a>
-</a>
-&gt; </dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_remote/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_remote/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_remote/portrait.pdf</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_remote/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_remote/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_remote/landscape.pdf</a>
-</a>
-&gt; </dt>
-<dd> </dd>
-
-<dt>at: &lt;<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt>
-<dd></dd>
-
-<dt>* Ruby version: ruby
-1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt>
-<dd></dd>
-
-<dt>* Last Generated on: Mon Sep 24
-15:36:32 +0100 2007 </dt>
-<dd></dd>
-
-<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
- </dt>
-<dd></dd>
-</dl>
-<p>
-</body>
-</html>
diff --git a/data/doc/sisu/html/sisu_search.8.html b/data/doc/sisu/html/sisu_search.8.html
deleted file mode 100644
index 64fe307b..00000000
--- a/data/doc/sisu/html/sisu_search.8.html
+++ /dev/null
@@ -1,512 +0,0 @@
-<!-- manual page source format generated by PolyglotMan v3.2, -->
-<!-- available at http://polyglotman.sourceforge.net/ -->
-
-<html>
-<head>
-<title>"sisu_search"("1") manual page</title>
-</head>
-<body bgcolor='white'>
-<a href='#toc'>Table of Contents</a><p>
-SISU - SEARCH, RALPH AMISSAH
-<p> SISU SEARCH
-<p> 1. SISU SEARCH - INTRODUCTION
-
-<p> <b>SiSU</b> output can easily and conveniently be indexed by a number of standalone
-indexing tools, such as Lucene, Hyperestraier.
-<p> Because the document structure
-of sites created is clearly defined, and the text object citation system
-is available hypothetically at least, for all forms of output, it is possible
-to search the sql database, and either read results from that database,
-or just as simply map the results to the html output, which has richer
-text markup.
-<p> In addition to this <b>SiSU</b> has the ability to populate a relational
-sql type database with documents at an object level, with objects numbers
-that are shared across different output types, which make them searchable
-with that degree of granularity. Basically, your match criteria is met by
-these documents and at these locations within each document, which can
-be viewed within the database directly or in various output formats.
-<p> 2.
-SQL
-<p> 2.1 POPULATING SQL TYPE DATABASES
-<p> <b>SiSU</b> feeds sisu markupd documents
-into sql type databases PostgreSQL[^1] and/or SQLite[^2] database together
-with information related to document structure.
-<p> This is one of the more
-interesting output forms, as all the structural data of the documents are
-retained (though can be ignored by the user of the database should they
-so choose). All site texts/documents are (currently) streamed to four tables:
-
-<p> * one containing semantic (and other) headers, including, title, author,<br>
- subject, (the Dublin Core...);<br>
-
-<p> * another the substantive texts by individual<br>
- along with structural information, each paragraph being identifiable
-by its<br>
- paragraph number (if it has one which almost all of them do), and the<br>
- substantive text of each paragraph quite naturally being searchable
-(both in<br>
- formatted and clean text versions for searching); and<br>
-
-<p> * a third containing endnotes cross-referenced back to the paragraph
-from<br>
- which they are referenced (both in formatted and clean text versions
-for<br>
- searching).<br>
-
-<p> * a fourth table with a one to one relation with the headers table
-contains<br>
- full text versions of output, eg. pdf, html, xml, and ascii.<br>
-
-<p> There is of course the possibility to add further structures.
-<p> At this
-level <b>SiSU</b> loads a relational database with documents chunked into objects,
-their smallest logical structurally constituent parts, as text objects,
-with their object citation number and all other structural information
-needed to construct the document. Text is stored (at this text object level)
-with and without elementary markup tagging, the stripped version being
-so as to facilitate ease of searching.
-<p> Being able to search a relational
-database at an object level with the <b>SiSU</b> citation system is an effective
-way of locating content generated by <b>SiSU</b> object numbers, and all versions
-of the document have the same numbering, complex searches can be tailored
-to return just the locations of the search results relevant for all available
-output formats, with live links to the precise locations in the database
-or in html/xml documents; or, the structural information provided makes
-it possible to search the full contents of the database and have headings
-in which search content appears, or to search only headings etc. (as the
-Dublin Core is incorporated it is easy to make use of that as well).
-<p> 3.
-POSTGRESQL
-<p> 3.1 NAME
-<p> <b>SiSU</b> - Structured information, Serialized Units -
-a document publishing system, postgresql dependency package
-<p> 3.2 DESCRIPTION
-
-<p> Information related to using postgresql with sisu (and related to the
-sisu_postgresql dependency package, which is a dummy package to install
-dependencies needed for <b>SiSU</b> to populate a postgresql database, this being
-part of <b>SiSU</b> - man sisu).
-<p> 3.3 SYNOPSIS
-<p> sisu -D &nbsp;[instruction] &nbsp;[filename/wildcard
-&nbsp;if &nbsp;required]<br>
-
-<p> sisu -D --pg --[instruction] &nbsp;[filename/wildcard &nbsp;if &nbsp;required]<br>
-
-<p> 3.4 COMMANDS
-<p> Mappings to two databases are provided by default, postgresql
-and sqlite, the same commands are used within sisu to construct and populate
-databases however -d (lowercase) denotes sqlite and -D (uppercase) denotes
-postgresql, alternatively --sqlite or --pgsql may be used
-<p> <b>-D or --pgsql</b> may
-be used interchangeably.
-<p> 3.4.1 CREATE AND DESTROY DATABASE
-<p>
-<dl>
-
-<dt><b>&nbsp;--pgsql &nbsp;--createall</b>
-</dt>
-<dd>&nbsp;initial &nbsp;step, &nbsp;creates &nbsp;required &nbsp;relations &nbsp;(tables, &nbsp;indexes) &nbsp;in &nbsp;existing
-&nbsp;(postgresql) &nbsp;database &nbsp;(a &nbsp;database &nbsp;should &nbsp;be &nbsp;created manually &nbsp;and &nbsp;given
-&nbsp;the &nbsp;same &nbsp;name &nbsp;as &nbsp;working &nbsp;directory, &nbsp;as requested) &nbsp;(rb.dbi) the &nbsp;same &nbsp;name
-&nbsp;as &nbsp;working &nbsp;directory, &nbsp;as
-<p> </dd>
-
-<dt><b>&nbsp;sisu &nbsp;-D &nbsp;--createdb</b> </dt>
-<dd>&nbsp;creates &nbsp;database &nbsp;where &nbsp;no &nbsp;database
-&nbsp;existed &nbsp;before &nbsp;as
-<p> </dd>
-
-<dt><b>&nbsp;sisu &nbsp;-D &nbsp;--create</b> </dt>
-<dd>&nbsp;creates &nbsp;database &nbsp;tables &nbsp;where &nbsp;no &nbsp;database
-&nbsp;tables &nbsp;existed before &nbsp;database &nbsp;tables &nbsp;where &nbsp;no &nbsp;database &nbsp;tables &nbsp;existed
-
-<p> </dd>
-
-<dt><b>&nbsp;sisu &nbsp;-D &nbsp;--Dropall</b> </dt>
-<dd>&nbsp;destroys &nbsp;database &nbsp;(including &nbsp;all &nbsp;its &nbsp;content)! &nbsp;kills &nbsp;data
-and &nbsp;drops &nbsp;tables, &nbsp;indexes &nbsp;and &nbsp;database &nbsp;associated &nbsp;with &nbsp;a given &nbsp;directory
-&nbsp;(and &nbsp;directories &nbsp;of &nbsp;the &nbsp;same &nbsp;name). &nbsp;a
-<p> </dd>
-
-<dt><b>&nbsp;sisu &nbsp;-D &nbsp;--recreate</b> </dt>
-<dd>&nbsp;destroys &nbsp;existing
-
-<p>&nbsp;database &nbsp;and &nbsp;builds &nbsp;a &nbsp;new &nbsp;empty &nbsp;database &nbsp;structure
-<p> </dd>
-</dl>
-3.4.2 IMPORT AND REMOVE
-
-<p>DOCUMENTS
-<p>
-<dl>
-
-<dt><b>&nbsp;sisu &nbsp;-D &nbsp;--import &nbsp;-v &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>populates database with
-the contents of the file. Imports documents(s) specified to a postgresql
-database (at an object level).
-<p> </dd>
-
-<dt><b>&nbsp;sisu &nbsp;-D &nbsp;--update &nbsp;-v &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>updates
-
-<p>file contents in database
-<p> </dd>
-
-<dt><b>&nbsp;sisu &nbsp;-D &nbsp;--remove &nbsp;-v &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>removes
-specified document from postgresql database.
-<p> </dd>
-</dl>
-4. SQLITE
-<p> 4.1 NAME
-<p> <b>SiSU</b>
-- Structured information, Serialized Units - a document publishing system.
-
-<p> 4.2 DESCRIPTION
-<p> Information related to using sqlite with sisu (and related
-to the sisu_sqlite dependency package, which is a dummy package to install
-dependencies needed for <b>SiSU</b> to populate an sqlite database, this being
-part of <b>SiSU</b> - man sisu).
-<p> 4.3 SYNOPSIS
-<p> sisu -d &nbsp;[instruction] &nbsp;[filename/wildcard
-&nbsp;if &nbsp;required]<br>
-
-<p> sisu -d --(sqlite|pg) --[instruction] &nbsp;[filename/wildcard &nbsp;if <br>
- required]<br>
-
-<p> 4.4 COMMANDS
-<p> Mappings to two databases are provided by default, postgresql
-and sqlite, the same commands are used within sisu to construct and populate
-databases however -d (lowercase) denotes sqlite and -D (uppercase) denotes
-postgresql, alternatively --sqlite or --pgsql may be used
-<p> <b>-d or --sqlite</b> may
-be used interchangeably.
-<p> 4.4.1 CREATE AND DESTROY DATABASE
-<p>
-<dl>
-
-<dt><b>&nbsp;--sqlite &nbsp;--createall</b>
-</dt>
-<dd>&nbsp;initial &nbsp;step, &nbsp;creates &nbsp;required &nbsp;relations &nbsp;(tables, &nbsp;indexes) &nbsp;in &nbsp;existing
-&nbsp;(sqlite) &nbsp;database &nbsp;(a &nbsp;database &nbsp;should &nbsp;be &nbsp;created &nbsp;as requested) &nbsp;(rb.dbi) the
-&nbsp;same &nbsp;name &nbsp;as &nbsp;working &nbsp;directory, &nbsp;as
-<p> </dd>
-
-<dt><b>&nbsp;sisu &nbsp;-d &nbsp;--createdb</b> </dt>
-<dd>&nbsp;creates &nbsp;database &nbsp;where
-&nbsp;no &nbsp;database &nbsp;existed &nbsp;before &nbsp;as
-<p> </dd>
-
-<dt><b>&nbsp;sisu &nbsp;-d &nbsp;--create</b> </dt>
-<dd>&nbsp;creates &nbsp;database &nbsp;tables &nbsp;where
-&nbsp;no &nbsp;database &nbsp;tables &nbsp;existed before &nbsp;database &nbsp;tables &nbsp;where &nbsp;no &nbsp;database &nbsp;tables
-&nbsp;existed
-<p> </dd>
-
-<dt><b>&nbsp;sisu &nbsp;-d &nbsp;--dropall</b> </dt>
-<dd>&nbsp;destroys &nbsp;database &nbsp;(including &nbsp;all &nbsp;its &nbsp;content)!
-&nbsp;kills &nbsp;data and &nbsp;drops &nbsp;tables, &nbsp;indexes &nbsp;and &nbsp;database &nbsp;associated &nbsp;with &nbsp;a given
-&nbsp;directory &nbsp;(and &nbsp;directories &nbsp;of &nbsp;the &nbsp;same &nbsp;name). &nbsp;a
-<p> </dd>
-
-<dt><b>&nbsp;sisu &nbsp;-d &nbsp;--recreate</b> </dt>
-<dd>&nbsp;destroys
-
-<p>&nbsp;existing &nbsp;database &nbsp;and &nbsp;builds &nbsp;a &nbsp;new &nbsp;empty &nbsp;database &nbsp;structure
-<p> </dd>
-</dl>
-4.4.2 IMPORT
-
-<p>AND REMOVE DOCUMENTS
-<p>
-<dl>
-
-<dt><b>&nbsp;sisu &nbsp;-d &nbsp;--import &nbsp;-v &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>populates database
-with the contents of the file. Imports documents(s) specified to an sqlite
-database (at an object level).
-<p> </dd>
-
-<dt><b>&nbsp;sisu &nbsp;-d &nbsp;--update &nbsp;-v &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>updates
-
-<p>file contents in database
-<p> </dd>
-
-<dt><b>&nbsp;sisu &nbsp;-d &nbsp;--remove &nbsp;-v &nbsp;&nbsp;[filename/wildcard]</b> </dt>
-<dd>removes
-specified document from sqlite database.
-<p> </dd>
-</dl>
-5. INTRODUCTION
-<p> 5.1 SEARCH - DATABASE
-FRONTEND SAMPLE, UTILISING DATABASE AND SISU FEATURES, INCLUDING OBJECT
-CITATION NUMBERING (BACKEND CURRENTLY POSTGRESQL)
-<p> Sample search frontend
-&lt;<a href='http://search.sisudoc.org'>http://search.sisudoc.org</a>
-&gt; &nbsp;[^3] A small database and sample query front-end
-(search from) that makes use of the citation system, <i>object</i> citation numbering
-to demonstrates functionality.[^4]
-<p> <b>SiSU</b> can provide information on which
-documents are matched and at what locations within each document the matches
-are found. These results are relevant across all outputs using object citation
-numbering, which includes html, XML, LaTeX, PDF and indeed the SQL database.
-You can then refer to one of the other outputs or in the SQL database expand
-the text within the matched objects (paragraphs) in the documents matched.
-
-<p> Note you may set results either for documents matched and object number
-locations within each matched document meeting the search criteria; or
-display the names of the documents matched along with the objects (paragraphs)
-that meet the search criteria.[^5]
-<p>
-<dl>
-
-<dt><b>&nbsp;sisu &nbsp;-F &nbsp;--webserv-webrick</b> </dt>
-<dd>&nbsp;builds &nbsp;a &nbsp;cgi &nbsp;web
-
-<p>&nbsp;search &nbsp;frontend &nbsp;for &nbsp;the &nbsp;database &nbsp;created
-<p> The following is feedback on
-the setup on a machine provided by the help command:
-<p> sisu --help sql<br>
-
-<p>
-<p> <br>
-<pre> Postgresql
- user: ralph
- current db set: SiSU_sisu
- port: 5432
- dbi connect: DBI:Pg:database=SiSU_sisu;port=5432
- sqlite
- current db set: /home/ralph/sisu_www/sisu/sisu_sqlite.db
- dbi connect DBI:SQLite:/home/ralph/sisu_www/sisu/sisu_sqlite.db
-</pre>
-<p> Note on databases built
-<p> By default, &nbsp;[unless &nbsp;otherwise &nbsp;specified] databases
-are built on a directory basis, from collections of documents within that
-directory. The name of the directory you choose to work from is used as
-the database name, i.e. if you are working in a directory called /home/ralph/ebook
-the database SiSU_ebook is used. &nbsp;[otherwise &nbsp;a &nbsp;manual &nbsp;mapping &nbsp;for &nbsp;the &nbsp;collection
-&nbsp;is
-<p> </dd>
-</dl>
-5.2 SEARCH FORM
-<p>
-<dl>
-
-<dt><b>&nbsp;sisu &nbsp;-F</b> </dt>
-<dd>&nbsp;generates &nbsp;a &nbsp;sample &nbsp;search &nbsp;form, &nbsp;which &nbsp;must &nbsp;be
-&nbsp;copied &nbsp;to &nbsp;which &nbsp;must &nbsp;be &nbsp;copied &nbsp;to
-<p> </dd>
-
-<dt><b>&nbsp;sisu &nbsp;-F &nbsp;--webserv-webrick</b> </dt>
-<dd>&nbsp;generates &nbsp;a &nbsp;sample
-&nbsp;search &nbsp;form &nbsp;for &nbsp;use &nbsp;with &nbsp;the &nbsp;webrick &nbsp;which &nbsp;must &nbsp;be &nbsp;copied &nbsp;to &nbsp;the &nbsp;web-server
-&nbsp;cgi &nbsp;directory &nbsp;which &nbsp;must &nbsp;be &nbsp;copied &nbsp;to &nbsp;the &nbsp;web-server &nbsp;cgi &nbsp;directory
-<p> </dd>
-
-<dt><b>&nbsp;sisu
-&nbsp;-Fv</b> </dt>
-<dd>&nbsp;as &nbsp;above, &nbsp;and &nbsp;provides &nbsp;some &nbsp;information &nbsp;on &nbsp;setting &nbsp;up
-<p> </dd>
-
-<dt><b>&nbsp;sisu &nbsp;-W</b> </dt>
-<dd>&nbsp;starts
-
-<p>&nbsp;the &nbsp;webrick &nbsp;server &nbsp;which &nbsp;should &nbsp;be &nbsp;available
-<p> The generated search form
-
-<p>must be copied manually to the webserver directory as instructed
-<p> </dd>
-</dl>
-6. HYPERESTRAIER
-
-<p> See the documentation for hyperestraier:
-<p> &lt;<a href='http://hyperestraier.sourceforge.net/'>http://hyperestraier.sourceforge.net/</a>
-&gt;<br>
-
-<p> /usr/share/doc/hyperestraier/index.html<br>
-
-<p> man estcmd<br>
-
-<p> on sisu_hyperestraier:
-<p> man sisu_hyperestraier<br>
-
-<p> /usr/share/doc/sisu/sisu_markup/sisu_hyperestraier/index.html<br>
-
-<p> NOTE: the examples that follow assume that sisu output is placed in
-
-<p>the directory /home/ralph/sisu_www
-<p> (A) to generate the index within the
-webserver directory to be indexed:
-<p> estcmd gather -sd &nbsp;[index &nbsp;name] &nbsp;[directory
-&nbsp;path &nbsp;to &nbsp;index]<br>
-
-<p> the following are examples that will need to be tailored according to
-your needs:
-<p> cd /home/ralph/sisu_www<br>
-
-<p> estcmd gather -sd casket /home/ralph/sisu_www<br>
-
-<p> you may use the &rsquo;find&rsquo; command together with &rsquo;egrep&rsquo; to limit indexing to
-particular document collection directories within the web server directory:
-
-<p> find /home/ralph/sisu_www -type f | egrep<br>
- &rsquo;/home/ralph/sisu_www/sisu/.+?.html$&rsquo; |estcmd gather -sd casket -<br>
-
-<p> Check which directories in the webserver/output directory (~/sisu_www
-or elsewhere depending on configuration) you wish to include in the search
-index.
-<p> As sisu duplicates output in multiple file formats, it it is probably
-preferable to limit the estraier index to html output, and as it may also
-be desirable to exclude files &rsquo;plain.txt&rsquo;, &rsquo;toc.html&rsquo; and &rsquo;concordance.html&rsquo;, as
-these duplicate information held in other html output e.g.
-<p> find /home/ralph/sisu_www
--type f | egrep<br>
- &rsquo;/sisu_www/(sisu|bookmarks)/.+?.html$&rsquo; | egrep -v<br>
- &rsquo;(doc|concordance).html$&rsquo; |estcmd gather -sd casket -<br>
-
-<p> from your current document preparation/markup directory, you would construct
-a rune along the following lines:
-<p> find /home/ralph/sisu_www -type f
-| egrep &rsquo;/home/ralph/sisu_www/([specify <br>
- first &nbsp;directory &nbsp;for &nbsp;inclusion]|[specify &nbsp;second &nbsp;directory &nbsp;for <br>
- inclusion]|[another &nbsp;directory &nbsp;for &nbsp;inclusion? &nbsp;...])/.+?.html$&rsquo; |<br>
- egrep -v &rsquo;(doc|concordance).html$&rsquo; |estcmd gather -sd<br>
- /home/ralph/sisu_www/casket -<br>
-
-<p> (B) to set up the search form
-<p> (i) copy estseek.cgi to your cgi directory
-and set file permissions to 755:
-<p> sudo cp -vi /usr/lib/estraier/estseek.cgi
-/usr/lib/cgi-bin<br>
-
-<p> sudo chmod -v 755 /usr/lib/cgi-bin/estseek.cgi<br>
-
-<p> sudo cp -v /usr/share/hyperestraier/estseek.* /usr/lib/cgi-bin<br>
-
-<p> &nbsp;[see &nbsp;estraier &nbsp;documentation &nbsp;for &nbsp;paths]<br>
-
-<p> (ii) edit estseek.conf, with attention to the lines starting &rsquo;indexname:&rsquo;
-and &rsquo;replace:&rsquo;:
-<p> indexname: /home/ralph/sisu_www/casket<br>
-
-<p> replace: ^file:///home/ralph/sisu_www{{!}}<a href='http://localhost'>http://localhost</a>
-<br>
-
-<p> replace: /index.html?${{!}}/<br>
-
-<p> (C) to test using webrick, start webrick:
-<p> sisu -W<br>
-
-<p> and try open the url: &lt;<a href='http://localhost:8081/cgi-bin/estseek.cgi'>http://localhost:8081/cgi-bin/estseek.cgi</a>
-&gt;
-<p> DOCUMENT
-INFORMATION (METADATA)
-<p> METADATA
-<p> Document Manifest @ &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_search/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_search/sisu_manifest.html</a>
-&gt;
-
-<p> <b>Dublin Core</b> (DC)
-<p> <i>DC</i> tags included with this document are provided here.
-
-<p> DC Title: <i>SiSU</i> - Search
-<p> DC Creator: <i>Ralph</i> Amissah
-<p> DC Rights: <i>Copyright</i>
-(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
-<p> DC
-Type: <i>information</i>
-<p> DC Date created: <i>2002-08-28</i>
-<p> DC Date issued: <i>2002-08-28</i>
-
-<p> DC Date available: <i>2002-08-28</i>
-<p> DC Date modified: <i>2007-09-16</i>
-<p> DC Date: <i>2007-09-16</i>
-
-<p> <b>Version Information</b>
-<p> Sourcefile: <i>sisu_search._sst</i>
-<p> Filetype: <i>SiSU</i> text
-
-<p>insert 0.58
-<p> Sourcefile Digest, MD5(sisu_search._sst)= <i>c085c2eb6d68f1b7d50435f673ede407</i>
-
-<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-
-<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i>
-<p> <b>Generated</b>
-<p> Document (metaverse) last
-generated: <i>Mon</i> Sep 24 15:36:19 +0100 2007
-<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of
-2007w38/0 (2007-09-23)
-<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36)
-&nbsp;[i486-linux]
-<p>
-<ol>
-<b>.</b><li>&lt;<a href='http://www.postgresql.org/'>http://www.postgresql.org/</a>
-&gt; &lt;<a href='http://advocacy.postgresql.org/'>http://advocacy.postgresql.org/</a>
-&gt;<br>
- &lt;<a href='http://en.wikipedia.org/wiki/Postgresql'>http://en.wikipedia.org/wiki/Postgresql</a>
-&gt;<br>
- </li><b>.</b><li>&lt;<a href='http://www.hwaci.com/sw/sqlite/'>http://www.hwaci.com/sw/sqlite/</a>
-&gt; &lt;<a href='http://en.wikipedia.org/wiki/Sqlite'>http://en.wikipedia.org/wiki/Sqlite</a>
-&gt;<br>
- </li><b>.</b><li>&lt;<a href='http://search.sisudoc.org'>http://search.sisudoc.org</a>
-&gt; </li><b>.</b><li>(which could be extended further with current
-back-end). As regards scaling of the database, it is as scalable as the database
-(here Postgresql) and hardware allow. </li><b>.</b><li>of this feature when demonstrated
-to an IBM software innovations evaluator in 2004 he said to paraphrase:
-this could be of interest to us. We have large document management systems,
-you can search hundreds of thousands of documents and we can tell you which
-documents meet your search criteria, but there is no way we can tell you
-without opening each document where within each your matches are found.
-
-<p> </dd>
-
-<dt>Other versions of this document: </dt>
-<dd></dd>
-
-<dt>manifest: &lt;<a href='http://www.jus.uio.no/sisu/sisu_search/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_search/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_search/sisu_manifest.html</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>html: &lt;<a href='http://www.jus.uio.no/sisu/sisu_search/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_search/toc.html'>http://www.jus.uio.no/sisu/sisu_search/toc.html</a>
-</a>
-&gt; </dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_search/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_search/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_search/portrait.pdf</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_search/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_search/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_search/landscape.pdf</a>
-</a>
-&gt; </dt>
-<dd> </dd>
-
-<dt>at: &lt;<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt>
-<dd></dd>
-
-<dt>* Ruby version: ruby
-1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt>
-<dd></dd>
-
-<dt>* Last Generated on: Mon Sep 24
-15:36:32 +0100 2007 </dt>
-<dd></dd>
-
-<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
- </dt>
-<dd></dd>
-</dl>
-<p>
-</body>
-</html>
diff --git a/data/doc/sisu/html/sisu_skin.1.html b/data/doc/sisu/html/sisu_skin.1.html
deleted file mode 100644
index 84b90fa5..00000000
--- a/data/doc/sisu/html/sisu_skin.1.html
+++ /dev/null
@@ -1,162 +0,0 @@
-<!-- manual page source format generated by PolyglotMan v3.2, -->
-<!-- available at http://polyglotman.sourceforge.net/ -->
-
-<html>
-<head>
-<title>"sisu_skin"("1") manual page</title>
-</head>
-<body bgcolor='white'>
-<a href='#toc'>Table of Contents</a><p>
-SISU - SKINS, RALPH AMISSAH
-<p> DOCUMENT SKINS - CONFIGURATION
-<p> 1. SKINS
-<p>
- Skins modify the default appearance of document output on a document,
-directory, or site wide basis. Skins are looked for in the following locations:
-
-<p> ./_sisu/skin<br>
-
-<p> ~/.sisu/skin<br>
-
-<p> /etc/sisu/skin<br>
-
-<p> <b>Within the skin directory</b> are the following the default sub-directories
-for document skins:
-<p> ./skin/doc<br>
-
-<p> ./skin/dir<br>
-
-<p> ./skin/site<br>
-
-<p> A skin is placed in the appropriate directory and the file named skin_[name].rb
-
-<p> The skin itself is a ruby file which modifies the default appearances
-set in the program.
-<p> 1.1 DOCUMENT SKIN
-<p> Documents take on a document skin,
-if the header of the document specifies a skin to be used.
-<p>
-<p> <br>
-<pre> @skin: skin_united_nations
-</pre>
-<p> 1.2 DIRECTORY SKIN
-<p> 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).
-<p> 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.
-
-<p> 1.3 SITE SKIN
-<p> A site skin, modifies the program default skin.
-<p> 1.4 SAMPLE
-
-<p>SKINS
-<p> With <b>SiSU</b> installed sample skins may be found in:
-<p> /etc/sisu/skin/doc
-and<br>
- /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc<br>
-
-<p> (or equivalent directory) and if sisu-markup-samples is installed also
-under:
-<p> /usr/share/doc/sisu/sisu_markup_samples/non-free/_sisu/skin/doc<br>
-
-<p> Samples of list.yml and promo.yml (which are used to create the right
-column list) may be found in:
-<p> /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml
-(or equivalent<br>
- directory)<br>
-
-<p> DOCUMENT INFORMATION (METADATA)
-<p> METADATA
-<p> Document Manifest @ &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/sisu_manifest.html</a>
-&gt;
-
-<p> <b>Dublin Core</b> (DC)
-<p> <i>DC</i> tags included with this document are provided here.
-
-<p> DC Title: <i>SiSU</i> - Skins
-<p> DC Creator: <i>Ralph</i> Amissah
-<p> DC Rights: <i>Copyright</i>
-(C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
-<p> DC
-Type: <i>information</i>
-<p> DC Date created: <i>2002-11-12</i>
-<p> DC Date issued: <i>2002-11-12</i>
-
-<p> DC Date available: <i>2002-11-12</i>
-<p> DC Date modified: <i>2007-09-16</i>
-<p> DC Date: <i>2007-09-16</i>
-
-<p> <b>Version Information</b>
-<p> Sourcefile: <i>sisu_skin.sst</i>
-<p> Filetype: <i>SiSU</i> text
-
-<p>insert 0.58
-<p> Sourcefile Digest, MD5(sisu_skin.sst)= <i>8aebfb5312045c3a705ad6c314246f67</i>
-
-<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-
-<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i>
-<p> <b>Generated</b>
-<p> Document (metaverse) last
-generated: <i>Mon</i> Sep 24 15:36:15 +0100 2007
-<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of
-2007w38/0 (2007-09-23)
-<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36)
-&nbsp;[i486-linux]
-<p>
-<p>
-<dl>
-
-<dt>Other versions of this document: </dt>
-<dd></dd>
-
-<dt>manifest: &lt;<a href='http://www.jus.uio.no/sisu/sisu_skin/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_skin/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_skin/sisu_manifest.html</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>html: &lt;<a href='http://www.jus.uio.no/sisu/sisu_skin/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_skin/toc.html'>http://www.jus.uio.no/sisu/sisu_skin/toc.html</a>
-</a>
-&gt; </dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_skin/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_skin/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_skin/portrait.pdf</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_skin/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_skin/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_skin/landscape.pdf</a>
-</a>
-&gt; </dt>
-<dd> </dd>
-
-<dt>at: &lt;<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) </dt>
-<dd></dd>
-
-<dt>* Ruby version: ruby
-1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt>
-<dd></dd>
-
-<dt>* Last Generated on: Mon Sep 24
-15:36:31 +0100 2007 </dt>
-<dd></dd>
-
-<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
- </dt>
-<dd></dd>
-</dl>
-<p>
-</body>
-</html>
diff --git a/data/doc/sisu/html/sisu_syntax_highlighting.8.html b/data/doc/sisu/html/sisu_syntax_highlighting.8.html
deleted file mode 100644
index 3eb27e48..00000000
--- a/data/doc/sisu/html/sisu_syntax_highlighting.8.html
+++ /dev/null
@@ -1,219 +0,0 @@
-<!-- manual page source format generated by PolyglotMan v3.2, -->
-<!-- available at http://polyglotman.sourceforge.net/ -->
-
-<html>
-<head>
-<title>"sisu_syntax_highlighting"("1") manual page</title>
-</head>
-<body bgcolor='white'>
-<a href='#toc'>Table of Contents</a><p>
-SISU - SYNTAX HIGHLIGHTING, RALPH AMISSAH
-<p> SISU SYNTAX HIGHLIGHTING
-<p> 1.
-EDITOR FILES, SYNTAX HIGHLIGHTING
-<p> The directory:
-<p> ./data/sisu/conf/editor-syntax-etc/<br>
-
-<p> /usr/share/sisu/conf/editor-syntax-etc<br>
-
-<p> contains rudimentary sisu syntax highlighting files for:
-<p> * (g)vim
-&lt;<a href='http://www.vim.org'>http://www.vim.org</a>
-&gt;
-<p> package: sisu-vim<br>
-
-<p> status: largely done
-<p> there is a vim syntax highlighting and folds
-component<br>
-
-<p> * gedit &lt;<a href='http://www.gnome.org/projects/gedit'>http://www.gnome.org/projects/gedit</a>
-&gt;
-<p> * gobby &lt;<a href='http://gobby.0x539.de/'>http://gobby.0x539.de/</a>
-&gt;
-
-<p> file: sisu.lang<br>
-
-<p> place in:
-<p> /usr/share/gtksourceview-1.0/language-specs<br>
-
-<p> or
-<p> ~/.gnome2/gtksourceview-1.0/language-specs<br>
-
-<p> status: very basic syntax highlighting<br>
-
-<p> comments: this editor features display line wrap and is used by Goby!<br>
-
-<p> * nano &lt;<a href='http://www.nano-editor.org'>http://www.nano-editor.org</a>
-&gt;
-<p> file: nanorc<br>
-
-<p> save as:
-<p> ~/.nanorc<br>
-
-<p> status: basic syntax highlighting<br>
-
-<p> comments: assumes dark background; no display line-wrap; does line
-breaks<br>
-
-<p> * diakonos (an editor written in ruby) &lt;<a href='http://purepistos.net/diakonos'>http://purepistos.net/diakonos</a>
-&gt;
-
-<p> file: diakonos.conf
-<p> save as:
-<p> ~/.diakonos/diakonos.conf<br>
-
-<p> includes:
-<p> status: basic syntax highlighting<br>
-
-<p> comments: assumes dark background; no display line-wrap
-<p> * kate &amp; kwrite
-&lt;<a href='http://kate.kde.org'>http://kate.kde.org</a>
-&gt;
-<p> file: sisu.xml<br>
-
-<p> place in:<br>
-
-<p> /usr/share/apps/katepart/syntax<br>
-
-<p> or<br>
-
-<p> ~/.kde/share/apps/katepart/syntax<br>
-
-<p> &nbsp;[settings::configure &nbsp;kate::{highlighting,filetypes}]<br>
-
-<p> &nbsp;[tools::highlighting::{markup,scripts}::<br>
- <b>&nbsp;SiSU</b> ]
-<p> * nedit &lt;<a href='http://www.nedit.org'>http://www.nedit.org</a>
-&gt;
-<p> file: sisu_nedit.pats<br>
-
-<p> nedit -import sisu_nedit.pats<br>
-
-<p> status: a very clumsy first attempt &nbsp;[not &nbsp;really &nbsp;done]<br>
-
-<p> comments: this editor features display line wrap<br>
-
-<p> * emacs &lt;<a href='http://www.gnu.org/software/emacs/emacs.html'>http://www.gnu.org/software/emacs/emacs.html</a>
-&gt;
-<p> files: sisu-mode.el<br>
-
-<p> to file ~/.emacs add the following 2 lines:<br>
-
-<p> (add-to-list &rsquo;load-path<br>
-
-<p> (require &rsquo;sisu-mode.el)<br>
-
-<p> &nbsp;[not &nbsp;done &nbsp;/ &nbsp;not &nbsp;yet &nbsp;included]<br>
-
-<p> * vim &amp; gvim &lt;<a href='http://www.vim.org'>http://www.vim.org</a>
-&gt;
-<p> files:<br>
-
-<p> package is the most comprehensive sisu syntax highlighting and editor<br>
- environment provided to date (is for vim/ gvim, and is separate from
-the<br>
- contents of this directory)<br>
-
-<p> status: this includes: syntax highlighting; vim folds; some error
-checking<br>
-
-<p> comments: this editor features display line wrap<br>
-
-<p> NOTE:
-<p> [ <b>&nbsp;SiSU</b> &nbsp;parses &nbsp;files &nbsp;with &nbsp;long &nbsp;lines &nbsp;or &nbsp;line &nbsp;breaks, &nbsp;but, &nbsp;display
-&nbsp;linewrap &nbsp;(without &nbsp;line-breaks) &nbsp;is &nbsp;a &nbsp;convenient &nbsp;editor &nbsp;feature &nbsp;to &nbsp;have &nbsp;for
-&nbsp;sisu &nbsp;markup]
-<p> DOCUMENT INFORMATION (METADATA)
-<p> METADATA
-<p> Document Manifest
-@ &lt;<a href='http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/sisu_manifest.html</a>
-&gt;
-
-<p> <b>Dublin Core</b> (DC)
-<p> <i>DC</i> tags included with this document are provided here.
-
-<p> DC Title: <i>SiSU</i> - Syntax Highlighting
-<p> DC Creator: <i>Ralph</i> Amissah
-<p> DC
-Rights: <i>Copyright</i> (C) Ralph Amissah 2007, part of SiSU documentation, License
-
-<p>GPL 3
-<p> DC Type: <i>information</i>
-<p> DC Date created: <i>2002-11-12</i>
-<p> DC Date issued:
-
-<p><i>2002-11-12</i>
-<p> DC Date available: <i>2002-11-12</i>
-<p> DC Date modified: <i>2007-09-16</i>
-<p> DC
-Date: <i>2007-09-16</i>
-<p> <b>Version Information</b>
-<p> Sourcefile: <i>sisu_syntax_highlighting.sst</i>
-
-<p> Filetype: <i>SiSU</i> text insert 0.58
-<p> Sourcefile Digest, MD5(sisu_syntax_highlighting.sst)=
-
-<p><i>28dd0275c6fcd67bbedcd8aee9df4b3e</i>
-<p> Skin_Digest: MD5(/home/ralph/grotto/theatre/dbld/sisu-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-
-<p><i>20fc43cf3eb6590bc3399a1aef65c5a9</i>
-<p> <b>Generated</b>
-<p> Document (metaverse) last
-generated: <i>Mon</i> Sep 24 15:36:17 +0100 2007
-<p> Generated by: <i>SiSU</i> <i>0.59.0</i> of
-2007w38/0 (2007-09-23)
-<p> Ruby version: <i>ruby</i> 1.8.6 (2007-06-07 patchlevel 36)
-&nbsp;[i486-linux]
-<p>
-<p>
-<dl>
-
-<dt>Other versions of this document: </dt>
-<dd></dd>
-
-<dt>manifest: &lt;<a href='http://www.jus.uio.no/sisu/sisu_syntax_highlighting/sisu_manifest.html'><a href='http://www.jus.uio.no/sisu/sisu_syntax_highlighting/sisu_manifest.html'>http://www.jus.uio.no/sisu/sisu_syntax_highlighting/sisu_manifest.html</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>html: &lt;<a href='http://www.jus.uio.no/sisu/sisu_syntax_highlighting/toc.html'><a href='http://www.jus.uio.no/sisu/sisu_syntax_highlighting/toc.html'>http://www.jus.uio.no/sisu/sisu_syntax_highlighting/toc.html</a>
-</a>
-&gt; </dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_syntax_highlighting/portrait.pdf'><a href='http://www.jus.uio.no/sisu/sisu_syntax_highlighting/portrait.pdf'>http://www.jus.uio.no/sisu/sisu_syntax_highlighting/portrait.pdf</a>
-</a>
-&gt;
-</dt>
-<dd></dd>
-
-<dt>pdf: &lt;<a href='http://www.jus.uio.no/sisu/sisu_syntax_highlighting/landscape.pdf'><a href='http://www.jus.uio.no/sisu/sisu_syntax_highlighting/landscape.pdf'>http://www.jus.uio.no/sisu/sisu_syntax_highlighting/landscape.pdf</a>
-</a>
-&gt; </dt>
-<dd> </dd>
-
-<dt>at:
-&lt;<a href='http://www.jus.uio.no/sisu'><a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
-</a>
-&gt; </dt>
-<dd></dd>
-
-<dt>* Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23)
-</dt>
-<dd></dd>
-
-<dt>* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux] </dt>
-<dd></dd>
-
-<dt>* Last Generated
-on: Mon Sep 24 15:36:32 +0100 2007 </dt>
-<dd></dd>
-
-<dt>* SiSU <a href='http://www.jus.uio.no/sisu'>http://www.jus.uio.no/sisu</a>
- </dt>
-<dd></dd>
-</dl>
-<p>
-</body>
-</html>
diff --git a/data/doc/sisu/sisu_markup_samples/sisu_manual/Rantfile b/data/doc/sisu/sisu_markup_samples/sisu_manual/Rantfile
index f62b7f5e..e9cba974 100644
--- a/data/doc/sisu/sisu_markup_samples/sisu_manual/Rantfile
+++ b/data/doc/sisu/sisu_markup_samples/sisu_manual/Rantfile
@@ -163,7 +163,8 @@ def man_section(files_array,man_no='1')
unless man_no =~/^1$/
system("mv -v #{path_man_sisu_output}/#{x} #{path_man_sisu_output}/#{y}")
end
- system("cp -v #{path_man_sisu_output}/#{y} #{path_man_sisu_package}/man#{man_no}/#{y}")
+ puts "cp -v #{path_man_sisu_output}/#{y} #{path_man_sisu_package}/man#{man_no}/#{y}"
+ #system("cp -v #{path_man_sisu_output}/#{y} #{path_man_sisu_package}/man#{man_no}/#{y}")
end
end
def manpage_move
diff --git a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm
index 7e7a1add..50bd7dc9 100644
--- a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm
+++ b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm
@@ -26,6 +26,12 @@
@skin: skin_sisu_manual
+@man: 8;
+name=sisu - documents: structuring, publishing in multiple formats, and search;
+synopsis=sisu [-abcDdFHhIiMmNnopqRrSsTtUuVvwXxYyZz0-9] [filename/wildcard ]
+sisu [-Ddcv] [instruction]
+sisu [-CcFLSVvW]
+
@bold: /Gnu|Debian|Ruby|SiSU/
@links: { SiSU Manual }http://www.jus.uio.no/sisu/sisu_manual/
diff --git a/lib/sisu/v0/hub.rb b/lib/sisu/v0/hub.rb
index 47326b88..82ccc614 100644
--- a/lib/sisu/v0/hub.rb
+++ b/lib/sisu/v0/hub.rb
@@ -547,7 +547,7 @@ p "here #{__FILE__} #{__LINE__}" if @opt =~/M/
if @opt.mod.inspect =~/--help/ and not @opt.what.empty?; SiSU_Help::Help.new(@opt.what).help_request
elsif @opt.mod.inspect =~/--help/; SiSU_Help::Help.new('list').help_request
else SiSU_Help::Help.new('env',@opt).sisu_version
- puts " for HELP type:\n\tsisu --help [help request]\n\tman sisu\n or see the system or online documentation"
+ tell=SiSU_Screen::Ansi.new(''," for HELP type:\n\tsisu --help [help request]\n\tman sisu\n or see the system or online documentation on SiSU:\n #{Config::CONFIG['datadir']}/doc/sisu/\n <http://www.jus.uio.no/sisu/>\n <http://sisudoc.org/>"); tell.puts_grey
end
end
end
diff --git a/lib/sisu/v0/manpage.rb b/lib/sisu/v0/manpage.rb
index 5b2cef6f..768fbc48 100644
--- a/lib/sisu/v0/manpage.rb
+++ b/lib/sisu/v0/manpage.rb
@@ -473,7 +473,7 @@ WOK
else '2007' #date missing decide on action
end
proj=SiSU_Env::Info_version.new.get_version
- manpage[:open] = %{.TH "#{@md.fnb}" "1" "#{date}" "#{proj[:version]}" "#{@md.title}"}
+ manpage[:open] = %{.TH "#{@md.fnb}" "1" "#{date}" "#{proj[:version]}" "#{@md.title}"#{@md.man_name}#{@md.man_synopsis}}
content << manpage[:open]
content << manpage[:head]
content << manpage[:body]
@@ -493,6 +493,7 @@ WOK
end
def manpage #%manpage output
SiSU_Env::SiSU_file.new(@md).mkdir
+ #filename_manpage=SiSU_Env::SiSU_file.new(@md,"#{@md.fnb}.#{@md.man_section}").mkfile_man
filename_manpage=SiSU_Env::SiSU_file.new(@md,@md.fn[:manpage]).mkfile_man
@sisu=[]
@content.each do |para| # this is a hack
diff --git a/lib/sisu/v0/param.rb b/lib/sisu/v0/param.rb
index 446c2d46..a2036b8a 100644
--- a/lib/sisu/v0/param.rb
+++ b/lib/sisu/v0/param.rb
@@ -113,9 +113,11 @@ module SiSU_Param
@doc={ :lv=>[] }
@doc[:fns],@doc[:fnb],@doc[:scr_suffix]='','',''
@@publisher='SiSU scribe'
- attr_accessor :cmd,:mod,:env,:fn,:fns,:fnb,:fnn,:fnt,:fnl,:flv,:fnstex,:ocn,:sfx_src,:sfx,:pdf,:file_type,:dir_out,:dir_tex,:dir_lout,:txt_path,:site_skin,:sisu,:sisu_version,:ruby_version,:title,:dc_title,:html_title,:subtitle,:subtitle_tex,:creator_home,:dc_creator,:translator,:illustrator,:prepared_by,:digitized_by,:dc_subject,:dc_description,:dc_publisher,:dc_contributor,:dc_date,:dc_date_created,:dc_date_issued,:dc_date_available,:dc_date_valid,:dc_date_modified,:date_scheme,:date_created_scheme,:date_issued_scheme,:date_available_scheme,:date_valid_scheme,:date_modified_scheme,:dc_type,:dc_format,:dc_identifier,:dc_source,:dc_language,:language_original,:dc_relation,:dc_coverage,:dc_rights,:keywords,:comments,:abstract,:cls_loc,:cls_dewey,:cls_pg,:cls_isbn,:papersize,:toc,:lv1,:lv2,:lv3,:lv4,:lv5,:lv6,:pagenew,:pagebreak,:num_top,:toc_lev_limit,:flag_endnotes,:flag_auto_endnotes,:flag_separate_endnotes,:flag_separate_endnotes_make,:flag_auto_heading_num,:markup,:markup_instruction,:markup_version,:markup_declared,:make_bold,:make_italic,:flag_pdf,:flag_tables,:vocabulary,:doc_skin,:doc_css,:yaml,:lnk,:prefix_a,:prefix_b,:suffix,:information,:contact,:icon,:image,:ad_url,:ad_png,:ad_alt,:ad_began,:flag_promo,:promo,:ad_home,:stmp,:stmpd,:sc_filename,:sc_number,:sc_date,:sc_time,:sc_info,:yamladdr,:locale,:wc_lines,:wc_words,:wc_bytes,:file_encoding,:file_size,:user,:home,:hostname,:pwd,:firstseg,:programs,:creator_copymark,:lang,:en,:dgst,:dgst_skin,:generated,:tags,:tag_array,:concord_make,:seg_names,:seg_autoname_safe,:set_header_title,:set_heading_top,:set_heading_seg,:heading_seg_first,:heading_seg_first_flag,:base_program
+ attr_accessor :cmd,:mod,:env,:fn,:fns,:fnb,:fnn,:fnt,:fnl,:flv,:fnstex,:ocn,:sfx_src,:sfx,:pdf,:file_type,:dir_out,:dir_tex,:dir_lout,:txt_path,:site_skin,:sisu,:sisu_version,:ruby_version,:title,:dc_title,:html_title,:subtitle,:subtitle_tex,:creator_home,:dc_creator,:translator,:illustrator,:prepared_by,:digitized_by,:dc_subject,:dc_description,:dc_publisher,:dc_contributor,:dc_date,:dc_date_created,:dc_date_issued,:dc_date_available,:dc_date_valid,:dc_date_modified,:date_scheme,:date_created_scheme,:date_issued_scheme,:date_available_scheme,:date_valid_scheme,:date_modified_scheme,:dc_type,:dc_format,:dc_identifier,:dc_source,:dc_language,:language_original,:dc_relation,:dc_coverage,:dc_rights,:keywords,:comments,:abstract,:cls_loc,:cls_dewey,:cls_pg,:cls_isbn,:papersize,:toc,:lv1,:lv2,:lv3,:lv4,:lv5,:lv6,:pagenew,:pagebreak,:num_top,:toc_lev_limit,:flag_endnotes,:flag_auto_endnotes,:flag_separate_endnotes,:flag_separate_endnotes_make,:flag_auto_heading_num,:markup,:markup_instruction,:markup_version,:markup_declared,:make_bold,:make_italic,:flag_pdf,:flag_tables,:vocabulary,:doc_skin,:doc_css,:yaml,:lnk,:prefix_a,:prefix_b,:suffix,:information,:contact,:icon,:image,:ad_url,:ad_png,:ad_alt,:ad_began,:flag_promo,:promo,:ad_home,:stmp,:stmpd,:sc_filename,:sc_number,:sc_date,:sc_time,:sc_info,:yamladdr,:locale,:wc_lines,:wc_words,:wc_bytes,:file_encoding,:file_size,:user,:home,:hostname,:pwd,:firstseg,:programs,:creator_copymark,:lang,:en,:dgst,:dgst_skin,:generated,:tags,:tag_array,:concord_make,:seg_names,:seg_autoname_safe,:set_header_title,:set_heading_top,:set_heading_seg,:heading_seg_first,:heading_seg_first_flag,:base_program,:man_section,:man_name,:man_synopsis
def initialize(fns_array,opt)
- @env=@fn=@fns=@fnb=@fnn=@fnt=@fnl=@flv=@fnstex=@ocn=@sfx_src=@sfx=@pdf=@file_type=@dir_out=@dir_tex=@dir_lout=@txt_path=@flag_endnotes=@flag_auto_endnotes=@flag_separate_endnotes=@flag_separate_endnotes_make=@site_skin=@sisu=@sisu_version=@ruby_version=@title=@dc_title=@html_title=@subtitle=@subtitle_tex=@creator_home=@dc_creator=@translator=@illustrator=@prepared_by=@digitized_by=@dc_subject=@dc_description=@dc_publisher=@dc_contributor=@dc_date=@dc_date_created=@dc_date_issued=@dc_date_available=@dc_date_valid=@dc_date_modified=@date_scheme=@date_created_scheme=@date_issued_scheme=@date_available_scheme=@date_valid_scheme=@date_modified_scheme=@dc_type=@dc_format=@dc_identifier=@dc_source=@dc_language=@language_original=@dc_relation=@dc_coverage=@dc_rights=@keywords=@comments=@abstract=@cls_loc=@cls_dewey=@cls_pg=@cls_isbn=@papersize=@toc=@lv1=@lv2=@lv3=@lv4=@lv5=@lv6=@pagenew=@pagebreak=@num_top=@toc_lev_limit=@flag_auto_heading_num=@make_bold=@make_italic=@flag_pdf=@flag_tables=@vocabulary=@doc_skin=@doc_css=@yaml=@lnk=@prefix_a=@prefix_b=@suffix=@information=@contact=@icon=@ad_url=@ad_png=@ad_alt=@ad_began=@promo=@ad_home=@stmp=@stmpd=@sc_filename=@sc_number=@sc_date=@sc_time=@sc_info=@yamladdr=@locale=@wc_lines=@wc_words=@wc_bytes=@file_encoding=@file_size=@firstseg=@programs=@creator_copymark=@lang=@en=@dgst=@dgst_skin=@generated=@heading_seg_first=@base_program=nil
+ @env=@fn=@fns=@fnb=@fnn=@fnt=@fnl=@flv=@fnstex=@ocn=@sfx_src=@sfx=@pdf=@file_type=@dir_out=@dir_tex=@dir_lout=@txt_path=@flag_endnotes=@flag_auto_endnotes=@flag_separate_endnotes=@flag_separate_endnotes_make=@site_skin=@sisu=@sisu_version=@ruby_version=@title=@dc_title=@html_title=@subtitle=@subtitle_tex=@creator_home=@dc_creator=@translator=@illustrator=@prepared_by=@digitized_by=@dc_subject=@dc_description=@dc_publisher=@dc_contributor=@dc_date=@dc_date_created=@dc_date_issued=@dc_date_available=@dc_date_valid=@dc_date_modified=@date_scheme=@date_created_scheme=@date_issued_scheme=@date_available_scheme=@date_valid_scheme=@date_modified_scheme=@dc_type=@dc_format=@dc_identifier=@dc_source=@dc_language=@language_original=@dc_relation=@dc_coverage=@dc_rights=@keywords=@comments=@abstract=@cls_loc=@cls_dewey=@cls_pg=@cls_isbn=@papersize=@toc=@lv1=@lv2=@lv3=@lv4=@lv5=@lv6=@pagenew=@pagebreak=@num_top=@toc_lev_limit=@flag_auto_heading_num=@make_bold=@make_italic=@flag_pdf=@flag_tables=@vocabulary=@doc_skin=@doc_css=@yaml=@lnk=@prefix_a=@prefix_b=@suffix=@information=@contact=@icon=@ad_url=@ad_png=@ad_alt=@ad_began=@promo=@ad_home=@stmp=@stmpd=@sc_filename=@sc_number=@sc_date=@sc_time=@sc_info=@yamladdr=@locale=@wc_lines=@wc_words=@wc_bytes=@file_encoding=@file_size=@firstseg=@programs=@creator_copymark=@lang=@en=@dgst=@dgst_skin=@generated=@heading_seg_first=@base_program=@man_synopsis=nil
+ @man_section=1
+ @man_name='man page "name/whatis" information not provided, set in header @man: name=[whatis information]'
@data,@fns,@cmd,@mod,@opt=fns_array,opt.fns,opt.cmd,opt.mod,opt #@data used as data
@flag_tables,@set_header_title,@set_heading_top,@set_heading_seg,@heading_seg_first_flag,@flag_promo=false,false,false,false,false,false
@seg_autoname_safe=true
@@ -235,12 +237,11 @@ module SiSU_Param
tell.warn unless @cmd =~/q/
end
@code_flag=false
- fns_array.each do |par| #% Scan document
- para=par.gsub(/\n/,' ')
+ fns_array.each do |para| #% Scan document
if para !~/^\%+\s/ and para =~/<![abcdeghijklmnopqrstuvwxyz]/i # <!f not included
raise "Old markup style in file #@fns, current version #{@sisu_version[:project]} #{@sisu_version[:version]} #{@sisu_version[:date_stamp]} #{@sisu_version[:date]}:\n\t\t#{para}\n\n"
end
- @code_flag=case par
+ @code_flag=case para
when /^code\{\s*$/; true
when /^\}code\s*$/; false
else @code_flag
@@ -364,7 +365,7 @@ module SiSU_Param
when /^(?:0~comments?|@comments?:?)\s+(.+?)$/m; @comments=$1 #% metainfo DC
when /^(?:0~abstract|@abstract)\s+(.+?)$/m; @abstract=$1 #% metainfo DC
when /^(?:0~tags?|@tags?:)\s+\S/m #% metainfo
- tags=par.match(/^(?:0~tags?|@tags?:)\s+(.+)$/m)[1]
+ tags=para.match(/^(?:0~tags?|@tags?:)\s+(.+)$/m)[1]
tags.split(/,|$/).each do |tag|
tag.strip!
@tags << tag
@@ -511,6 +512,14 @@ module SiSU_Param
@sc_info=true if para[/(?:0~(?:rcs|cvs)|@(?:rcs|cvs):)\+/]
when /^@base_program:\s+(.+?)$/; @base_program=$1 #% processing
#% break - break, not necessary to process headers further :-) but necessary to extract endnotes etc. ;-(
+ when /^(?:0~man|@man:)\s+(.+?)\Z/m #% man pages
+ maninfo_str=$1
+ maninfo=maninfo_str.split(/;\s*/m)
+ maninfo.each do |x|
+ @man_section= x[/^([1-8])/] if x =~/^([1-8])/
+ @man_name= x[/name=(.+)/,1] if x =~/name=.+/
+ @man_synopsis= x[/synopsis=(.+)/m,1] if x =~/synopsis=.+/
+ end
end
@lv1 ||=/^1~/
@lv2 ||=/^2~/
@@ -583,6 +592,14 @@ module SiSU_Param
end
end
end #% here endeth the document loop
+ @man_name.gsub!(/(-)/,"\\\\\\1")
+ @man_name.gsub!(/\n/,"\n.BR\n")
+ @man_name.gsub!(/\A/,"\n.SH NAME\n")
+ unless @man_synopsis.nil?
+ @man_synopsis.gsub!(/(-)/,"\\\\\\1")
+ @man_synopsis.gsub!(/\n/,"\n.BR\n")
+ @man_synopsis.gsub!(/\A/,"\n.SH SYNOPSIS\n")
+ end
unless @dc_rights
if @dc_creator
@dc_rights ||=if @dc_date =~/([12][890]\d{2})/ #matches years 1800 through 20\d\d 2004w19
diff --git a/man/man1/sisu_commands.1 b/man/man1/sisu_commands.1
deleted file mode 100644
index ca60efc6..00000000
--- a/man/man1/sisu_commands.1
+++ /dev/null
@@ -1,575 +0,0 @@
-.TH "sisu_commands" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- COMMANDS,
-RALPH AMISSAH
-.BR
-
-.SH
-SISU COMMANDS
-.BR
-
-.SH
-1. COMMANDS SUMMARY
-.BR
-
-.SH
-1.1 SYNOPSIS
-
-.BR
-.B SiSU
-\- Structured information, Serialized Units \- a document publishing system
-
-.BR
-sisu \ [ \ \-abcDdFHhIiMmNnopqRrSsTtUuVvwXxYyZz0\-9 \ ] \ [ \ filename/ \
-wildcard \ ]
-
-.BR
-sisu \ [ \ \-Ddcv \ ] \ [ \ instruction \ ]
-
-.BR
-sisu \ [ \ \-CcFLSVvW \ ]
-
-.BR
-Note: commands should be issued from within the directory that contains the
-marked up files, cd to markup directory.
-
-.SH
-1.2 DESCRIPTION
-
-.BR
-.B SiSU
-.B SiSU
-is a document publishing system, that from a simple single marked\-up
-document, produces multiple of output formats including: plaintext, html,
-LaTeX, pdf, xhtml, XML, info, and SQL (PostgreSQL and SQLite), which share
-numbered text objects (\"object citation numbering\") and the same document
-structure information. For more see: <http://www.jus.uio.no/sisu>
-
-.SH
-1.3 DOCUMENT PROCESSING COMMAND FLAGS
-
-.TP
-.B \ \-a \ \ [filename/wildcard]
-produces plaintext with Unix linefeeds and without markup, (object numbers
-are omitted), has footnotes at end of each paragraph that contains them \ [ \
-\-A \ for \ equivalent \ dos \ (linefeed) \ output \ file] \ [see \ \-e \ for \
-endnotes]. (Options include: \-\-endnotes for endnotes \-\-footnotes for
-footnotes at the end of each paragraph \-\-unix for unix linefeed (default)
-\-\-msdos for msdos linefeed)
-
-.TP
-.B \ \-b \ \ [filename/wildcard]
-produces xhtml/XML output for browser viewing (sax parsing).
-
-.TP
-.B \ \-C \ \ [\-\-init\-site]
-configure/initialise shared output directory files initialize shared output
-directory (config files such as css and dtd files are not updated if they
-already exist unless modifier is used). \-C \-\-init\-site configure/initialise
-site more extensive than \-C on its own, shared output directory files/force
-update, existing shared output config files such as css and dtd files are
-updated if this modifier is used.
-
-.TP
-.B \ \-CC
-\ configure/initialise \ shared \ output \ directory \ files \ initialize \
-shared \ output \ directory \ (config \ files \ such \ as \ css \ and \ dtd \
-files \ are \ not \ updated \ if \ they \ already \ exist \ unless \ modifier \
-is \ used). \ The \ equivalent \ of: \ \-C \ \-\-init\-site \
-configure/initialise \ site, \ more \ extensive \ than \ \-C \ on \ its \ own,
-\ shared \ output \ directory \ files/force \ update, \ existing \ shared \
-output \ config \ files \ such \ as \ css \ and \ dtd \ files \ are \ updated \
-if \ \-CC \ is \ used. \
-
-.TP
-.B \ \-c \ \ [filename/wildcard]
-screen toggle ansi screen colour on or off depending on default set (unless
-\-c flag is used: if sisurc colour default is set to \'true\', output to screen
-will be with colour, if sisurc colour default is set to \'false\' or is
-undefined screen output will be without colour).
-
-.TP
-.B \ \-D \ \ [instruction] \ [filename]
-database postgresql ( \-\-pgsql may be used instead) possible instructions,
-include: \-\-createdb; \-\-create; \-\-dropall; \-\-import \ [filename];
-\-\-update \ [filename]; \-\-remove \ [filename]; see database section below.
-
-.TP
-.B \ \-d \ \ [\-\-db\-[database \ type \ (sqlite|pg)]] \-\-[instruction] \
-[filename]
-database type default set to sqlite, (for which \-\-sqlite may be used
-instead) or to specify another database \-\-db\-[pgsql, \ sqlite] (however see
-\-D) possible instructions include: \-\-createdb; \-\-create; \-\-dropall;
-\-\-import \ [filename]; \-\-update \ [filename]; \-\-remove \ [filename]; see
-database section below.
-
-.TP
-.B \ \-F \ \ [\-\-webserv=webrick]
-generate examples of (naive) cgi search form for sqlite and pgsql depends on
-your already having used sisu to populate an sqlite and/or pgsql database, (the
-sqlite version scans the output directories for existing sisu_sqlite databases,
-so it is first necessary to create them, before generating the search form) see
-\-d \-D and the database section below. If the optional parameter
-\-\-webserv=webrick is passed, the cgi examples created will be set up to use
-the default port set for use by the webrick server, (otherwise the port is left
-blank and the system setting used, usually 80). The samples are dumped in the
-present work directory which must be writable, (with screen instructions given
-that they be copied to the cgi\-bin directory). \-Fv (in addition to the above)
-provides some information on setting up hyperestraier for sisu
-
-.TP
-.B \ \-H \ \ [filename/wildcard]
-produces html without link suffixes (.html \.pdf etc.) (\"Hide\"). Requires
-an appropriately configured web server. \ [behaviour \ switched \ after \ 0.35
-\ see \ \-h].
-
-.TP
-.B \ \-h \ \ [filename/wildcard]
-produces html (with hardlinks i.e. with name suffixes in links/local urls).
-html, with internal document links that include the document suffix, i.e.
-whether it is \.html or \.pdf (required for browsing directly off a file
-system, and works with most web servers). \ [behaviour \ switched \ after \
-0.35 \ see \ \-H].
-
-.TP
-.B \ \-I \ \ [filename/wildcard]
-produces texinfo and info file, (view with pinfo).
-
-.TP
-.B \ \-L
-\ prints \ license \ information. \
-
-.TP
-.B \ \-M \ \ [filename/wildcard/url]
-maintenance mode files created for processing preserved and their locations
-indicated. (also see \-V)
-
-.TP
-.B \ \-m \ \ [filename/wildcard/url]
-assumed for most other flags, creates new meta\-markup file, (the metaverse )
-that is used in all subsequent processing of other output. This step is assumed
-for most processing flags. To skip it see \-n
-
-.TP
-.B \ \-N \ \ [filename/wildcard/url]
-document digest or document content certificate ( DCC ) as md5 digest tree of
-the document: the digest for the document, and digests for each object
-contained within the document (together with information on software versions
-that produced it) (digest.txt). \-NV for verbose digest output to screen.
-
-.TP
-.B \ \-n \ \ [filename/wildcard/url]
-skip meta\-markup (building of \"metaverse\"), this skips the equivalent of
-\-m which is otherwise assumed by most processing flags.
-
-.TP
-.B \ \-o \ \ [filename/wildcard/url]
-output basic document in opendocument file format (opendocument.odt).
-
-.TP
-.B \ \-p \ \ [filename/wildcard]
-produces LaTeX pdf (portrait.pdf & landscape.pdf). Default paper size is set
-in config file, or document header, or provided with additional command line
-parameter, e.g. \-\-papersize\-a4 preset sizes include: \'A4\', U.S. \'letter\'
-and \'legal\' and book sizes \'A5\' and \'B5\' (system defaults to A4).
-
-.TP
-.B \ \-q \ \ [filename/wildcard]
-quiet less output to screen.
-
-.TP
-.B \ \-R \ \ [filename/wildcard]
-copies sisu output files to remote host using rsync. This requires that
-sisurc.yml has been provided with information on hostname and username, and
-that you have your \"keys\" and ssh agent in place. Note the behavior of rsync
-different if \-R is used with other flags from if used alone. Alone the rsync
-\-\-delete parameter is sent, useful for cleaning the remote directory (when
-\-R is used together with other flags, it is not). Also see \-r
-
-.TP
-.B \ \-r \ \ [filename/wildcard]
-copies sisu output files to remote host using scp. This requires that
-sisurc.yml has been provided with information on hostname and username, and
-that you have your \"keys\" and ssh agent in place. Also see \-R
-
-.TP
-.B \ \-S
-\ produces \ a \ sisupod \ a \ zipped \ sisu \ directory \ of \ markup \
-files \ including \ sisu \ markup \ source \ files \ and \ the \ directories \
-local \ configuration \ file, \ images \ and \ skins. \ Note: \ this \ only \
-includes \ the \ configuration \ files \ or \ skins \ contained \ in \ \./_sisu
-\ not \ those \ in \ ~/.sisu \ \-S \ \ [filename/wildcard] option. Note: (this
-option is tested only with zsh).
-
-.TP
-.B \ \-S \ \ [filename/wildcard]
-produces a zipped file of the prepared document specified along with
-associated images, by default named sisupod.zip they may alternatively be named
-with the filename extension \.ssp This provides a quick way of gathering the
-relevant parts of a sisu document which can then for example be emailed. A
-sisupod includes sisu markup source file, (along with associated documents if a
-master file, or available in multilingual versions), together with related
-images and skin.
-.B SiSU
-commands can be run directly against a sisupod contained in a local
-directory, or provided as a url on a remote site. As there is a security issue
-with skins provided by other users, they are not applied unless the flag
-\-\-trust or \-\-trusted is added to the command instruction, it is recommended
-that file that are not your own are treated as untrusted. The directory
-structure of the unzipped file is understood by sisu, and sisu commands can be
-run within it. Note: if you wish to send multiple files, it quickly becomes
-more space efficient to zip the sisu markup directory, rather than the
-individual files for sending). See the \-S option without \
-[filename/wildcard].
-
-.TP
-.B \ \-s \ \ [filename/wildcard]
-copies sisu markup file to output directory.
-
-.TP
-.B \ \-t \ \ [filename/wildcard \ (*.termsheet.rb)]
-standard form document builder, preprocessing feature
-
-.TP
-.B \ \-U \ \ [filename/wildcard]
-prints url output list/map for the available processing flags options and
-resulting files that could be requested, (can be used to get a list of
-processing options in relation to a file, together with information on the
-output that would be produced), \-u provides url output mapping for those flags
-requested for processing. The default assumes sisu_webrick is running and
-provides webrick url mappings where appropriate, but these can be switched to
-file system paths in sisurc.yml
-
-.TP
-.B \ \-u \ \ [filename/wildcard]
-provides url mapping of output files for the flags requested for processing,
-also see \-U
-
-.TP
-.B \ \-V
-\ on \ its \ own, \ provides
-.B \ SiSU
-\ version \ and \ environment \ information \ (sisu \ \-\-help \ env) \
-
-.TP
-.B \ \-V \ \ [filename/wildcard]
-even more verbose than the \-v flag. (also see \-M)
-
-.TP
-.B \ \-v
-\ on \ its \ own, \ provides
-.B \ SiSU
-\ version \ information \
-
-.TP
-.B \ \-v \ \ [filename/wildcard]
-provides verbose output of what is being built, where it is being built (and
-error messages if any), as with \-u flag provides a url mapping of files
-created for each of the processing flag requests. See also \-V
-
-.TP
-.B \ \-W
-\ starts \ ruby\'s \ webrick \ webserver \ points \ at \ sisu \ output \
-directories, \ the \ default \ port \ is \ set \ to \ 8081 \ and \ can \ be \
-changed \ in \ the \ resource \ configuration \ files. \ \ [tip: \ the \
-webrick \ server \ requires \ link \ suffixes, \ so \ html \ output \ should \
-be \ created \ using \ the \ \-h \ option \ rather \ than \ \-H; \ also, \ note
-\ \-F \ webrick \ ].
-
-.TP
-.B \ \-w \ \ [filename/wildcard]
-produces concordance (wordmap) a rudimentary index of all the words in a
-document. (Concordance files are not generated for documents of over 260,000
-words unless this limit is increased in the file sisurc.yml)
-
-.TP
-.B \ \-X \ \ [filename/wildcard]
-produces XML output with deep document structure, in the nature of dom.
-
-.TP
-.B \ \-x \ \ [filename/wildcard]
-produces XML output shallow structure (sax parsing).
-
-.TP
-.B \ \-Y \ \ [filename/wildcard]
-produces a short sitemap entry for the document, based on html output and the
-sisu_manifest. \-\-sitemaps generates/updates the sitemap index of existing
-sitemaps. (Experimental, \ [g,y,m \ announcement \ this \ week])
-
-.TP
-.B \ \-y \ \ [filename/wildcard]
-produces an html summary of output generated (hyperlinked to content) and
-document specific metadata (sisu_manifest.html). This step is assumed for most
-processing flags.
-
-.TP
-.B \ \-Z \ \ [filename/wildcard]
-Zap, if used with other processing flags deletes output files of the type
-about to be processed, prior to processing. If \-Z is used as the lone
-processing related flag (or in conjunction with a combination of \-[mMvVq]),
-will remove the related document output directory.
-
-.TP
-.B \ \-z \ \ [filename/wildcard]
-produces php (zend) \ [this \ feature \ is \ disabled \ for \ the \ time \
-being]
-
-.SH
-2. COMMAND LINE MODIFIERS
-.BR
-
-.TP
-.B \ \-\-no\-ocn
-\ \ [with \ \-h \ \-H \ or \ \-p] switches off object citation numbering.
-Produce output without identifying numbers in margins of html or LaTeX/pdf
-output.
-
-.TP
-.B \ \-\-no\-annotate
-\ strips \ output \ text \ of \ editor \ endnotes[^*1] denoted by asterisk or
-dagger/plus sign
-
-.TP
-.B \ \-\-no\-asterisk
-\ strips \ output \ text \ of \ editor \ endnotes[^*2] denoted by asterisk
-sign
-
-.TP
-.B \ \-\-no\-dagger
-\ strips \ output \ text \ of \ editor \ endnotes[^+1] denoted by dagger/plus
-sign
-
-.SH
-3. DATABASE COMMANDS
-.BR
-
-.BR
-dbi \- database interface
-
-.BR
-\-D or \-\-pgsql set for postgresql \-d or \-\-sqlite default set for sqlite
-\-d is modifiable with \-\-db=[database \ type \ (pgsql \ or \ sqlite)]
-
-.TP
-.B \ \-Dv \ \-\-createall
-\ initial \ step, \ creates \ required \ relations \ (tables, \ indexes) \ in
-\ existing \ postgresql \ database \ (a \ database \ should \ be \ created \
-manually \ and \ given \ the \ same \ name \ as \ working \ directory, \ as \
-requested) \ (rb.dbi) \ \ [ \ \-dv \ \-\-createall \ sqlite \ equivalent] it
-may be necessary to run sisu \-Dv \-\-createdb initially NOTE: at the present
-time for postgresql it may be necessary to manually create the database. The
-command would be \'createdb \ [database \ name]\' where database name would be
-SiSU_[present \ working \ directory \ name \ (without \ path)]. Please use only
-alphanumerics and underscores.
-
-.TP
-.B \ \-Dv \ \-\-import
-\ \ [filename/wildcard] imports data specified to postgresql db (rb.dbi) \ [
-\ \-dv \ \-\-import \ sqlite \ equivalent]
-
-.TP
-.B \ \-Dv \ \-\-update
-\ \ [filename/wildcard] updates/imports specified data to postgresql db
-(rb.dbi) \ [ \ \-dv \ \-\-update \ sqlite \ equivalent]
-
-.TP
-.B \ \-D \ \-\-remove
-\ \ [filename/wildcard] removes specified data to postgresql db (rb.dbi) \ [
-\ \-d \ \-\-remove \ sqlite \ equivalent]
-
-.TP
-.B \ \-D \ \-\-dropall
-\ kills \ data\" \ and \ drops \ (postgresql \ or \ sqlite) \ db, \ tables \
-& \ indexes \ \ [ \ \-d \ \-\-dropall \ sqlite \ equivalent]
-
-.BR
-The v in e.g. \-Dv is for verbose output.
-
-.SH
-4. SHORTCUTS, SHORTHAND FOR MULTIPLE FLAGS
-.BR
-
-.TP
-.B \ \-\-update \ \ [filename/wildcard]
-Checks existing file output and runs the flags required to update this
-output. This means that if only html and pdf output was requested on previous
-runs, only the \-hp files will be applied, and only these will be generated
-this time, together with the summary. This can be very convenient, if you offer
-different outputs of different files, and just want to do the same again.
-
-.TP
-.B \ \-0 \ to \ \-5 \ \ [filename \ or \ wildcard]
-Default shorthand mappings (note that the defaults can be changed/configured
-in the sisurc.yml file):
-
-.TP
-.B \ \-0
-\ \-mNhwpAobxXyYv \ \ [this \ is \ the \ default \ action \ run \ when \ no \
-options \ are \ give, \ i.e. \ on \ \'sisu \ \ [filename]\']
-
-.TP
-.B \ \-1
-\ \-mNHwpy \
-
-.TP
-.B \ \-2
-\ \-mNHwpaoy \
-
-.TP
-.B \ \-3
-\ \-mNhwpAobxXyY \
-
-.TP
-.B \ \-4
-\ \-mNhwpAobxXDyY \ \-\-import \
-
-.TP
-.B \ \-5
-\ \-mNhwpAobxXDyY \ \-\-update \
-
-.BR
-add \-v for verbose mode and \-c for color, e.g. sisu \-2vc \ [filename \ or \
-wildcard]
-
-.BR
-consider \-u for appended url info or \-v for verbose output
-
-.SH
-4.0.1 COMMAND LINE WITH FLAGS \- BATCH PROCESSING
-
-.BR
-In the data directory run sisu \-mh filename or wildcard eg. \"sisu \-h
-cisg.sst\" or \"sisu \-h *.{sst,ssm}\" to produce html version of all
-documents.
-
-.BR
-Running sisu (alone without any flags, filenames or wildcards) brings up the
-interactive help, as does any sisu command that is not recognised. Enter to
-escape.
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Commands
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-08\-28
-
-.BR
-DC Date issued:
-.I 2002\-08\-28
-
-.BR
-DC Date available:
-.I 2002\-08\-28
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_commands.sst
-
-.BR
-Filetype:
-.I SiSU text 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_commands.sst)=
-.I 68a4087f984baffbea779da25e1b6141
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:43 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-.TP
-.BI *1.
-square brackets
-.TP
-.BI *2.
-square brackets
-.TP
-.BI +1.
-square brackets
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_commands/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_commands/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_commands/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_commands/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_commands/sisu_commands.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:50 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man1/sisu_configuration.1 b/man/man1/sisu_configuration.1
deleted file mode 100644
index 98c8c8c0..00000000
--- a/man/man1/sisu_configuration.1
+++ /dev/null
@@ -1,368 +0,0 @@
-.TH "sisu_configuration" "1" "2007-08-30" "0.59.1" "SiSU"
-.SH
-SISU \- CONFIGURATION,
-RALPH AMISSAH
-.BR
-
-.SH
-CONFIGURATION OF ENVIRONMENT
-.BR
-
-.SH
-1. CONFIGURATION
-.BR
-
-.SH
-1.1 DETERMINING THE CURRENT CONFIGURATION
-
-.BR
-Information on the current configuration of
-.B SiSU
-should be available with the help command:
-
-.BR
- sisu \-v
-
-.BR
-which is an alias for:
-
-.BR
- sisu \-\-help env
-
-.BR
-Either of these should be executed from within a directory that contains sisu
-markup source documents.
-
-.SH
-1.2 CONFIGURATION FILES (CONFIG.YML)
-
-.BR
-.B SiSU
-configration parameters are adjusted in the configuration file, which can be
-used to override the defaults set. This includes such things as which directory
-interim processing should be done in and where the generated output should be
-placed.
-
-.BR
-The
-.B SiSU
-configuration file is a yaml file, which means indentation is significant.
-
-.BR
-.B SiSU
-resource configuration is determined by looking at the following files if
-they exist:
-
-.BR
- \./_sisu/sisurc.yml
-
-.BR
- ~/.sisu/sisurc.yml
-
-.BR
- /etc/sisu/sisurc.yml
-
-.BR
-The search is in the order listed, and the first one found is used.
-
-.BR
-In the absence of instructions in any of these it falls back to the internal
-program defaults.
-
-.BR
-Configuration determines the output and processing directories and the database
-access details.
-
-.BR
-If
-.B SiSU
-is installed a sample sisurc.yml may be found in /etc/sisu/sisurc.yml
-
-.SH
-CONFIGURATION OF DOCUMENTS
-.BR
-
-.SH
-2. SKINS
-.BR
-
-.BR
-Skins modify the default appearance of document output on a document,
-directory, or site wide basis. Skins are looked for in the following locations:
-
-.BR
- \./_sisu/skin
-
-.BR
- ~/.sisu/skin
-
-.BR
- /etc/sisu/skin
-
-.BR
-.B Within the skin directory
-are the following the default sub\-directories for document skins:
-
-.BR
- \./skin/doc
-
-.BR
- \./skin/dir
-
-.BR
- \./skin/site
-
-.BR
-A skin is placed in the appropriate directory and the file named skin_[name].rb
-
-.BR
-The skin itself is a ruby file which modifies the default appearances set in
-the program.
-
-.SH
-2.1 DOCUMENT SKIN
-
-.BR
-Documents take on a document skin, if the header of the document specifies a
-skin to be used.
-
-
-.nf
- @skin: skin_united_nations
-.fi
-
-.SH
-2.2 DIRECTORY SKIN
-
-.BR
-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).
-
-.BR
-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.
-
-.SH
-2.3 SITE SKIN
-
-.BR
-A site skin, modifies the program default skin.
-
-.SH
-2.4 SAMPLE SKINS
-
-.BR
-With
-.B SiSU
-installed sample skins may be found in:
-
-.BR
- /etc/sisu/skin/doc and
- /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc
-
-.BR
-(or equivalent directory) and if sisu\-markup\-samples is installed also under:
-
-.BR
- /usr/share/doc/sisu/sisu_markup_samples/non\-free/_sisu/skin/doc
-
-.BR
-Samples of list.yml and promo.yml (which are used to create the right column
-list) may be found in:
-
-.BR
- /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml (or equivalent
- directory)
-
-.SH
-3. HOMEPAGES
-.BR
-
-.BR
-.B SiSU
-is about the ability to auto\-generate documents. Home pages are regarded as
-custom built items, and are not created by
-.B SiSU
-. More accurately,
-.B SiSU
-has a default home page, which will not be appropriate for use with other
-sites, and the means to provide your own home page instead in one of two ways
-as part of a site\'s configuration, these being:
-
-.BR
-1. through placing your home page and other custom built documents in the
-subdirectory _sisu/home/ (this probably being the easier and more convenient
-option)
-
-.BR
-2. through providing what you want as the home page in a skin,
-
-.BR
-Document sets are contained in directories, usually organised by site or
-subject. Each directory can/should have its own homepage. See the section on
-directory structure and organisation of content.
-
-.SH
-3.1 HOME PAGE AND OTHER CUSTOM BUILT PAGES IN A SUB\-DIRECTORY
-
-.BR
-Custom built pages, including the home page index.html may be placed within the
-configuration directory _sisu/home/ in any of the locations that is searched
-for the configuration directory, namely \./_sisu; ~/_sisu; /etc/sisu From there
-they are copied to the root of the output directory with the command:
-
-.BR
- sisu \-CC
-
-.SH
-3.2 HOME PAGE WITHIN A SKIN
-
-.BR
-Skins are described in a separate section, but basically are a file written in
-the programming language
-.B Ruby
-that may be provided to change the defaults that are provided with sisu with
-respect to individual documents, a directories contents or for a site.
-
-.BR
-If you wish to provide a homepage within a skin the skin should be in the
-directory _sisu/skin/dir and have the name of the directory for which it is to
-become the home page. Documents in the directory commercial_law would have the
-homepage modified in skin_commercial law.rb; or the directory poems in
-skin_poems.rb
-
-
-.nf
- class Home
- def homepage
- # place the html content of your homepage here, this will become index.html
- <<HOME <html>
- <head></head>
- <doc>
- <p>this is my new homepage.</p>
- </doc>
- </html>
- HOME
- end
- end
-.fi
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Configuration
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Ralph Amissah
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-08\-28
-
-.BR
-DC Date issued:
-.I 2002\-08\-28
-
-.BR
-DC Date available:
-.I 2007\-08\-28
-
-.BR
-DC Date modified:
-.I 2007\-08\-30
-
-.BR
-DC Date:
-.I 2007\-08\-30
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_configuration._sst
-
-.BR
-Filetype:
-.I SiSU text insert 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_configuration._sst)=
-.I 491d3da039162d60ae0e2951aa260915
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:46 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_configuration/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_configuration/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_configuration/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_configuration/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_configuration/sisu_configuration.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:51 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man1/sisu_help.1 b/man/man1/sisu_help.1
deleted file mode 100644
index 95331031..00000000
--- a/man/man1/sisu_help.1
+++ /dev/null
@@ -1,318 +0,0 @@
-.TH "sisu_help" "1" "2007-08-30" "0.59.1" "SiSU"
-.SH
-SISU \- HELP,
-RALPH AMISSAH
-.BR
-
-.SH
-SISU HELP
-.BR
-
-.SH
-1. HELP
-.BR
-
-.SH
-1.1 SISU MANUAL
-
-.BR
-The most up to date information on sisu should be contained in the sisu_manual,
-available at:
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/>
-
-.BR
-and (from
-.B SiSU
-0.59 onwards) installed locally at:
-
-.BR
- /usr/share/doc/sisu/sisu_manual/
-
-.BR
-or equivalent directory
-
-.BR
-Within the
-.B SiSU
-tarball at:
-
-.BR
- \./data/doc/sisu/sisu_manual/
-
-.SH
-1.2 SISU MAN PAGES
-
-.BR
-If
-.B SiSU
-is installed on your system usual man commands should be available, try:
-
-.BR
- man sisu
-
-.BR
- man sisu_markup
-
-.BR
- man sisu_commands
-
-.BR
-Most
-.B SiSU
-man pages are generated directly from sisu documents that are used to prepare
-the sisu manual, the sources files for which are located within the
-.B SiSU
-tarball at:
-
-.BR
- \./data/doc/sisu/sisu_manual/
-
-.BR
-Once installed, directory equivalent to:
-
-.BR
- /usr/share/doc/sisu/sisu_manual/
-
-.BR
-Available man pages are converted back to html using man2html:
-
-.BR
- /usr/share/doc/sisu/html/
-
-.BR
- \./data/doc/sisu/html/
-
-.BR
-The
-.B SiSU
-man pages can be viewed online at:[^1]
-
-.BR
-An online version of the sisu man page is available here:
-
-.BR
-* various sisu man pages <http://www.jus.uio.no/sisu/man/> \ [^2]
-
-.BR
-* sisu.1 <http://www.jus.uio.no/sisu/man/sisu.1.html> \ [^3]
-
-.BR
-* sisu.8 <http://www.jus.uio.no/sisu/man/sisu.8.html> \ [^4]
-
-.BR
-* sisu_examples.1 <http://www.jus.uio.no/sisu/man/sisu_examples.1.html> \ [^5]
-
-.BR
-* sisu_webrick.1 <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html> \ [^6]
-
-.SH
-1.3 SISU BUILT\-IN INTERACTIVE HELP
-
-.BR
-This is particularly useful when current installation information is obtained
-as the interactive help is able to provide information on your sisu
-configuration and setup.
-
-.BR
- sisu \-\-help
-
-.BR
- sisu \-\-help \ [subject]
-
-.BR
- sisu \-\-help env \ [for \ feedback \ on \ the \ way \ your \ system \ is \
- setup \ with \ regard \ to \ sisu]
-
-.BR
- sisu \-V \ [same \ as \ above \ command]
-
-.BR
- sisu \-\-help commands
-
-.BR
- sisu \-\-help markup
-
-.BR
-Apart from real\-time information on your current configuration the
-.B SiSU
-manual and man pages are likely to contain more up\-to\-date information than
-the sisu interactive help (for example on commands and markup).
-
-.BR
-NOTE: Running the command sisu (alone without any flags, filenames or
-wildcards) brings up the interactive help, as does any sisu command that is not
-recognised. Enter to escape.
-
-.SH
-1.4 HELP SOURCES
-
-.BR
-For lists of alternative help sources, see:
-
-.BR
-.B man page
-
-.BR
- man sisu_help_sources
-
-.BR
-.B man2html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html
-
-.BR
-.B sisu generated html
-
-.BR
- /usr/share/doc/sisu/html/sisu_help_sources/index.html
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html>
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_help/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Help
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-08\-28
-
-.BR
-DC Date issued:
-.I 2002\-08\-28
-
-.BR
-DC Date available:
-.I 2002\-08\-28
-
-.BR
-DC Date modified:
-.I 2007\-08\-30
-
-.BR
-DC Date:
-.I 2007\-08\-30
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_help.sst
-
-.BR
-Filetype:
-.I SiSU text 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_help.sst)=
-.I 66d04ba5f3dd4ede774ffa5549b3faba
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:42 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-.TP
-.BI 1.
-generated from source using rman
- <http://polyglotman.sourceforge.net/rman.html>
- With regard to
-.B SiSU
-man pages the formatting generated for markup syntax is not quite right, for
-that you might prefer the links under:
- <http://www.jus.uio.no/sample>
-.TP
-.BI 2.
-<http://www.jus.uio.no/sisu/man/>
-.TP
-.BI 3.
-<http://www.jus.uio.no/sisu/man/sisu.1.html>
-.TP
-.BI 4.
-<http://www.jus.uio.no/sisu/man/sisu.8.html>
-.TP
-.BI 5.
-<http://www.jus.uio.no/sisu/man/sisu_examples.1.html>
-.TP
-.BI 6.
-<http://www.jus.uio.no/sisu/man/sisu_webrick.1.html>
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_help/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_help/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_help/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_help/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_help/sisu_help.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:50 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man1/sisu_help_sources.1 b/man/man1/sisu_help_sources.1
deleted file mode 100644
index 2b907a23..00000000
--- a/man/man1/sisu_help_sources.1
+++ /dev/null
@@ -1,729 +0,0 @@
-.TH "sisu_help_sources" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- REFERENCES,
-RALPH AMISSAH
-.BR
-
-.SH
-SISU HELP SOURCES
-.BR
-
-.SH
-1. HELP SOURCES
-.BR
-
-.BR
-For a summary of alternative ways to get help on
-.B SiSU
-try one of the following:
-
-.BR
-.B man page
-
-.BR
- man sisu_help
-
-.BR
-.B man2html
-
-.BR
- <file:///usr/share/doc/sisu/html/sisu_help.1.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_help.1.html>
-
-.BR
-.B sisu generated output \- links to html
-
-.BR
- <file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_help/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html>
-
-.BR
-.B help sources lists
-
-.BR
-Alternative sources for this help sources page listed here:
-
-.BR
- man sisu_help_sources
-
-.BR
- <file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html>
-
-.BR
- <file:///usr/share/doc/sisu/html/sisu_help_sources/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html>
-
-.SH
-1.1 MAN PAGES
-
-.SH
-1.1.1 MAN
-
-.BR
- man sisu
-
-.BR
- man sisu_commands
-
-.BR
- man 7 sisu_complete
-
-.BR
- man sisu_configuration
-
-.BR
- man 8 sisu_faq
-
-.BR
- man sisu_filetypes
-
-.BR
- man sisu_help
-
-.BR
- man sisu_help_sources
-
-.BR
- man 8 sisu_howto
-
-.BR
- man sisu_introduction
-
-.BR
- man sisu_markup
-
-.BR
- man sisu_output_overview
-
-.BR
- man 7 sisu_pdf
-
-.BR
- man 7 sisu_postgresql
-
-.BR
- man 8 sisu_quickstart
-
-.BR
- man 8 sisu_remote
-
-.BR
- man 8 sisu_search
-
-.BR
- man sisu_skin
-
-.BR
- man 7 sisu_sqlite
-
-.BR
- man 8 sisu_syntax_highlighting
-
-.BR
- man 7 sisu_vim
-
-.BR
- man sisu_webrick
-
-.SH
-1.2 SISU GENERATED OUTPUT \- LINKS TO HTML
-
-.BR
-Note
-.B SiSU
-documentation is prepared in
-.B SiSU
-and output is available in multiple formats including amongst others html,
-pdf, and odf which may be also be accessed via the html pages[^1]
-
-.SH
-1.2.1 LOCALLY INSTALLED
-
-.BR
-<file:///usr/share/doc/sisu/sisu_manual/sisu_manual/index.html>
-
-.BR
-<file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html>
-
-.BR
-<file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html>
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_commands/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_complete/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_configuration/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_description/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_examples/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_faq/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_filetypes/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_help/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_howto/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_introduction/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_manual/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_markup/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_output_overview/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_pdf/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_postgresql/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_quickstart/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_remote/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_search/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_skin/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_sqlite/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_syntax_highlighting/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_vim/index.html
-
-.BR
- /usr/share/doc/sisu/sisu_manual/sisu_webrick/index.html
-
-.SH
-1.2.2 WWW.SISUDOC.ORG
-
-.BR
-<http://sisudoc.org/sisu_manual/sisu_manual/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_commands/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_complete/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_configuration/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_description/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_examples/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_faq/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_filetypes/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_help/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_howto/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_introduction/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_manual/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_markup/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_output_overview/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_pdf/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_postgresql/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_quickstart/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_remote/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_search/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_skin/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_sqlite/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_syntax_highlighting/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_vim/index.html>
-
-.BR
- <http://sisudoc.org/sisu_manual/sisu_webrick/index.html>
-
-.SH
-1.2.3 WWW.JUS.UIO.NO/SISU
-
-.BR
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_complete/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_description/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_examples/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_filetypes/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_introduction/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_output_overview/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_pdf/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_search/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_sqlite/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_vim/index.html>
-
-.BR
- <http://www.jus.uio.no/sisu/sisu_manual/sisu_webrick/index.html>
-
-.SH
-1.2.4 MAN2HTML
-
-.SH
-1.2.5 LOCALLY INSTALLED
-
-.BR
-<file:///usr/share/doc/sisu/html/sisu_manual.1.html>
-
-.BR
-<file:///usr/share/doc/sisu/html/sisu_help.1.html>
-
-.BR
-<file:///usr/share/doc/sisu/html/sisu_help_sources.1.html>
-
-.BR
- /usr/share/doc/sisu/html/sisu.1.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_commands.1.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_complete.7.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_configuration.1.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_faq.8.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_help.1.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_help_sources.1.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_howto.8.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_markup.1.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_pdf.7.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_postgresql.7.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_quickstart.8.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_remote.8.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_search.8.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_skin.1.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_sqlite.7.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_syntax_highlighting.8.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_vim.7.html
-
-.BR
- /usr/share/doc/sisu/html/sisu_webrick.1.html
-
-.SH
-1.2.6 WWW.SISUDOC.ORG
-
-.BR
-<http:///sisudoc.org/man/sisu_manual.1.html>
-
-.BR
-<http:///sisudoc.org/man/sisu_help.1.html>
-
-.BR
-<http:///sisudoc.org/man/sisu_help_sources.1.html>
-
-.BR
- <http://sisudoc.org/man/sisu.1.html>
-
-.BR
- <http://sisudoc.org/man/sisu_commands.1.html>
-
-.BR
- <http://sisudoc.org/man/sisu_complete.7.html>
-
-.BR
- <http://sisudoc.org/man/sisu_configuration.1.html>
-
-.BR
- <http://sisudoc.org/man/sisu_faq.8.html>
-
-.BR
- <http://sisudoc.org/man/sisu_help.1.html>
-
-.BR
- <http://sisudoc.org/man/sisu_help_sources.1.html>
-
-.BR
- <http://sisudoc.org/man/sisu_howto.8.html>
-
-.BR
- <http://sisudoc.org/man/sisu_markup.1.html>
-
-.BR
- <http://sisudoc.org/man/sisu_pdf.7.html>
-
-.BR
- <http://sisudoc.org/man/sisu_postgresql.7.html>
-
-.BR
- <http://sisudoc.org/man/sisu_quickstart.8.html>
-
-.BR
- <http://sisudoc.org/man/sisu_remote.8.html>
-
-.BR
- <http://sisudoc.org/man/sisu_search.8.html>
-
-.BR
- <http://sisudoc.org/man/sisu_skin.1.html>
-
-.BR
- <http://sisudoc.org/man/sisu_sqlite.7.html>
-
-.BR
- <http://sisudoc.org/man/sisu_syntax_highlighting.8.html>
-
-.BR
- <http://sisudoc.org/man/sisu_vim.7.html>
-
-.BR
- <http://sisudoc.org/man/sisu_webrick.1.html>
-
-.SH
-1.2.7 WWW.JUS.UIO.NO/SISU
-
-.BR
-<http://www.jus.uio.no/sisu/man/sisu_manual.1.html>
-
-.BR
-<http://www.jus.uio.no/sisu/man/sisu_help.1.html>
-
-.BR
-<http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu.1.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_commands.1.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_complete.7.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_configuration.1.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_faq.8.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_help.1.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_howto.8.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_markup.1.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_pdf.7.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_postgresql.7.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_quickstart.8.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_remote.8.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_search.8.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_skin.1.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_sqlite.7.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_syntax_highlighting.8.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_vim.7.html>
-
-.BR
- <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html>
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- References
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-11\-12
-
-.BR
-DC Date issued:
-.I 2002\-11\-12
-
-.BR
-DC Date available:
-.I 2002\-11\-12
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_help_sources.sst
-
-.BR
-Filetype:
-.I SiSU text insert 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_help_sources.sst)=
-.I ff6812b3008391d7a20d777bbbeb3ec1
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:42 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-.TP
-.BI 1.
-named index.html or more extensively through sisu_manifest.html
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_help_sources/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_help_sources/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_help_sources/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_help_sources/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_help_sources/sisu_help_sources.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:50 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man1/sisu_markup.1 b/man/man1/sisu_markup.1
deleted file mode 100644
index d8e58032..00000000
--- a/man/man1/sisu_markup.1
+++ /dev/null
@@ -1,1532 +0,0 @@
-.TH "sisu_markup" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- MARKUP,
-RALPH AMISSAH
-.BR
-
-.SH
-SISU MARKUP
-.BR
-
-.SH
-1. INTRODUCTION TO SISU MARKUP[^1]
-.BR
-
-.SH
-1.1 SUMMARY
-
-.BR
-.B SiSU
-source documents are plaintext (UTF\-8)[^2] files
-
-.BR
-All paragraphs are separated by an empty line.
-
-.BR
-Markup is comprised of:
-
-.BR
-* at the top of a document, the document header made up of semantic meta\-data
-about the document and if desired additional processing instructions (such an
-instruction to automatically number headings from a particular level down)
-
-.BR
-* followed by the prepared substantive text of which the most important single
-characteristic is the markup of different heading levels, which define the
-primary outline of the document structure. Markup of substantive text includes:
-
-.BR
- * heading levels defines document structure
-
-.BR
- * text basic attributes, italics, bold etc.
-
-.BR
- * grouped text (objects), which are to be treated differently, such as code
- blocks or poems.
-
-.BR
- * footnotes/endnotes
-
-.BR
- * linked text and images
-
-.BR
- * paragraph actions, such as indent, bulleted, numbered\-lists, etc.
-
-.BR
-Some interactive help on markup is available, by typing sisu and selecting
-markup or sisu \-\-help markup
-
-.SH
-1.2 MARKUP EXAMPLES
-
-.SH
-1.2.1 ONLINE
-
-.BR
-Online markup examples are available together with the respective outputs
-produced from <http://www.jus.uio.no/sisu/SiSU/2.html> or from
-<http://www.jus.uio.no/sisu/sisu_examples/>
-
-.BR
-There is of course this document, which provides a cursory overview of sisu
-markup and the respective output produced:
-<http://www.jus.uio.no/sisu/sisu_markup/>
-
-.BR
-Some example marked up files are available as html with syntax highlighting for
-viewing: <http://www.jus.uio.no/sisu/sample/syntax>
-
-.BR
-an alternative presentation of markup syntax:
-<http://www.jus.uio.no/sisu/sample/on_markup.txt>
-
-.SH
-1.2.2 INSTALLED
-
-.BR
-With
-.B SiSU
-installed sample skins may be found in:
-/usr/share/doc/sisu/sisu_markup_samples/dfsg (or equivalent directory) and if
-sisu\-markup\-samples is installed also under:
-/usr/share/doc/sisu/sisu_markup_samples/non\-free
-
-.SH
-2. MARKUP OF HEADERS
-.BR
-
-.BR
-Headers consist of semantic meta\-data about a document, which can be used by
-any output module of the program; and may in addition include extra processing
-instructions.
-
-.BR
-Note: the first line of a document may include information on the markup
-version used in the form of a comment. Comments are a percentage mark at the
-start of a paragraph (and as the first character in a line of text) followed by
-a space and the comment:
-
-
-.nf
- % this would be a comment
-.fi
-
-.SH
-2.1 SAMPLE HEADER
-
-.BR
-This current document has a header similar to this one (without the comments):
-
-
-.nf
- % SiSU 0.57
- @title: SiSU
- @subtitle: Markup
- @creator: Ralph Amissah
- @rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
- @type: information
- @subject: ebook, epublishing, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search
- @date.created: 2002\-08\-28
- @date.issued: 2002\-08\-28
- @date.available: 2002\-08\-28
- @date.modified: 2007\-09\-16
- @date: 2007\-09\-16
- @level: new=C; break=1; num_top=1
- % comment: in this @level header num_top=1 starts automatic heading numbering at heading level 1 (numbering continues 3 levels down); the new and break instructions are used by the LaTeX/pdf and odf output to determine where to put page breaks (that are not used by html output or say sql database population).
- @skin: skin_sisu_manual
- % skins modify the appearance of a document and are placed in a sub\-directory under \./_sisu/skin ~/.sisu/skin or /etc/sisu/skin. A skin may affect single documents that request them, all documents in a directory, or be site\-wide. (A document is affected by a single skin)
- @bold: /Gnu|Debian|Ruby|SiSU/
- @links: { SiSU Manual }http://www.jus.uio.no/sisu/sisu_manual/
- { Book Samples and Markup Examples }http://www.jus.uio.no/sisu/SiSU/2.html
- { SiSU @ Wikipedia }http://en.wikipedia.org/wiki/SiSU
- { SiSU @ Freshmeat }http://freshmeat.net/projects/sisu/
- { SiSU @ Ruby Application Archive }http://raa.ruby\-lang.org/project/sisu/
- { SiSU @ Debian }http://packages.qa.debian.org/s/sisu.html
- { SiSU Download }http://www.jus.uio.no/sisu/SiSU/download.html
- { SiSU Changelog }http://www.jus.uio.no/sisu/SiSU/changelog.html
-.fi
-
-.SH
-2.2 AVAILABLE HEADERS
-
-.BR
-Header tags appear at the beginning of a document and provide meta information
-on the document (such as the Dublin Core), or information as to how the
-document as a whole is to be processed. All header instructions take either the
-form @headername: or 0~headername. All Dublin Core meta tags are available
-
-.BR
-.B @indentifier:
-information or instructions
-
-.BR
-where the \"identifier\" is a tag recognised by the program, and the
-\"information\" or \"instructions\" belong to the tag/indentifier specified
-
-.BR
-Note: a header where used should only be used once; all headers apart from
-@title: are optional; the @structure: header is used to describe document
-structure, and can be useful to know.
-
-.BR
-This is a sample header
-
-.BR
-.B % SiSU 0.38
-\ [declared \ file\-type \ identifier \ with \ markup \ version]
-
-.BR
-.B @title:
-\ [title \ text] This is the title of the document and used as such, this
-header is the only one that is
-.I mandatory
-
-.BR
-.B @subtitle:
-The Subtitle if any
-
-.BR
-.B @creator:
-\ [or \ @author:] Name of Author
-
-.BR
-.B @subject:
-(whatever your subject)
-
-.BR
-.B @description:
-
-.BR
-.B @publisher:
-
-.BR
-.B @contributor:
-
-.BR
-.B @translator:
-\ [or \ @translated_by:]
-
-.BR
-.B @illustrator:
-\ [or \ @illustrated_by:]
-
-.BR
-.B @prepared_by:
-\ [or \ @digitized_by:]
-
-.BR
-.B @date: 2000\-08\-27
-\ [ \ also \ @date.created: \ @date.issued: \ @date.available: \ @date.valid:
-\ @date.modified: \ ]
-
-.BR
-.B @type: article
-
-.BR
-.B @format:
-
-.BR
-.B @identifier:
-
-.BR
-.B @source:
-
-.BR
-.B @language:
-\ [or \ @language.document:] \ [country \ code \ for \ language \ if \
-available, \ or \ language, \ English, \ en \ is \ the \ default \ setting] (en
-\- English, fr \- French, de \- German, it \- Italian, es \- Spanish, pt \-
-Portuguese, sv \- Swedish, da \- Danish, fi \- Finnish, no \- Norwegian, is \-
-Icelandic, nl \- Dutch, et \- Estonian, hu \- Hungarian, pl \- Polish, ro \-
-Romanian, ru \- Russian, el \- Greek, uk \- Ukranian, tr \- Turkish, sk \-
-Slovak, sl \- Slovenian, hr \- Croatian, cs \- Czech, bg \- Bul garian ) \
-[however, \ encodings \ are \ not \ available \ for \ all \ of \ the \
-languages \ listed.]
-
-.BR
-[@language.original: \ original \ language \ in \ which \ the \ work \ was \
-published]
-
-.BR
-.B @papersize:
-(A4|US_letter|book_B5|book_A5|US_legal)
-
-.BR
-.B @relation:
-
-.BR
-.B @coverage:
-
-.BR
-.B @rights:
-Copyright (c) Name of Right Holder, all rights reserved, or as granted:
-public domain, copyleft, creative commons variant, etc.
-
-.BR
-.B @owner:
-
-.BR
-.B @keywords:
-text document generation processing management latex pdf structured xml
-citation \ [your \ keywords \ here, \ used \ for \ example \ by \ rss \ feeds,
-\ and \ in \ sql \ searches]
-
-.BR
-.B @abstract:
-\ [paper \ abstract, \ placed \ after \ table \ of \ contents]
-
-.BR
-.B @comment:
-\ [...]
-
-.BR
-.B @catalogue:
-loc=[Library \ of \ Congress \ classification]; dewey=[Dewey \
-classification]; isbn=[ISBN]; pg=[Project \ Gutenberg \ text \ number]
-
-.BR
-.B @classify_loc:
-\ [Library \ of \ Congress \ classification]
-
-.BR
-.B @classify_dewey:
-\ [Dewey \ classification]
-
-.BR
-.B @classify_isbn:
-\ [ISBN]
-
-.BR
-.B @classify_pg:
-\ [Project \ Gutenberg \ text \ number]
-
-.BR
-.B @prefix:
-\ [prefix \ is \ placed \ just \ after \ table \ of \ contents]
-
-.BR
-.B @prefix_a:
-\ [prefix \ is \ placed \ just \ before \ table \ of \ contents \ \- \ not \
-implemented]
-
-.BR
-.B @prefix_b:
-
-.BR
-.B @rcs:
-$Id: sisu_markup.sst,v 1.2 2007/09/08 17:12:47 ralph Exp $ \ [used \ by \ rcs
-\ or \ cvs \ to \ embed \ version \ (revision \ control) \ information \ into \
-document, \ rcs \ or \ cvs \ can \ usefully \ provide \ a \ history \ of \
-updates \ to \ a \ document \ ]
-
-.BR
-.B @structure:
-PART; CHAPTER; SECTION; ARTICLE; none; none;
-optional, document structure can be defined by words to match or regular
-expression (the regular expression is assumed to start at the beginning of a
-line of text i.e. ^) default markers :A~ to :C~ and 1~ to 6~ can be used within
-text instead, without this header tag, and may be used to supplement the
-instructions provided in this header tag if provided (@structure: is a synonym
-for @toc:)
-
-.BR
-.B @level:
-newpage=3; breakpage=4
-\ [paragraph \ level, \ used \ by \ latex \ to \ breakpages, \ the \ page \
-is \ optional \ eg. \ in \ newpage]
-
-.BR
-.B @markup:
-information on the markup used, e.g. new=1,2,3; break=4; num_top=4 \ [or \
-newpage=1,2,3; \ breakpage=4; \ num_top=4] newpage and breakpage, heading
-level, used by LaTeX to breakpages. breakpage: starts on a new page in single
-column text and on a new column in double column text; newpage: starts on a new
-page for both single and double column texts.
-num_top=4 \ [auto\-number \ document, \ starting \ at \ level \ 4. \ the \
-default \ is \ to \ provide \ 3 \ levels, \ as \ in \ 1 \ level \ 4, \ 1.1 \
-level \ 5, \ 1.1.1 \ level \ 6, \ markup \ to \ be \ merged \ within \ level]
-num_extract \ [take \ numbering \ of \ headings \ provided \ (manually \ in \
-marked \ up \ source \ document), \ and \ use \ for \ numbering \ of \
-segments. \ Available \ where \ a \ clear \ numbering \ structure \ is \
-provided \ within \ document, \ without \ the \ repetition \ of \ a \ number \
-in \ a \ header.] \ [In \ 0.38 \ notation, \ you \ would \ map \ to \ the \
-equivalent \ levels, \ the \ examples \ provided \ would \ map \ to \ the \
-following \ new=A,B,C; \ break=1; \ num_top=1 \ \ [or \ newpage=A,B,C; \
-breakpage=1; \ num_top=1] see headings]
-
-.BR
-.B @bold:
-\ [regular \ expression \ of \ words/phrases \ to \ be \ made \ bold]
-
-.BR
-.B @italics:
-\ [regular \ expression \ of \ words/phrases \ to \ italicise]
-
-.BR
-.B @vocabulary:
-name of taxonomy/vocabulary/wordlist to use against document
-
-.BR
-.B @skin:
-skin_doc_[name_of_desired_document_skin]
-skins change default settings related to the appearance of documents
-generated, such as the urls of the home site, and the icon/logo for the
-document or site.
-
-.BR
-.B @links:
-{
-.B SiSU
-}http://www.jus.uio.no/sisu/;
-{ FSF }http://www.fsf.org
-
-.BR
-.B @promo:
-sisu, ruby, search_libre_docs, open_society
-\ [places \ content \ in \ right \ pane \ in \ html, \ makes \ use \ of \
-list.yml \ and \ promo.yml, \ commented \ out \ sample \ in \ document \
-sample: \
-free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst]
-
-.SH
-3. MARKUP OF SUBSTANTIVE TEXT
-.BR
-
-.SH
-3.1 HEADING LEVELS
-
-.BR
-Heading levels are :A~ ,:B~ ,:C~ ,1~ ,2~ ,3~ \... :A \- :C being part / section
-headings, followed by other heading levels, and 1 \-6 being headings followed
-by substantive text or sub\-headings. :A~ usually the title :A~? conditional
-level 1 heading (used where a stand\-alone document may be imported into
-another)
-
-.BR
-.B :A~ \ [heading \ text]
-Top level heading \ [this \ usually \ has \ similar \ content \ to \ the \
-title \ @title: \ ] NOTE: the heading levels described here are in 0.38
-notation, see heading
-
-.BR
-.B :B~ \ [heading \ text]
-Second level heading \ [this \ is \ a \ heading \ level \ divider]
-
-.BR
-.B :C~ \ [heading \ text]
-Third level heading \ [this \ is \ a \ heading \ level \ divider]
-
-.BR
-.B 1~ \ [heading \ text]
-Top level heading preceding substantive text of document or sub\-heading 2,
-the heading level that would normally be marked 1. or 2. or 3. etc. in a
-document, and the level on which sisu by default would break html output into
-named segments, names are provided automatically if none are given (a number),
-otherwise takes the form 1~my_filename_for_this_segment
-
-.BR
-.B 2~ \ [heading \ text]
-Second level heading preceding substantive text of document or sub\-heading
-3, the heading level that would normally be marked 1.1 or 1.2 or 1.3 or 2.1
-etc. in a document.
-
-.BR
-.B 3~ \ [heading \ text]
-Third level heading preceding substantive text of document, that would
-normally be marked 1.1.1 or 1.1.2 or 1.2.1 or 2.1.1 etc. in a document
-
-
-.nf
- 1~filename level 1 heading,
- % the primary division such as Chapter that is followed by substantive text, and may be further subdivided (this is the level on which by default html segments are made)
-.fi
-
-.SH
-3.2 FONT ATTRIBUTES
-
-.BR
-.B markup example:
-
-
-.nf
- normal text !{emphasis}! *{bold text}* _{underscore}_ /{italics}/ \"{citation}\" ^{superscript}^ ,{subscript}, +{inserted text}+
- normal text
- !{emphasis}!
- *{bold text}*
- _{underscore}
- /{italics}/
- \"{citation}\"
- ^{superscript}^
- ,{subscript},
- +{inserted text}+
- \-{strikethrough}\-
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-normal text <em>emphasis</em>
-.B bold text
-.I underscore
-.I italics
-<cite>citation</cite> ^superscript^ \ [subscript] <ins>inserted text</ins>
-<del>strikethrough</del>
-
-.BR
-normal text
-
-.BR
-<em>emphasis</em>
-
-.BR
-.B bold text
-
-.BR
-.I underscore
-
-.BR
-.I italics
-
-.BR
-<cite>citation</cite>
-
-.BR
-^superscript^
-
-.BR
-[subscript]
-
-.BR
-<ins>inserted text</ins>
-
-.BR
-<del>strikethrough</del>
-
-.SH
-3.3 INDENTATION AND BULLETS
-
-.BR
-.B markup example:
-
-
-.nf
- ordinary paragraph
- _1 indent paragraph one step
- _2 indent paragraph two steps
- _9 indent paragraph nine steps
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-ordinary paragraph
-
-.BR
- indent paragraph one step
-
-.BR
- indent paragraph two steps
-
-.BR
- indent paragraph nine steps
-
-.BR
-.B markup example:
-
-
-.nf
- * bullet text
- _1* bullet text, first indent
- _2* bullet text, two step indent
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-* bullet text
-
-.BR
- * bullet text, first indent
-
-.BR
- * bullet text, two step indent
-
-.BR
-Numbered List (not to be confused with headings/titles, (document structure))
-
-.BR
-.B markup example:
-
-
-.nf
- # numbered list numbered list 1., 2., 3, etc.
- _# numbered list numbered list indented a., b., c., d., etc.
-.fi
-
-.SH
-3.4 FOOTNOTES / ENDNOTES
-
-.BR
-Footnotes and endnotes not distinguished in markup. They are automatically
-numbered. Depending on the output file format (html, odf, pdf etc.), the
-document output selected will have either footnotes or endnotes.
-
-.BR
-.B markup example:
-
-
-.nf
- ~{ a footnote or endnote }~
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-[^3]
-
-.BR
-.B markup example:
-
-
-.nf
- normal text~{ self contained endnote marker & endnote in one }~ continues
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-normal text[^4] continues
-
-.BR
-.B markup example:
-
-
-.nf
- normal text ~{* unnumbered asterisk footnote/endnote, insert multiple asterisks if required }~ continues
- normal text ~{** another unnumbered asterisk footnote/endnote }~ continues
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-normal text \ [^*] continues
-
-.BR
-normal text \ [^**] continues
-
-.BR
-.B markup example:
-
-
-.nf
- normal text ~[* \ editors \ notes, \ numbered \ asterisk \ footnote/endnote \ series \ ]~ continues
- normal text ~[+ \ editors \ notes, \ numbered \ asterisk \ footnote/endnote \ series \ ]~ continues
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-normal text \ [^*1] continues
-
-.BR
-normal text \ [^+1] continues
-
-.BR
-.B Alternative endnote pair notation for footnotes/endnotes:
-
-
-.nf
-.nf
- % note the endnote marker \"~^\"
- normal text~^ continues
- ^~ endnote text following the paragraph in which the marker occurs
-.fi
-
-.BR
-the standard and pair notation cannot be mixed in the same document
-
-.SH
-3.5 LINKS
-
-.SH
-3.5.1 NAKED URLS WITHIN TEXT, DEALING WITH URLS
-
-.BR
-urls are found within text and marked up automatically. A url within text is
-automatically hyperlinked to itself and by default decorated with angled
-braces, unless they are contained within a code block (in which case they are
-passed as normal text), or escaped by a preceding underscore (in which case the
-decoration is omitted).
-
-.BR
-.B markup example:
-
-
-.nf
- normal text http://www.jus.uio.no/sisu continues
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-normal text <http://www.jus.uio.no/sisu> continues
-
-.BR
-An escaped url without decoration
-
-.BR
-.B markup example:
-
-
-.nf
- normal text http://www.jus.uio.no/sisu continues
- deb http://www.jus.uio.no/sisu/archive unstable main non\-free
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-normal text http://www.jus.uio.no/sisu continues
-
-.BR
-deb http://www.jus.uio.no/sisu/archive unstable main non\-free
-
-.BR
-where a code block is used there is neither decoration nor hyperlinking, code
-blocks are discussed later in this document
-
-.BR
-.B resulting output:
-
-
-.nf
- deb http://www.jus.uio.no/sisu/archive unstable main non\-free
- deb\-src http://www.jus.uio.no/sisu/archive unstable main non\-free
-.fi
-
-.BR
-To link text or an image to a url the markup is as follows
-
-.BR
-.B markup example:
-
-
-.nf
- about { SiSU }http://url.org markup
-.fi
-
-.SH
-3.5.2 LINKING TEXT
-
-.BR
-.B resulting output:
-
-.BR
-about SiSU <http://www.jus.uio.no/sisu/> markup
-
-.BR
-A shortcut notation is available so the url link may also be provided
-automatically as a footnote
-
-.BR
-.B markup example:
-
-
-.nf
- about {~^ SiSU }http://url.org markup
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-about SiSU <http://www.jus.uio.no/sisu/> \ [^5] markup
-
-.SH
-3.5.3 LINKING IMAGES
-
-.BR
-.B markup example:
-
-
-.nf
- [ tux.png ]
- % various url linked images
- [ tux.png ]
- [ GnuDebianLinuxRubyBetterWay.png ]
- {~^ ruby_logo.png \"Ruby\" }http://www.ruby\-lang.org/en/
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-[ tux.png ]
-
-.BR
-tux.png 64x80 \"Gnu/Linux \- a better way\" <http://www.jus.uio.no/sisu/>
-
-.BR
-[ \ ruby_logo \ (png \ missing) \ ] \ [^6]
-
-.BR
-GnuDebianLinuxRubyBetterWay.png 100x101 \"Way Better \- with Gnu/Linux, Debian
-and Ruby\" <http://www.jus.uio.no/sisu/>
-
-.BR
-.B linked url footnote shortcut
-
-
-.nf
- {~^ \ [text \ to \ link] }http://url.org
- % maps to: { \ [text \ to \ link] }http://url.org ~{ http://url.org }~
- % which produces hyper\-linked text within a document/paragraph, with an endnote providing the url for the text location used in the hyperlink
-.fi
-
-
-.nf
- text marker *~name
-.fi
-
-.BR
-note at a heading level the same is automatically achieved by providing names
-to headings 1, 2 and 3 i.e. 2~[name] and 3~[name] or in the case of
-auto\-heading numbering, without further intervention.
-
-.SH
-3.6 GROUPED TEXT
-
-.SH
-3.6.1 TABLES
-
-.BR
-Tables may be prepared in two either of two forms
-
-.BR
-.B markup example:
-
-
-.nf
- table{ c3; 40; 30; 30;
- This is a table
- this would become column two of row one
- column three of row one is here
- And here begins another row
- column two of row two
- column three of row two, and so on
- }table
-.fi
-
-.BR
-.B resulting output:
-
- \ [table \ omitted, \ see \ other \ document \ formats]
-
-.BR
-a second form may be easier to work with in cases where there is not much
-information in each column
-
-.BR
-.B markup example:
-[^7]
-
-
-.nf
- !_ Table 3.1: Contributors to Wikipedia, January 2001 \- June 2005
- {table~h 24; 12; 12; 12; 12; 12; 12;}
- |Jan. 2001|Jan. 2002|Jan. 2003|Jan. 2004|July 2004|June 2006
- Contributors* | 10| 472| 2,188| 9,653| 25,011| 48,721
- Active contributors** | 9| 212| 846| 3,228| 8,442| 16,945
- Very active contributors*** | 0| 31| 190| 692| 1,639| 3,016
- No. of English language articles| 25| 16,000| 101,000| 190,000| 320,000| 630,000
- No. of articles, all languages | 25| 19,000| 138,000| 490,000| 862,000|1,600,000
- \\* Contributed at least ten times; \\** at least 5 times in last month; \\*\** more than 100 times in last month.
-.fi
-
-.BR
-.B resulting output:
-
-.BR
-.B Table 3.1: Contributors to Wikipedia, January 2001 \- June 2005
-
- \ [table \ omitted, \ see \ other \ document \ formats]
-
-.BR
-* Contributed at least ten times; ** at least 5 times in last month; *** more
-than 100 times in last month.
-
-.SH
-3.6.2 POEM
-
-.BR
-.B basic markup:
-
-
-.nf
- poem{
- Your poem here
- }poem
- Each verse in a poem is given a separate object number.
-.fi
-
-.BR
-.B markup example:
-
-
-.nf
- poem{
- \'Fury said to a
- mouse, That he
- met in the
- house,
- \"Let us
- both go to
- law: I will
- prosecute
- YOU. \-\-Come,
- I\'ll take no
- denial; We
- must have a
- trial: For
- really this
- morning I\'ve
- nothing
- to do.\"
- Said the
- mouse to the
- cur, \"Such
- a trial,
- dear Sir,
- With
- no jury
- or judge,
- would be
- wasting
- our
- breath.\"
- \"I\'ll be
- judge, I\'ll
- be jury,\"
- Said
- cunning
- old Fury:
- \"I\'ll
- try the
- whole
- cause,
- and
- condemn
- you
- to
- death.\"\'
- }poem
-.fi
-
-.BR
-.B resulting output:
-
-
- \'Fury said to a
-.P
- mouse, That he
-.P
- met in the
-.P
- house,
-.P
- \"Let us
-.P
- both go to
-.P
- law: I will
-.P
- prosecute
-.P
- YOU. \-\-Come,
-.P
- I\'ll take no
-.P
- denial; We
-.P
- must have a
-.P
- trial: For
-.P
- really this
-.P
- morning I\'ve
-.P
- nothing
-.P
- to do.\"
-.P
- Said the
-.P
- mouse to the
-.P
- cur, \"Such
-.P
- a trial,
-.P
- dear Sir,
-.P
- With
-.P
- no jury
-.P
- or judge,
-.P
- would be
-.P
- wasting
-.P
- our
-.P
- breath.\"
-.P
- \"I\'ll be
-.P
- judge, I\'ll
-.P
- be jury,\"
-.P
- Said
-.P
- cunning
-.P
- old Fury:
-.P
- \"I\'ll
-.P
- try the
-.P
- whole
-.P
- cause,
-.P
- and
-.P
- condemn
-.P
- you
-.P
- to
-.P
- death.\"\'
-.P
-
-.SH
-3.6.3 GROUP
-
-.BR
-.B basic markup:
-
-
-.nf
- group{
- Your grouped text here
- }group
- A group is treated as an object and given a single object number.
-.fi
-
-.BR
-.B markup example:
-
-
-.nf
- group{
- \'Fury said to a
- mouse, That he
- met in the
- house,
- \"Let us
- both go to
- law: I will
- prosecute
- YOU. \-\-Come,
- I\'ll take no
- denial; We
- must have a
- trial: For
- really this
- morning I\'ve
- nothing
- to do.\"
- Said the
- mouse to the
- cur, \"Such
- a trial,
- dear Sir,
- With
- no jury
- or judge,
- would be
- wasting
- our
- breath.\"
- \"I\'ll be
- judge, I\'ll
- be jury,\"
- Said
- cunning
- old Fury:
- \"I\'ll
- try the
- whole
- cause,
- and
- condemn
- you
- to
- death.\"\'
- }group
-.fi
-
-.BR
-.B resulting output:
-
-
- \'Fury said to a
-.P
- mouse, That he
-.P
- met in the
-.P
- house,
-.P
- \"Let us
-.P
- both go to
-.P
- law: I will
-.P
- prosecute
-.P
- YOU. \-\-Come,
-.P
- I\'ll take no
-.P
- denial; We
-.P
- must have a
-.P
- trial: For
-.P
- really this
-.P
- morning I\'ve
-.P
- nothing
-.P
- to do.\"
-.P
- Said the
-.P
- mouse to the
-.P
- cur, \"Such
-.P
- a trial,
-.P
- dear Sir,
-.P
- With
-.P
- no jury
-.P
- or judge,
-.P
- would be
-.P
- wasting
-.P
- our
-.P
- breath.\"
-.P
- \"I\'ll be
-.P
- judge, I\'ll
-.P
- be jury,\"
-.P
- Said
-.P
- cunning
-.P
- old Fury:
-.P
- \"I\'ll
-.P
- try the
-.P
- whole
-.P
- cause,
-.P
- and
-.P
- condemn
-.P
- you
-.P
- to
-.P
- death.\"\'
-.P
-
-.SH
-3.6.4 CODE
-
-.BR
-Code tags are used to escape regular sisu markup, and have been used
-extensively within this document to provide examples of
-.B SiSU
-markup. You cannot however use code tags to escape code tags. They are
-however used in the same way as group or poem tags.
-
-.BR
-A code\-block is treated as an object and given a single object number. \ [an \
-option \ to \ number \ each \ line \ of \ code \ may \ be \ considered \ at \
-some \ later \ time]
-
-.BR
-.B use of code tags instead of poem compared, resulting output:
-
-
-.nf
- \'Fury said to a
- mouse, That he
- met in the
- house,
- \"Let us
- both go to
- law: I will
- prosecute
- YOU. \-\-Come,
- I\'ll take no
- denial; We
- must have a
- trial: For
- really this
- morning I\'ve
- nothing
- to do.\"
- Said the
- mouse to the
- cur, \"Such
- a trial,
- dear Sir,
- With
- no jury
- or judge,
- would be
- wasting
- our
- breath.\"
- \"I\'ll be
- judge, I\'ll
- be jury,\"
- Said
- cunning
- old Fury:
- \"I\'ll
- try the
- whole
- cause,
- and
- condemn
- you
- to
- death.\"\'
-.fi
-
-.SH
-4. COMPOSITE DOCUMENTS MARKUP
-.BR
-
-.BR
-It is possible to build a document by creating a master document that requires
-other documents. The documents required may be complete documents that could be
-generated independently, or they could be markup snippets, prepared so as to be
-easily available to be placed within another text. If the calling document is a
-master document (built from other documents), it should be named with the
-suffix
-.B \.ssm
-Within this document you would provide information on the other documents
-that should be included within the text. These may be other documents that
-would be processed in a regular way, or markup bits prepared only for inclusion
-within a master document
-.B \.sst
-regular markup file, or
-.B \.ssi
-(insert/information) A secondary file of the composite document is built
-prior to processing with the same prefix and the suffix
-.B \._sst
-
-.BR
-basic markup for importing a document into a master document
-
-
-.nf
- << |filename1.sst|@|^|
- << |filename2.ssi|@|^|
-.fi
-
-.BR
-The form described above should be relied on. Within the Vim editor it results
-in the text thus linked becoming hyperlinked to the document it is calling in
-which is convenient for editing. Alternative markup for importation of
-documents under consideration, and occasionally supported have been.
-
-
-.nf
- r{filename}
- {filename.ssi}require
- << {filename.ssi}
- % using textlink alternatives
- |filename.ssi|@|^|require
- << |filename.ssi|@|^|
- % using thlnk alternatives
- <url:filename.ssi>require
- << <url:filename.ssi>
-.fi
-
-.SH
-MARKUP SYNTAX HISTORY
-.BR
-
-.SH
-5. NOTES RELATED TO FILES\-TYPES AND MARKUP SYNTAX
-.BR
-
-.BR
-0.38 is substantially current, depreciated 0.16 supported, though file names
-were changed at 0.37
-
-.BR
-.B 0.52
-(2007w14/6) declared document type identifier at start of text/document:
-
-.BR
- .B SiSU
-0.52
-
-.BR
-or, backward compatible using the comment marker:
-
-.BR
- %
-.B SiSU
-0.38
-
-.BR
-variations include \'
-.B SiSU
-(text|master|insert) \ [version]\' and \'sisu\-[version]\'
-
-.BR
-.B 0.51
-(2007w13/6) skins changed (simplified), markup unchanged
-
-.BR
-.B 0.42
-(2006w27/4) * (asterisk) type endnotes, used e.g. in relation to author
-
-.BR
-.B 0.38
-(2006w15/7) introduced new/alternative notation for headers, e.g. @title:
-(instead of 0~title), and accompanying document structure markup,
-:A,:B,:C,1,2,3 (maps to previous 1,2,3,4,5,6)
-
-.BR
-.B 0.37
-(2006w09/7) introduced new file naming convention, \.sst (text), \.ssm
-(master), \.ssi (insert), markup syntax unchanged
-
-.BR
-.B 0.35
-(2005w52/3) sisupod, zipped content file introduced
-
-.BR
-.B 0.23
-(2005w36/2) utf\-8 for markup file
-
-.BR
-.B 0.22
-(2005w35/3) image dimensions may be omitted if rmagick is available to be
-relied upon
-
-.BR
-.B 0.20.4
-(2005w33/4) header 0~links
-
-.BR
-.B 0.16
-(2005w25/2) substantial changes introduced to make markup cleaner, header
-0~title type, and headings \ [1\-6]~ introduced, also percentage sign (%) at
-start of a text line as comment marker
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Markup
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-08\-28
-
-.BR
-DC Date issued:
-.I 2002\-08\-28
-
-.BR
-DC Date available:
-.I 2002\-08\-28
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_markup.sst
-
-.BR
-Filetype:
-.I SiSU text 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_markup.sst)=
-.I 6848f40f5844e0a7d59dbb86b3ddae92
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:43 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-.TP
-.BI 1.
-From sometime after SiSU 0.58 it should be possible to describe SiSU markup
-using SiSU, which though not an original design goal is useful.
-.TP
-.BI 2.
-files should be prepared using UTF-8 character encoding
-.TP
-.BI 3.
-a footnote or endnote
-.TP
-.BI 4.
-self contained endnote marker & endnote in one
-.TP
-.BI *.
-unnumbered asterisk footnote/endnote, insert multiple asterisks if required
-.TP
-.BI **.
-another unnumbered asterisk footnote/endnote
-.TP
-.BI *1.
-editors notes, numbered asterisk footnote/endnote series
-.TP
-.BI +1.
-editors notes, numbered asterisk footnote/endnote series
-.TP
-.BI 5.
-<http://www.jus.uio.no/sisu/>
-.TP
-.BI 6.
-<http://www.ruby-lang.org/en/>
-.TP
-.BI 7.
-Table from the Wealth of Networks by Yochai Benkler
- <http://www.jus.uio.no/sisu/the_wealth_of_networks.yochai_benkler>
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_markup/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_markup/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_markup/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_markup/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_markup/sisu_markup.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:50 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man1/sisu_skin.1 b/man/man1/sisu_skin.1
deleted file mode 100644
index 20f337d8..00000000
--- a/man/man1/sisu_skin.1
+++ /dev/null
@@ -1,222 +0,0 @@
-.TH "sisu_skin" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- SKINS,
-RALPH AMISSAH
-.BR
-
-.SH
-DOCUMENT SKINS \- CONFIGURATION
-.BR
-
-.SH
-1. SKINS
-.BR
-
-.BR
-Skins modify the default appearance of document output on a document,
-directory, or site wide basis. Skins are looked for in the following locations:
-
-.BR
- \./_sisu/skin
-
-.BR
- ~/.sisu/skin
-
-.BR
- /etc/sisu/skin
-
-.BR
-.B Within the skin directory
-are the following the default sub\-directories for document skins:
-
-.BR
- \./skin/doc
-
-.BR
- \./skin/dir
-
-.BR
- \./skin/site
-
-.BR
-A skin is placed in the appropriate directory and the file named skin_[name].rb
-
-.BR
-The skin itself is a ruby file which modifies the default appearances set in
-the program.
-
-.SH
-1.1 DOCUMENT SKIN
-
-.BR
-Documents take on a document skin, if the header of the document specifies a
-skin to be used.
-
-
-.nf
- @skin: skin_united_nations
-.fi
-
-.SH
-1.2 DIRECTORY SKIN
-
-.BR
-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).
-
-.BR
-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.
-
-.SH
-1.3 SITE SKIN
-
-.BR
-A site skin, modifies the program default skin.
-
-.SH
-1.4 SAMPLE SKINS
-
-.BR
-With
-.B SiSU
-installed sample skins may be found in:
-
-.BR
- /etc/sisu/skin/doc and
- /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/doc
-
-.BR
-(or equivalent directory) and if sisu\-markup\-samples is installed also under:
-
-.BR
- /usr/share/doc/sisu/sisu_markup_samples/non\-free/_sisu/skin/doc
-
-.BR
-Samples of list.yml and promo.yml (which are used to create the right column
-list) may be found in:
-
-.BR
- /usr/share/doc/sisu/sisu_markup_samples/dfsg/_sisu/skin/yml (or equivalent
- directory)
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Skins
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-11\-12
-
-.BR
-DC Date issued:
-.I 2002\-11\-12
-
-.BR
-DC Date available:
-.I 2002\-11\-12
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_skin.sst
-
-.BR
-Filetype:
-.I SiSU text insert 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_skin.sst)=
-.I 8aebfb5312045c3a705ad6c314246f67
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:44 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_skin/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_skin/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_skin/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_skin/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_skin/sisu_skin.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:50 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man7/sisu_complete.7 b/man/man7/sisu_complete.7
deleted file mode 100644
index 4407bc7a..00000000
--- a/man/man7/sisu_complete.7
+++ /dev/null
@@ -1,181 +0,0 @@
-.TH "sisu_complete" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- COMPLETE PACKAGE,
-RALPH AMISSAH
-.BR
-
-.SH
-1. SISU_COMPLETE
-.BR
-
-.SH
-1.1 NAME
-
-.BR
-.B SiSU
-\- Structured information, Serialized Units \- a document publishing system,
-complete dependency package
-
-.SH
-1.2 SYNOPSIS
-
-.BR
-.B Debian
-dummy package installs the whole of
-.B SiSU
-, excluding sisu\-examples.
-
-.BR
-sisu\-complete together with sisu\-examples is the whole of
-.B SiSU
-
-.SH
-1.3 FURTHER INFORMATION
-
-.BR
-For more information on
-.B SiSU
-see:
-
-.BR
-<http://www.jus.uio.no/sisu/sisu_manual>
-
-.BR
-<http://www.jus.uio.no/sisu>
-
-.SH
-1.4 AUTHOR
-
-.BR
-Ralph Amissah ralph@amissah.com or ralph.amissah@gmail.com
-
-.SH
-1.5 SEE
-
-.BR
-sisu(1)
-
-.SH
-1.6 ALSO SEE
-
-.BR
-sisu_webrick(1), sisu_pdf(7) sisu_sqlite(7) sisu_postgresql(7) sisu_vim(7)
-sisu_termsheet(1)
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_complete/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Complete Package
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-08\-28
-
-.BR
-DC Date issued:
-.I 2002\-08\-28
-
-.BR
-DC Date available:
-.I 2002\-08\-28
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_complete.sst
-
-.BR
-Filetype:
-.I SiSU text 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_complete.sst)=
-.I 0974a5dfc0c6bc648ac21c688177bec0
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:47 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_complete/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_complete/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_complete/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_complete/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_complete/sisu_complete.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:52 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man7/sisu_doc.7 b/man/man7/sisu_doc.7
deleted file mode 100644
index 169d74b6..00000000
--- a/man/man7/sisu_doc.7
+++ /dev/null
@@ -1,160 +0,0 @@
-.TH "sisu_doc" "1" "2007-09-24" "0.59.1" "SiSU"
-.SH
-SISU \- SISU\-DOC,
-RALPH AMISSAH
-.BR
-
-.SH
-SISU DOC
-.BR
-
-.SH
-SISU\-DOC
-.BR
-
-.SH
-1.1 NAME
-
-.BR
-.B SiSU
-\- Structured information, Serialized Units \- a document publishing system.
-
-.BR
-Information related to sisu documentation
-
-.SH
-1.2 DESCRIPTION
-
-.BR
-sisu documentation is installed in /usr/share/doc/sisu/sisu_manual or
-equivalent directory
-
-.BR
-file:///usr/share/doc/sisu/sisu_manual
-
-.BR
-file:///usr/share/doc/sisu/sisu_manual/sisu_manual/
-
-.BR
-<http://www.jus.uio.no/sisu/sisu_manual>
-
-.BR
-<http://www.sisudoc.org/sisu_manual>
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_doc/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- sisu\-doc
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2007\-09\-24
-
-.BR
-DC Date issued:
-.I 2007\-09\-24
-
-.BR
-DC Date available:
-.I 2007\-09\-24
-
-.BR
-DC Date modified:
-.I 2007\-09\-24
-
-.BR
-DC Date:
-.I 2007\-09\-24
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_doc.sst
-
-.BR
-Filetype:
-.I SiSU text 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_doc.sst)=
-.I 00116fb664a23c87ce52dbe0d4c5a702
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:48 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_doc/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_doc/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_doc/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_doc/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_doc/sisu_doc.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:52 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man7/sisu_pdf.7 b/man/man7/sisu_pdf.7
deleted file mode 100644
index 6c1d4fdb..00000000
--- a/man/man7/sisu_pdf.7
+++ /dev/null
@@ -1,212 +0,0 @@
-.TH "sisu_pdf" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- PDF,
-RALPH AMISSAH
-.BR
-
-.SH
-SISU PDF
-.BR
-
-.SH
-1. SISU PDF
-.BR
-
-.SH
-1.1 NAME
-
-.BR
-.B SiSU
-\- Structured information, Serialized Units \- a document publishing system.
-
-.SH
-1.2 DESCRIPTION
-
-.BR
-Information creating pdf output with sisu (and related to the sisu_pdf
-dependency package, which is a dummy package to install dependencies needed for
-.B SiSU
-to generate pdfs (primarily related to LaTeX), sisu_pdf being part of
-.B SiSU
-\- man sisu).
-
-.BR
-.B SiSU
-generates LaTeX which is converted by LaTeX tools to pdf.
-
-.SH
-1.3 SYNOPSIS
-
-.BR
- sisu \-pv \ [filename/wildcard]
-
-.SH
-1.4 COMMANDS
-
-.TP
-.B \ sisu \ \-pv \ \ [filename/wildcard]
-creates two pdf documents: vertical (portrait.pdf) and; horizontal
-(landscape.pdf).
-.B SiSU
-generates LaTeX output which is converted to pdf if the appropriate LaTeX
-dependencies are met on the system.
-
-.TP
-.B \ sisu \ \-pv \ \-\-papersize\-a4 \ \ [filename/wildcard]
-overrides the default papersize set to A4. Preset alternative sizes include:
-\'A4\', U.S. \'letter\' and \'legal\' and book sizes \'A5\' and \'B5\' (system
-defaults to A4).
-
-.SH
-1.5 SETTING PAPER SIZE
-
-.BR
-The paper\-size may be set to any of the following sizes: \'A4\', U.S.
-\'letter\' and \'legal\' and book sizes: \'A5\' and \'B5\'
-
-.BR
-1. The preset default if not otherwise given in the configuration file or
-elsewhere is A4.
-
-.BR
-2. The default paper size may be set in the configuration file sisurc.yml. See
-sisu_configuration:
-
-
-.nf
- #% papersize, (LaTeX/pdf) current values A4, US_letter, book_b5, book_a5, US_legal
- default:
- papersize: \'A4\'
-.fi
-
-.BR
-3. Paper size may be set in a document header:
-
-
-.nf
- @papersize: (A4|US_letter|book_B5|book_A5|US_legal)
-.fi
-
-.BR
-4. or provided with additional command line parameter, e.g.
-
-.BR
- sisu \-pv \-\-papersize\-a4 \ [filename/wildcard]
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_pdf/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- PDF
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-08\-28
-
-.BR
-DC Date issued:
-.I 2002\-08\-28
-
-.BR
-DC Date available:
-.I 2002\-08\-28
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_pdf.sst
-
-.BR
-Filetype:
-.I SiSU text 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_pdf.sst)=
-.I 63bca4cff790aa5ca87bea788c520076
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:47 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_pdf/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_pdf/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_pdf/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_pdf/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_pdf/sisu_pdf.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:52 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man7/sisu_postgresql.7 b/man/man7/sisu_postgresql.7
deleted file mode 100644
index 9ba0e5a4..00000000
--- a/man/man7/sisu_postgresql.7
+++ /dev/null
@@ -1,223 +0,0 @@
-.TH "sisu_postgresql" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- SEARCH,
-RALPH AMISSAH
-.BR
-
-.SH
-SISU SEARCH
-.BR
-
-.SH
-SISU POSTGRESQL
-.BR
-
-.SH
-1. POSTGRESQL
-.BR
-
-.SH
-1.1 NAME
-
-.BR
-.B SiSU
-\- Structured information, Serialized Units \- a document publishing system,
-postgresql dependency package
-
-.SH
-1.2 DESCRIPTION
-
-.BR
-Information related to using postgresql with sisu (and related to the
-sisu_postgresql dependency package, which is a dummy package to install
-dependencies needed for
-.B SiSU
-to populate a postgresql database, this being part of
-.B SiSU
-\- man sisu).
-
-.SH
-1.3 SYNOPSIS
-
-.BR
- sisu \-D \ [instruction] \ [filename/wildcard \ if \ required]
-
-.BR
- sisu \-D \-\-pg \-\-[instruction] \ [filename/wildcard \ if \ required]
-
-.SH
-1.4 COMMANDS
-
-.BR
-Mappings to two databases are provided by default, postgresql and sqlite, the
-same commands are used within sisu to construct and populate databases however
-\-d (lowercase) denotes sqlite and \-D (uppercase) denotes postgresql,
-alternatively \-\-sqlite or \-\-pgsql may be used
-
-.BR
-.B \-D or \-\-pgsql
-may be used interchangeably.
-
-.SH
-1.4.1 CREATE AND DESTROY DATABASE
-
-.TP
-.B \ \-\-pgsql \ \-\-createall
-\ initial \ step, \ creates \ required \ relations \ (tables, \ indexes) \ in
-\ existing \ (postgresql) \ database \ (a \ database \ should \ be \ created \
-manually \ and \ given \ the \ same \ name \ as \ working \ directory, \ as \
-requested) \ (rb.dbi) \
-
-.TP
-.B \ sisu \ \-D \ \-\-createdb
-\ creates \ database \ where \ no \ database \ existed \ before \
-
-.TP
-.B \ sisu \ \-D \ \-\-create
-\ creates \ database \ tables \ where \ no \ database \ tables \ existed \
-before \
-
-.TP
-.B \ sisu \ \-D \ \-\-Dropall
-\ destroys \ database \ (including \ all \ its \ content)! \ kills \ data \
-and \ drops \ tables, \ indexes \ and \ database \ associated \ with \ a \
-given \ directory \ (and \ directories \ of \ the \ same \ name). \
-
-.TP
-.B \ sisu \ \-D \ \-\-recreate
-\ destroys \ existing \ database \ and \ builds \ a \ new \ empty \ database
-\ structure \
-
-.SH
-1.4.2 IMPORT AND REMOVE DOCUMENTS
-
-.TP
-.B \ sisu \ \-D \ \-\-import \ \-v \ \ [filename/wildcard]
-populates database with the contents of the file. Imports documents(s)
-specified to a postgresql database (at an object level).
-
-.TP
-.B \ sisu \ \-D \ \-\-update \ \-v \ \ [filename/wildcard]
-updates file contents in database
-
-.TP
-.B \ sisu \ \-D \ \-\-remove \ \-v \ \ [filename/wildcard]
-removes specified document from postgresql database.
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Search
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-08\-28
-
-.BR
-DC Date issued:
-.I 2002\-08\-28
-
-.BR
-DC Date available:
-.I 2002\-08\-28
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_postgresql.sst
-
-.BR
-Filetype:
-.I SiSU text 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_postgresql.sst)=
-.I 5f9ca1acb186a64f8e924876892dc25e
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:47 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_postgresql/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_postgresql/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_postgresql/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_postgresql/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_postgresql/sisu_postgresql.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:52 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man7/sisu_sqlite.7 b/man/man7/sisu_sqlite.7
deleted file mode 100644
index b1061671..00000000
--- a/man/man7/sisu_sqlite.7
+++ /dev/null
@@ -1,222 +0,0 @@
-.TH "sisu_sqlite" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- SEARCH,
-RALPH AMISSAH
-.BR
-
-.SH
-SISU SEARCH
-.BR
-
-.SH
-SISU SQLITE
-.BR
-
-.SH
-1. SQLITE
-.BR
-
-.SH
-1.1 NAME
-
-.BR
-.B SiSU
-\- Structured information, Serialized Units \- a document publishing system.
-
-.SH
-1.2 DESCRIPTION
-
-.BR
-Information related to using sqlite with sisu (and related to the sisu_sqlite
-dependency package, which is a dummy package to install dependencies needed for
-.B SiSU
-to populate an sqlite database, this being part of
-.B SiSU
-\- man sisu).
-
-.SH
-1.3 SYNOPSIS
-
-.BR
- sisu \-d \ [instruction] \ [filename/wildcard \ if \ required]
-
-.BR
- sisu \-d \-\-(sqlite|pg) \-\-[instruction] \ [filename/wildcard \ if \
- required]
-
-.SH
-1.4 COMMANDS
-
-.BR
-Mappings to two databases are provided by default, postgresql and sqlite, the
-same commands are used within sisu to construct and populate databases however
-\-d (lowercase) denotes sqlite and \-D (uppercase) denotes postgresql,
-alternatively \-\-sqlite or \-\-pgsql may be used
-
-.BR
-.B \-d or \-\-sqlite
-may be used interchangeably.
-
-.SH
-1.4.1 CREATE AND DESTROY DATABASE
-
-.TP
-.B \ \-\-sqlite \ \-\-createall
-\ initial \ step, \ creates \ required \ relations \ (tables, \ indexes) \ in
-\ existing \ (sqlite) \ database \ (a \ database \ should \ be \ created \
-manually \ and \ given \ the \ same \ name \ as \ working \ directory, \ as \
-requested) \ (rb.dbi) \
-
-.TP
-.B \ sisu \ \-d \ \-\-createdb
-\ creates \ database \ where \ no \ database \ existed \ before \
-
-.TP
-.B \ sisu \ \-d \ \-\-create
-\ creates \ database \ tables \ where \ no \ database \ tables \ existed \
-before \
-
-.TP
-.B \ sisu \ \-d \ \-\-dropall
-\ destroys \ database \ (including \ all \ its \ content)! \ kills \ data \
-and \ drops \ tables, \ indexes \ and \ database \ associated \ with \ a \
-given \ directory \ (and \ directories \ of \ the \ same \ name). \
-
-.TP
-.B \ sisu \ \-d \ \-\-recreate
-\ destroys \ existing \ database \ and \ builds \ a \ new \ empty \ database
-\ structure \
-
-.SH
-1.4.2 IMPORT AND REMOVE DOCUMENTS
-
-.TP
-.B \ sisu \ \-d \ \-\-import \ \-v \ \ [filename/wildcard]
-populates database with the contents of the file. Imports documents(s)
-specified to an sqlite database (at an object level).
-
-.TP
-.B \ sisu \ \-d \ \-\-update \ \-v \ \ [filename/wildcard]
-updates file contents in database
-
-.TP
-.B \ sisu \ \-d \ \-\-remove \ \-v \ \ [filename/wildcard]
-removes specified document from sqlite database.
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_sqlite/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Search
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-08\-28
-
-.BR
-DC Date issued:
-.I 2002\-08\-28
-
-.BR
-DC Date available:
-.I 2002\-08\-28
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_sqlite.sst
-
-.BR
-Filetype:
-.I SiSU text 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_sqlite.sst)=
-.I 2ffb869c7c41615ca4ec83d8bd70470d
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:47 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_sqlite/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_sqlite/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_sqlite/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_sqlite/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_sqlite/sisu_sqlite.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:52 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man8/sisu_faq.8 b/man/man8/sisu_faq.8
deleted file mode 100644
index 72b4e0f6..00000000
--- a/man/man8/sisu_faq.8
+++ /dev/null
@@ -1,402 +0,0 @@
-.TH "sisu_faq" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- FAQ \- FREQUENTLY ASKED/ANSWERED QUESTIONS,
-RALPH AMISSAH
-.BR
-
-.SH
-1. FAQ \- FREQUENTLY ASKED/ANSWERED QUESTIONS
-.BR
-
-.SH
-1.1 WHY ARE URLS PRODUCED WITH THE \-V (AND \-U) FLAG THAT POINT TO A WEB
-SERVER ON PORT 8081?
-
-.BR
-Try the following rune:
-
-.BR
-* sisu \-W
-
-.BR
-This should start the ruby webserver. It should be done after having produced
-some output as it scans the output directory for what to serve.
-
-.SH
-1.2 I CANNOT FIND MY OUTPUT, WHERE IS IT?
-
-.BR
-The following should provide help on output paths:
-
-.BR
-* sisu \-\-help env
-
-.BR
-* sisu \-V \ [same \ as \ the \ previous \ command]
-
-.BR
-* sisu \-\-help directory
-
-.BR
-* sisu \-\-help path
-
-.BR
-* sisu \-U \ [filename]
-
-.BR
-* man sisu
-
-.SH
-1.3 I DO NOT GET ANY PDF OUTPUT, WHY?
-
-.BR
-.B SiSU
-produces LaTeX and pdflatex is run against that to generate pdf files.
-
-.BR
-If you use
-.B Debian
-the following will install the required dependencies
-
-.BR
-* aptitude install sisu\-pdf
-
-.BR
-the following packages are required: tetex\-bin, tetex\-extra, latex\-ucs
-
-.SH
-1.4 WHERE IS THE LATEX (OR SOME OTHER INTERIM) OUTPUT?
-
-.BR
-Try adding \-M (for maintenance) to your command flags, e.g.:
-
-.BR
-* sisu \-HpMv \ [filename]
-
-.BR
-this should result in the interim processing output being retained, and
-information being provided on where to find it.
-
-.BR
-* sisu \-\-help directory
-
-.BR
-* sisu \-\-help path
-
-.BR
-should also provide some relevant information as to where it is placed.
-
-.SH
-1.5 WHY ISN\'T SISU MARKUP XML
-
-.BR
-I worked with text and (though I find XML immensely valuable) disliked noise
-\... better to sidestep the question and say:
-
-.BR
-.B SiSU
-currently \"understands\" three XML input representations \- or more
-accurately, converts from three forms of XML to native
-.B SiSU
-markup for processing. The three types correspond to SAX (structure
-described), DOM (structure embedded, whole document must be read before
-structure is correctly discernable) and node based (a tree) forms of XML
-document structure representation. Problem is I use them very seldom and check
-that all is as it should be with them seldom, so I would not be surprised if
-something breaks there, but as far as I know they are working. I will check and
-add an XML markup help page before the next release. There already is a bit of
-information in the man page under the title
-.B SiSU
-VERSION CONVERSION
-
-.BR
- sisu \-\-to\-sax \ [filename/wildcard]
-
-.BR
- sisu \-\-to\-dom \ [filename/wildcard]
-
-.BR
- sisu \-\-to\-node \ [filename/wildcard]
-
-.BR
-The XML should be well formed... must check, but lacks sensible headers.
-Suggestions welcome as to what to make of them. \ [For \ the \ present \ time \
-I \ am \ satisfied \ that \ I \ can \ convert \ (both \ ways) \ between \ 3 \
-forms \ of \ XML \ representation \ and
-.B \ SiSU
-\ markup].
-
-.BR
- sisu \-\-from\-xml2sst \ [filename/wildcard]
-
-.SH
-1.6 LATEX CLAIMS TO BE A DOCUMENT PREPARATION SYSTEM FOR HIGH\-QUALITY
-TYPESETTING. CAN THE SAME BE SAID ABOUT SISU?
-
-.BR
-.B SiSU
-is not really about type\-setting.
-
-.BR
-LaTeX is the ultimate computer instruction type\-setting language for paper
-based publication.
-
-.BR
-LaTeX is able to control just about everything that happens on page and pixel,
-position letters kerning, space variation between characters, words, paragraphs
-etc. formula.
-
-.BR
-.B SiSU
-is not really about type\-setting at all. It is about a lightweight markup
-instruction that provides enough information for an abstraction of the
-documents structure and objects, from which different forms of representation
-of the document can be generated.
-
-.BR
-.B SiSU
-with very little markup instruction is able to produce relatively high
-quality pdf by virtue of being able to generate usable default LaTeX; it
-produces \"quality\" html by generating the html directly; likewise it
-populates an SQL database in a useful way with the document in object sized
-chunks and its meta\-data. But
-.B SiSU
-works on an abstraction of the document\'s structure and content and custom
-builds suitable uniform output. The html for browser viewing and pdf for paper
-viewing/publishing are rather different things with different needs for layout
-\- as indeed is what is needed to store information in a database in searchable
-objects.
-
-.BR
-The pdfs or html produced for example by open office based on open document
-format and other office/word processor suits usually attempt to have similar
-looking outputs \- your document rendered in html looks much the same, or in
-pdf... sisu is less this way, it seeks to have a starting point with as little
-information about appearance as possible, and to come up with the best possible
-appearance for each output that can be derived based on this minimal
-information.
-
-.BR
-Where there are large document sets, it provides consistency in appearance in
-each output format for the documents.
-
-.BR
-The excuse for going this way is, it is a waste of time to think much about
-appearance when working on substantive content, it is the substantive content
-that is relevant, not the way it looks beyond the basic informational tags \-
-and yet you want to be able to take advantage of as many useful different ways
-of representing documents as are available, and for various types of output to
-to be/look as good as it can for each medium/format in which it is presented,
-(with different mediums having different focuses) and
-.B SiSU
-tries to achieve this from minimal markup.
-
-.SH
-1.7 HOW DO I CREATE GIN OR GIST INDEX IN POSTGRESQL FOR USE IN SISU
-
-.BR
-This at present needs to be done \"manually\" and it is probably necessary to
-alter the sample search form. The following is a helpful response from one of
-the contributors of GiN to Postgresql Oleg Bartunov 2006\-12\-06:
-
-.BR
-\"I have tsearch2 slides which introduces tsearch2
-<http://www.sai.msu.su/~megera/wiki/tsearch2slides>
-
-.BR
-FTS in PostgreSQL is provided by tsearch2, which should works without any
-indices (GiST or GIN) ! Indices provide performance, not functionality.
-
-.BR
-In your example I\'d do ( simple way, just for demo):
-
-.BR
-.B 0.
-compile, install tsearch2 and load tsearch2 into your database
-
-.BR
- cd contrib/tsearch2; make&&make&&install&&make installcheck; psql DB &lt;
- tsearch2.sql
-
-.BR
-.B 1.
-Add column fts, which holds tsvector
-
-.BR
- alter table documents add column fts tsvector;
-
-.BR
-.B 2.
-Fill fts column
-
-.BR
- update document set fts = to_tsvector(clean);
-
-.BR
-.B 3.
-create index \- just for performance !
-
-.BR
- create index fts_gin_idx on document using gin(fts);
-
-.BR
-.B 4.
-Run vacuum
-
-.BR
- vacuum analyze document;
-
-.BR
-That\'s all.
-
-.BR
-Now you can search:
-
-.BR
-select lid, metadata_tid, rank_cd(fts, q,2)as rank from document,
-plainto_tsquery(\'markup syntax\') q where q @@ fts order by rank desc limit
-10;
-
-.SH
-1.8 WHERE IS VERSION 1.0?
-
-.BR
-.B SiSU
-works pretty well as it is supposed to. Version 1.0 will have the current
-markup, and directory structure. At this point it is largely a matter of choice
-as to when the name change is made.
-
-.BR
-The feature set for html,[^1] LaTeX/pdf and opendocument is in place. XML, and
-plaintext are in order.
-
-.BR
-html and LaTeX/pdf may be regarded as reference copy outputs
-
-.BR
-With regard to the populating of sql databases (postgresql and sqlite), there
-is a bit to be done.
-
-.BR
-We are still almost there.
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- FAQ \- Frequently Asked/Answered Questions
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2006\-09\-06
-
-.BR
-DC Date available:
-.I 2006\-09\-06
-
-.BR
-DC Date issued:
-.I 2006\-09\-06
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_faq.sst
-
-.BR
-Filetype:
-.I SiSU text 0.57
-
-.BR
-Sourcefile Digest, MD5(sisu_faq.sst)=
-.I 41577c9fc063cd232914a1a11a59e91a
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:46 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-.TP
-.BI 1.
-html w3c compliance has been largely met.
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_faq/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_faq/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_faq/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_faq/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_faq/sisu_faq.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:51 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man8/sisu_howto.8 b/man/man8/sisu_howto.8
deleted file mode 100644
index 7717fd7d..00000000
--- a/man/man8/sisu_howto.8
+++ /dev/null
@@ -1,2301 +0,0 @@
-.TH "sisu_howto" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- TECHNICAL, HOWTO,
-RALPH AMISSAH
-.BR
-
-.SH
-SISU SOME TECHNICAL INFORMATION
-.BR
-
-.SH
-HOWTO
-.BR
-
-.SH
-1. GETTING HELP
-.BR
-
-.BR
-An online manual of sorts should be available at:
-
-.BR
-<http://www.jus.uio.no/sisu_manual/>
-
-.BR
-The manual pages provided with
-.B SiSU
-are also available online, and there is an interactive help, which is being
-superseded by the man page, and possibly some document which contains this
-component.
-
-.SH
-1.1 SISU \"MAN\" PAGES
-
-.BR
-If
-.B SiSU
-is installed on your system usual man commands should be available, try:
-
-.BR
-man sisu
-
-.BR
-The
-.B SiSU
-man pages can be viewed online at:[^1]
-
-.BR
-An online version of the sisu man page is available here:
-
-.BR
-* various sisu man pages <http://www.jus.uio.no/sisu/man/> \ [^2]
-
-.BR
-* sisu.1 <http://www.jus.uio.no/sisu/man/sisu.1.html> \ [^3]
-
-.BR
-* sisu.8 <http://www.jus.uio.no/sisu/man/sisu.8.html> \ [^4]
-
-.BR
-* sisu_examples.1 <http://www.jus.uio.no/sisu/man/sisu_examples.1.html> \ [^5]
-
-.BR
-* sisu_webrick.1 <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html> \ [^6]
-
-.SH
-1.2 SISU BUILT\-IN HELP
-
-.BR
- sisu \-\-help
-
-.BR
- sisu \-\-help \ [subject]
-
-.BR
- sisu \-\-help env \ [for \ feedback \ on \ the \ way \ your \ system \ is \
- setup \ with \ regard \ to \ sisu]
-
-.BR
- sisu \-V \ [same \ as \ above \ command]
-
-.BR
- sisu \-\-help commands
-
-.BR
- sisu \-\-help markup
-
-.SH
-1.3 COMMAND LINE WITH FLAGS \- BATCH PROCESSING
-
-.BR
-Running sisu (alone without any flags, filenames or wildcards) brings up the
-interactive help, as does any sisu command that is not recognised.
-
-.BR
-In the data directory run sisu \-mh filename or wildcard eg. \"sisu \-h
-cisg.sst\" or \"sisu \-h *.{sst,ssm}\" to produce html version of all
-documents.
-
-.SH
-2. SETUP, INITIALISATION
-.BR
-
-.SH
-2.1 INITIALISE OUTPUT DIRECTORY
-
-.BR
-Images, css files for a document directory are copied to their respective
-locations in the output directory.
-
-.BR
-while within your document markup/preparation directory, issue the following
-command
-
-.BR
- sisu \-CC
-
-.SH
-2.1.1 USE OF SEARCH FUNCTIONALITY, AN EXAMPLE USING SQLITE
-
-.BR
-.B SiSU
-can populate PostgreSQL and Sqlite databases and provides a sample search
-form for querying these databases.
-
-.BR
-This note provides an example to get you started and will use sqlite
-
-.BR
-It is necessary to:
-
-.BR
-(1) make sure the required dependencies have been installed
-
-.BR
-(2) have a directory with sisu markup samples that is writable
-
-.BR
-(3) use sisu to create a database
-
-.BR
-(4) use sisu tp populate a database
-
-.BR
-(5) use sisu to start the webrick (httpd) server
-
-.BR
-(6) use sisu to create a search form
-
-.BR
-(7) copy the search form to the cgi directory
-
-.BR
-(8) open up the form in your browser
-
-.BR
-(9) query the database using the search form
-
-.BR
-.B (1) make sure the required dependencies have been installed
-
-.BR
-if you use
-.B Debian
-, the following command will install the required dependencies
-
-.BR
-aptitude install sisu\-sqlite
-
-.BR
-.B (2) have a directory with sisu markup samples that is writable
-
-.BR
-ideally copy the sisu\-examples directory to your home directory (because the
-directory in which you run this example should be writable)
-
-.BR
-cp \-rv /usr/share/sisu\-examples/sample/document_samples_sisu_markup ~/.
-
-.BR
-.B (3) use sisu to create an sqlite database
-
-.BR
-within the sisu\-examples directory
-
-.BR
-sisu \-dv createall
-
-.BR
-.B (4) use sisu tp populate a database with some text
-
-.BR
-within the sisu\-examples directory
-
-.BR
-sisu \-div free_*.sst
-
-.BR
-or
-
-.BR
-sisu \-dv import free_*.sst debian_constitution_v1.2.sst
-debian_social_contract_v1.1.sst gpl2.fsf.sst
-
-.BR
-.B (5) use sisu to start the webrick (httpd) server (if it has not already
-been started):
-
-.BR
-sisu \-W
-
-.BR
-.B (6) use sisu to create a search form (for use with the webrick server, and
-your sample documents)
-
-.BR
-within the sisu\-examples directory
-
-.BR
-sisu \-F webrick
-
-.BR
-#here i run into a problem, you are working from a read only #directory..., not
-my usual mode of operation, to complete the example #the following is necessary
-sudo touch sisu_sqlite.cgi sisu_pgsql.cgi sudo \-P chown $USER sisu_sqlite.cgi
-sisu_pgsql.cgi
-
-.BR
-#now this should be possible: sisu \-F webrick
-
-.BR
-.B (7) copy the search form to the cgi directory
-
-.BR
-the string should be provided as output from the previous command
-
-.BR
-sudo cp \-vi
-/usr/share/sisu\-examples/sample/document_samples_sisu_markup/sisu_sqlite.cgi
-/usr/lib/cgi\-bin
-
-.BR
-sudo chmod \-v 755 /usr/lib/cgi\-bin/sisu_sqlite.cgi
-
-.BR
-.B (8) open up the form in your browser and query it
-
-.BR
-url:
-
-.BR
-<http://localhost:8081/cgi\-bin/sisu_sqlite.cgi>
-
-.BR
-or as instructed by command sisu \-F webrick
-
-.BR
-.B (9) query the database using the search form
-
-.BR
-if there are other options in the dropdown menu select
-
-.BR
-document_samples_sisu_markup
-
-.BR
-and search for some text, e.g.:
-
-.BR
-aim OR project
-
-.BR
-* selecting the
-.B index
-radio button gives an index of results using the object numbers
-
-.BR
-* selecting the
-.B text
-radio button gives the content of the matched paragraphs with the match
-highlighted
-
-.BR
-.B (10) to start again with a new database
-
-.BR
-to start from scratch you can drop the database with the command
-
-.BR
-sisu \-dv dropall
-
-.BR
-and go to step 3
-
-.BR
-to get to step 3 in one step with a single command
-
-.BR
-sisu \-dv recreate
-
-.BR
-continue subsequent steps
-
-.SH
-2.2 MISC
-
-.SH
-2.2.1 URL FOR OUTPUT FILES \-U \-U
-
-.BR
- sisu \-uv[and \ other \ flags] \ [filename/wildcard]
-
-.BR
- sisu \-Uv \ [filename/wildcard]
-
-.SH
-2.2.2 TOGGLE SCREEN COLOR
-
-.BR
- sisu \-cv[and \ processing \ flags] \ [filename/wildcard]
-
-.SH
-2.2.3 VERBOSE MODE
-
-.BR
- sisu \-v[and \ processing \ flags] \ [filename/wildcard]
-
-.BR
- sisu \-V[and \ processing \ flags] \ [filename/wildcard]
-
-.SH
-2.2.4 QUIET MODE
-
-.BR
- sisu \-q[and \ processing \ flags] \ [filename/wildcard]
-
-.SH
-2.2.5 MAINTENANCE MODE INTERMEDIATE FILES KEPT \-M
-
-.BR
- sisu \-Mv[and \ other \ flags] \ [filename/wildcard]
-
-.SH
-2.2.6 START THE WEBRICK SERVER
-
-.BR
- sisu \-W
-
-.SH
-2.3 REMOTE PLACEMENT OF OUTPUT
-
-.BR
-configuration is necessary
-
-.BR
-scp
-
-.BR
- sisu \-vr[and \ processing \ flags] \ [filename/wildcard]
-
-.BR
-rsync
-
-.BR
- sisu \-vR[and \ processing \ flags] \ [filename/wildcard]
-
-.SH
-3. CONFIGURATION FILES
-.BR
-
-.BR
-Sample provided, on untarring the source tarball:
-
-.BR
- conf/sisu/sisurc.yaml
-
-.BR
-and on installation under:
-
-.BR
- /etc/sisu/sisurc.yaml
-
-.BR
-The following paths are searched:
-
-.BR
- \./_sisu/sisurc.yaml
-
-.BR
- ~/.sisu/sisurc.yaml
-
-.BR
- \./etc/sisu/sisurc.yaml
-
-.SH
-4. MARKUP
-.BR
-
-.BR
-See sample markup provided on
-
-.BR
-<http://www.jus.uio.no/sisu>
-
-.BR
-<http://www.jus.uio.no/sisu_markup>
-
-.BR
-<http://www.jus.uio.no/sisu/SiSU>
-
-.BR
-in particular for each of the document output samples provided, the source
-document is provided as well
-
-.BR
-<http://www.jus.uio.no/sisu/SiSU/2#books>
-
-.BR
-on untarring the source tarball:
-
-.BR
- data/sisu\-examples/sample/document_samples_sisu_markup/
-
-.BR
-or the same once source is installed (or sisu\-examples) under:
-
-.BR
- /usr/share/sisu\-examples/sample/document_samples_sisu_markup/
-
-.BR
-Some notes are contained within the man page,
-.B man sisu
-and within sisu help via the commands
-.B sisu help markup
-and
-.B sisu help headers
-
-.BR
-.B SiSU
-is for literary and legal text, also for some social science material. In
-particular it does not do formula, and is not particularly suited to technical
-documentation. Despite the latter caveat, some notes will be provided here and
-added to over time:
-
-.SH
-4.1 HEADERS
-
-.BR
-Headers @headername: provide information related to the document, this may
-relate to
-
-.BR
-1. how it is to be processed, such as whether headings are to be numbered, what
-skin is to be used and markup instructions, such as the document structure, or
-words to be made bold within the document
-
-.BR
-2. semantic information about the document including the dublin core
-
-.SH
-4.2 FONT FACE
-
-.BR
-Defaults are set. You may change the face to: bold, italics, underscore,
-strikethrough, \...
-
-.SH
-4.2.1 BOLD
-
-.BR
-\@bold: \ [list \ of \ words \ that \ should \ be \ made \ bold \ within \
-document]
-
-.BR
-.B bold line
-
-.BR
-!_ bold line
-
-.BR
-.B bold word or sentence
-
-.BR
-!{ bold word or sentence }!
-
-.BR
-*{ bold word or sentence }*
-
-.BR
-.B boldword
-or
-.B boldword
-
-.BR
-*boldword* or !boldword!
-
-.SH
-4.2.2 ITALICS
-
-.BR
-\@italics: \ [list \ of \ words \ that \ should \ be \ italicised \ within \
-document]
-
-.BR
-.I italicise word or sentence
-
-.BR
-/{ italicise word or sentence }/
-
-.BR
-.I italicisedword
-
-.BR
-/italicisedword/
-
-.SH
-4.2.3 UNDERSCORE
-
-.BR
-.I underscore word or sentence
-
-.BR
-_{ underscore word or sentence }_
-
-.BR
-.I underscoreword
-
-.SH
-4.2.4 STRIKETHROUGH
-
-.BR
-<del> strikethrough word or sentence </del>
-
-.BR
-\-{ strikethrough word or sentence }\-
-
-.BR
-<del>strikeword</del>
-
-.BR
-\-strikeword\-
-
-.SH
-4.3 ENDNOTES
-
-.BR
-There are two forms of markup for endnotes, they cannot be mixed within the
-same document
-
-.BR
-here[^7]
-
-.BR
-1. preferred endnote markup
-
-.BR
-here~{ this is an endnote }~
-
-.BR
-2. alternative markup equivalent, kept because it is possible to search and
-replace to get markup in existing texts such as Project Gutenberg
-
-.BR
-here~^
-
-.BR
-^~ this is an endote
-
-.SH
-4.4 LINKS
-
-.BR
-SiSU <http://sisudoc.org>
-
-.BR
-{
-.B SiSU
-}http://sisudoc.org
-
-.BR
-sisu.png 120x39 <http://sisudoc.org>
-
-.BR
-{sisu.png }http://sisudoc.org
-
-.BR
-[ tux.png ]
-
-.BR
-{ tux.png 64x80 }image
-
-.BR
-SiSU <http://sisudoc.org> \ [^8]
-
-.BR
-{
-.B SiSU
-}http://sisudoc.org
-
-.BR
-is equivalent to:
-
-.BR
-{
-.B SiSU
-}http://sisudoc.org ~{ <http://sisudoc.org> }~
-
-.BR
-the same can be done with an image:
-
-.BR
-sisu.png 120x39 \"SiSU\" <http://sisudoc.org> \ [^10]
-
-.BR
-{ sisu.png \"
-.B SiSU
-\" }http://sisudoc.org
-
-.SH
-4.5 NUMBER TITLES
-
-.BR
-Set with the header @markup:
-
-.SH
-4.6 LINE OPERATIONS
-
-.BR
-Line Operations (marker placed at start of line)
-
-.BR
-!_ bold line
-
-.BR
-.B bold line
-
-.BR
-_1 indent paragraph one level
-
-.BR
- indent paragraph one level
-
-.BR
-_2 indent paragraph two steps
-
-.BR
- indent paragraph two steps
-
-.BR
-_* bullet paragraph
-
-.BR
-* bullet paragraph
-
-.BR
-# number paragraph (see headers for numbering document headings)
-
-.BR
-1. number paragraph (see headers for numbering document headings)
-
-.BR
-_# number paragraph level 2 (see headers for numbering document headings)
-
-.BR
- a. number paragraph level 2 (see headers for numbering document headings)
-
-.SH
-4.7 TABLES
-
-.BR
-Table markup sample
-
-
-table{~h c3; 26; 32; 32;
-.P
-
-
-This is a table, column1
-.P
-this would become row one of column two
-.P
-column three of row one is here
-.P
-
-
-column one row 2
-.P
-column two of row two
-.P
-column three of row two, and so on
-.P
-
-
-column one row three
-.P
-and so on
-.P
-here
-.P
-
-
-}table
-.P
-
-.BR
-Alternative form of table markup
-
-
-.nf
- {t\~h}
- |Mon|Tue|Wed|Thu|Fri|Sat|Sun
- 0 | * | * | * | * | * | * | *
- 1 | * | * | * | * | | |
- 2 | \- | * | * | * | * | * |
- 3 | \- | * | * | * | * | * | *
- 4 | \- | | | * | * | * |
- 5 | * | * | * | * | * | * | *
-.fi
-
-.SH
-4.8 GROUPED TEXT
-
-
-.nf
- 5.times { puts \'Ruby\' }
-.fi
-
-.BR
-code{
-
-
-.nf
- 5.times { puts \'Ruby\' }
-.fi
-
-.BR
-}code
-
-
-A Limerick
-.P
-
-
-There was a young lady from Clyde,
-.P
-who ate a green apple and died,
-.P
-but the apple fermented inside the lamented,
-.P
-and made cider inside her inside.
-.P
-
-
-poem{
-.P
-
-
-There was a young lady from Clyde,
-.P
-who ate a green apple and died,
-.P
-but the apple fermented inside the lamented,
-.P
-and made cider inside her inside.
-.P
-
-
-}\poem
-.P
-
-.SH
-4.9 COMPOSITE DOCUMENT
-
-.BR
-To import another document, the master document or importing document should be
-named filename.r3 (r for require)
-
-.BR
-&lt;&lt; { filename.sst }
-
-.BR
-&lt;&lt; { filename.ssi }
-
-.SH
-5. CHANGE APPEARANCE
-.BR
-
-.SH
-5.1 SKINS
-
-.BR
-\"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
-.B SiSU
-output.
-
-.BR
-There are a few examples provided, on untarring the source tarball:
-
-.BR
- conf/sisu/skin/doc/
-
-.BR
- data/sisu\-examples/sample/document_samples_sisu_markup/_sisu/skin/doc
-
-.BR
-and on installation under:
-
-.BR
- /etc/sisu/skin/doc/
-
-.BR
- /usr/share/sisu\-examples/sample/document_samples_sisu_markup/_sisu/skin/doc
-
-.BR
-The following paths are searched:
-
-.BR
- \./_sisu/skin
-
-.BR
- ~/.sisu/skin
-
-.BR
- /etc/sisu/skin
-
-.BR
-Skins under the searched paths in a per document directory, a per directory
-directory, or a site directory, named:
-
-.BR
-doc \ [may \ be \ specified \ individually \ in \ each \ document]
-
-.BR
-dir \ [used \ if \ identifier \ part \ of \ name \ matches \ markup \ directory
-\ name]
-
-.BR
-site
-
-.BR
-It is usual to place all skins in the document directory, with symbolic links
-as required from dir or site directories.
-
-.SH
-5.2 CSS
-
-.BR
-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:
-
-.BR
-_./_sisu/css
-
-.BR
-~/.sisu/css
-
-.BR
-and
-
-.BR
-/etc/sisu/css
-
-.BR
-The contents of the first directory found in the search path are copied to the
-corresponding sisu output directory with the commnd:
-
-.BR
-sisu \-CC
-
-.BR
-The
-.B SiSU
-standard css files for
-.B SiSU
-output are:
-
-.BR
-dom.css html.css html_tables.css index.css sax.css xhtml.css
-
-.BR
-A document may specify its own/bespoke css file using the css header.
-
-.BR
-\@css:
-
-.BR
-[expand]
-
-.SH
-EXTRACTS FROM THE README
-.BR
-
-.SH
-6. README
-.BR
-
-.BR
-.B SiSU
-0.55 2007w27/6 2007\-07\-07
-
-.BR
-Homepage: <http://www.jus.uio.no/sisu>
-
-.BR
-.B Description
-
-.BR
-.B SiSU
-is lightweight markup based document creation and publishing framework that
-is controlled from the command line. Prepare documents for
-.B SiSU
-using your text editor of choice, then use
-.B SiSU
-to generate various output document formats.
-
-.BR
-With minimal preparation of a plain\-text (UTF\-8) file using its native
-markup\-syntax,
-.B SiSU
-produces: plain\-text, HTML, XHTML, XML, ODF:ODT (Opendocument), LaTeX, PDF,
-and populates an SQL database (PostgreSQL or SQLite) in paragraph sized chunks
-so that document searches are done at this \"atomic\" level of granularity.
-
-.BR
-Outputs share a common citation numbering system, and any semantic meta\-data
-provided about the document.
-
-.BR
-.B SiSU
-also provides concordance files, document content certificates and manifests
-of generated output.
-
-.BR
-.B SiSU
-takes advantage of well established open standard ways of representing text,
-and provides a bridge to take advantage of the strengths of each, while
-remaining simple.
-.B SiSU
-implements across document formats a \"useful common feature set\" \ [coming
-\ from \ a \ humanities, \ law, \ and \ possibly \ social \ sciences \
-perspective, \ rather \ than \ technical \ or \ scientific \ writing] \...
-focus is primarily on content and data integrity rather than appearance,
-(though outputs in the various formats are respectable).
-
-.BR
-A vim syntax highlighting file and an ftplugin with folds for sisu markup is
-provided. Vim 7 includes syntax highlighting for
-.B SiSU
-.
-
-.BR
-man pages, and interactive help are provided.
-
-.BR
-Dependencies for various features are taken care of in sisu related packages.
-The package sisu\-complete installs the whole of
-.B SiSU
-.
-
-.BR
-Additional document markup samples are provided in the package
-sisu\-markup\-samples which is found in the non\-free archive the licenses for
-the substantive content of the marked up documents provided is that provided by
-the author or original publisher.
-
-.BR
-Homepage: <http://www.jus.uio.no/sisu>
-
-.BR
-.B SiSU
-\- simple information structuring universe, is a publishing tool, document
-generation and management, (and search enabling) tool primarily for literary,
-academic and legal published works.
-
-.BR
-.B SiSU
-can be used for Internet, Intranet, local filesystem or cd publishing.
-
-.BR
-.B SiSU
-can be used directly off the filesystem, or from a database.
-
-.BR
-.B SiSU
-\'s scalability, is be dependent on your hardware, and filesystem (in my case
-Reiserfs), and/or database Postgresql.
-
-.BR
-Amongst it\'s characteristics are:
-
-.BR
-* simple mnemonoic markup style,
-
-.BR
-* the ability to produce multiple output formats, including html, structured
-XML, LaTeX, pdf (via LaTeX), stream to a relational database whilst retaining
-document structure \- Postgresql and Sqlite,
-
-.BR
-* that all share a common citation system (a simple idea from which much good),
-possibly most exciting, the following: if fed into a relational database (as it
-can be automatically), the document set is searchable, with results displayed
-at a paragraph level, or the possibility of an indexed display of documents in
-which the match is found together with a hyperlinked listing for each of each
-paragraph in which the match is found. In any event citations using this system
-(with or without the relational database) are relevant for all output formats.
-
-.BR
-* it is command line driven, and can be set up on a remote server
-
-.BR
-* Documents are marked up in
-.B SiSU
-syntax in your favourite editor.
-.B SiSU
-syntax may be regarded as a type of smart ascii \- which in its basic form is
-simpler than the most elementary html. There is currently a syntax highlighter,
-and folding for Vim. Syntax highlighters for other editors are welcome.
-
-.BR
-Input files should be UTF\-8
-
-.BR
-Once set up it is simple to use.
-
-.SH
-6.1 ONLINE INFORMATION, PLACES TO LOOK
-
-.BR
-<http://www.jus.uio.no/sisu>
-
-.BR
-Download Sources:
-
-.BR
- <http://www.jus.uio.no/sisu/SiSU/download.html#current>
-
-.BR
- <http://www.jus.uio.no/sisu/SiSU/download.html#debian>
-
-.SH
-6.2 INSTALLATION
-
-.BR
-NB. Platform is Unix / Linux.
-
-.SH
-6.2.1 DEBIAN
-
-.BR
-If you use
-.B Debian
-use the
-.B Debian
-packages, check the information at:
-
-.BR
- <http://www.jus.uio.no/sisu/SiSU/download.html#debian>
-
-.BR
-(A)
-.B SiSU
-is available directly off the
-.B Debian
-archives for Sid and testing. It should necessary only to run as root:
-
-.BR
- aptitude update
-
-.BR
- aptitude install sisu\-complete
-
-.BR
-(B) If there are newer versions of
-.B SiSU
-upstream of the
-.B Debian
-archives, they will be available by adding the following to your
-/etc/apt/sources.list
-
-.BR
- deb <http://www.jus.uio.no/sisu/archive> unstable main non\-free
-
-.BR
- deb\-src <http://www.jus.uio.no/sisu/archive> unstable main non\-free
-
-.BR
-[the \ non\-free \ line \ is \ for \ document \ markup \ samples, \ for \ which
-\ the \ substantive \ text \ is \ provided \ under \ the \ author \ or \
-original \ publisher\'s \ license \ and \ which \ in \ most \ cases \ will \
-not \ be \ debian \ free \ software \ guideline \ compliant]
-
-.BR
-Then as root run:
-
-.BR
- aptitude update
-
-.BR
- aptitude install sisu\-complete
-
-.SH
-6.2.2 RPM
-
-.BR
-RPMs are provided though untested, they are prepared by running alien against
-the source package, and against the debs.
-
-.BR
-They may be downloaded from:
-
-.BR
- <http://www.jus.uio.no/sisu/SiSU/download.html#rpm>
-
-.SH
-6.2.3 SOURCE PACKAGE \.TGZ
-
-.BR
-Otherwise to install
-.B SiSU
-from source, check information at:
-
-.BR
- <http://www.jus.uio.no/sisu/SiSU/download.html#current>
-
-.BR
-alternative modes of installation from source are provided, setup.rb (by Minero
-Aoki), rake (by Jim Weirich) built install file, rant (by Stefan Lang) built
-install file,
-
-.BR
-.B Ruby
-is the essential dependency for the basic operation of
-.B SiSU
-
-.BR
-1. Download the latest source (information available) from:
-
-.BR
- <http://www.jus.uio.no/sisu/SiSU/download.html#current>
-
-.BR
-2. Unpack the source
-
-.BR
-Note however, that additional external package dependencies, such as texlive or
-postgresql should you desire to use it are not taken care of for you.
-
-.SH
-6.2.4 TO USE SETUP.RB
-
-.BR
-this is a three step process, in the root directory of the unpacked
-.B SiSU
-as root type:
-
-.BR
- ruby setup.rb config
-
-.BR
- ruby setup.rb setup
-
-.BR
-as root:
-
-.BR
- ruby setup.rb install
-
-.BR
-further information:
-
-.BR
- <http://i.loveruby.net/en/projects/setup/>
-
-.BR
- <http://i.loveruby.net/en/projects/setup/doc/usage.html>
-
-.SH
-6.2.5 TO USE INSTALL (PRAPARED WITH \"RAKE\")
-
-.BR
-Rake must be installed on your system:
-
-.BR
- <http://rake.rubyforge.org/>
-
-.BR
- <http://rubyforge.org/frs/?group_id=50>
-
-.BR
-in the root directory of the unpacked
-.B SiSU
-as root type:
-
-.BR
- rake
-
-.BR
-or
-
-.BR
- rake base
-
-.BR
-This makes use of Rake (by Jim Weirich) and the provided Rakefile
-
-.BR
-For a list of alternative actions you may type:
-
-.BR
- rake help
-
-.BR
- rake \-T
-
-.SH
-6.2.6 TO USE INSTALL (PRAPARED WITH \"RANT\")
-
-.BR
-(you may use the instructions above for rake substituting rant if rant is
-installed on your system, or you may use an independent installer created using
-rant as follows:)
-
-.BR
-in the root directory of the unpacked
-.B SiSU
-as root type:
-
-.BR
- ruby \./sisu\-install
-
-.BR
-or
-
-.BR
- ruby \./sisu\-install base
-
-.BR
-This makes use of Rant (by Stefan Lang) and the provided Rantfile. It has been
-configured to do post installation setup setup configuration and generation of
-first test file. Note however, that additional external package dependencies,
-such as tetex\-extra are not taken care of for you.
-
-.BR
-further information:
-
-.BR
- <http://make.rubyforge.org/>
-
-.BR
- <http://rubyforge.org/frs/?group_id=615>
-
-.BR
-For a list of alternative actions you may type:
-
-.BR
- ruby \./sisu\-install help
-
-.BR
- ruby \./sisu\-install \-T
-
-.SH
-6.3 DEPENDENCIES
-
-.BR
-Once installed see \'man 8 sisu\' for some information on additional programs
-that sisu makes use of, and that you may need or wish to install. (this will
-depend on such factors as whether you want to generate pdf, whether you will be
-using
-.B SiSU
-with or without a database, \...) \'man sisu_markup\-samples\' may also be of
-interest if the sisu\-markup\-samples package has also been installed.
-
-.BR
-The information in man 8 may not be most up to date, and it is possible that
-more useful information can be gleaned from the following notes taken from the
-.B Debian
-control file (end edited), gives an idea of additional packages that
-.B SiSU
-can make use of if available, (the use/requirement of some of which are
-interdependent for specific actions by
-.B SiSU
-).
-
-.BR
-The following is from the debian/control file of sisu\-0.58.2, which amongst
-other things provides the dependencies of sisu within
-.B Debian
-.
-
-
-.nf
- Package: sisu
- Architecture: all
- Depends: ruby (>= 1.8.2), libwebrick\-ruby, unzip, zip
- Conflicts: vim\-sisu, sisu\-vim, sisu\-remote
- Replaces: vim\-sisu, sisu\-vim
- Recommends: sisu\-pdf, sisu\-sqlite, sisu\-postgresql, librmagick\-ruby, trang,
- tidy, librexml\-ruby, openssl, rsync, openssh\-client | lsh\-client, keychain,
- hyperestraier, kdissert, vim\-addon\-manager
- Suggests: rcs | cvs, lv, texinfo, pinfo
- Package: sisu\-complete
- Depends: ruby (>= 1.8.4), sisu, sisu\-pdf, sisu\-postgresql, sisu\-sqlite
- Recommends: hyperestraier
- Package: sisu\-pdf
- Architecture: all
- Depends: sisu, texlive\-latex\-base, texlive\-fonts\-recommended,
- texlive\-latex\-recommended, texlive\-latex\-extra
- Suggests: evince, xpdf
- Package: sisu\-postgresql
- Depends: sisu, postgresql\-8.1, libdbi\-ruby, libdbm\-ruby, libdbd\-pg\-ruby
- Suggests: pgaccess, libdbd\-pgsql, postgresql\-contrib\-8.1
- Package: sisu\-sqlite
- Depends: sisu, sqlite, libdbi\-ruby, libdbm\-ruby, libdbd\-sqlite\-ruby
- Suggests: libdbd\-sqlite
- Package: sisu\-markup\-samples
- Depends: sisu
-.fi
-
-
-.nf
- Source: sisu
- Section: text
- Priority: optional
- Maintainer: Ralph Amissah <ralph@amissah.com>
- Build\-Depends: debhelper (>= 5)
- Standards\-Version: 3.7.2
- Package: sisu
- Architecture: all
- Depends: ruby (>= 1.8.2), ruby (<< 1.9), libwebrick\-ruby, unzip, zip
- Conflicts: vim\-sisu, sisu\-vim, sisu\-remote
- Replaces: vim\-sisu, sisu\-vim
- Recommends: sisu\-doc, sisu\-pdf, sisu\-sqlite, sisu\-postgresql, hyperestraier, keychain, librmagick\-ruby, librexml\-ruby, openssl, openssh\-client | lsh\-client, rsync, tidy, vim\-addon\-manager
- Suggests: kdissert, lv, rcs | cvs, pinfo, texinfo, trang
- Description: documents \- structuring, publishing in multiple formats and search
- SiSU is a lightweight markup based, command line oriented, document
- structuring, publishing and search framework for document collections.
- \.
- With minimal preparation of a plain\-text, (UTF\-8) file, using its native
- markup syntax in your text editor of choice, SiSU can generate various
- document formats (most of which share a common object numbering system for
- locating content), including plain text, HTML, XHTML, XML, OpenDocument text
- (ODF:ODT), LaTeX, PDF files, and populate an SQL database with objects
- (roughly paragraph\-sized chunks) so searches may be performed and matches
- returned with that degree of granularity: your search criteria is met by these
- documents and at these locations within each document. Object numbering is
- particularly suitable for \"published\" works (finalized texts as opposed to
- works that are frequently changed or updated) for which it provides a fixed
- means of reference of content. Document outputs also share semantic meta\-data
- provided.
- \.
- SiSU also provides concordance files, document content certificates and
- manifests of generated output.
- \.
- A vim syntax highlighting file and an ftplugin with folds for sisu markup is
- provided, as are syntax highlighting files for kate, kwrite, gedit and
- diakonos. Vim 7 includes syntax highlighting for SiSU.
- \.
- man pages, and interactive help are provided.
- \.
- Dependencies for various features are taken care of in sisu related packages.
- The package sisu\-complete installs the whole of SiSU.
- \.
- Additional document markup samples are provided in the package
- sisu\-markup\-samples which is found in the non\-free archive the licenses for
- the substantive content of the marked up documents provided is that provided
- by the author or original publisher.
- \.
- Homepage: <http://www.jus.uio.no/sisu>
-.fi
-
-
-.nf
- Package: sisu\-complete
- Architecture: all
- Depends: ruby (>= 1.8.2), ruby (<< 1.9), sisu, sisu\-doc, sisu\-pdf, sisu\-postgresql, sisu\-sqlite
- Recommends: hyperestraier
- Description: installs all SiSU related packages
- This package installs SiSU and related packages that enable sisu to produce
- pdf and to populate postgresql and sqlite databases.
- \.
- SiSU is a lightweight markup based document structuring, publishing and search
- framework for document collections.
- \.
- See sisu for a description of the package.
- \.
- Homepage: <http://www.jus.uio.no/sisu>
-.fi
-
-
-.nf
- Package: sisu\-doc
- Architecture: all
- Depends: sisu
- Recommends: sisu\-pdf, sisu\-postgresql, sisu\-sqlite
- Description: sisu manual and other documentation for sisu
- Multiple file formats generated output of sisu documentation generated from
- sisu markup source documents included in the main package
- \.
- SiSU is a lightweight markup based document structuring, publishing and search
- framework for document collections.
- \.
- Homepage: <http://www.jus.uio.no/sisu>
-.fi
-
-
-.nf
- Package: sisu\-pdf
- Architecture: all
- Depends: sisu, texlive\-latex\-base, texlive\-fonts\-recommended, texlive\-latex\-recommended, texlive\-latex\-extra
- Recommends: sisu\-doc
- Description: dependencies to convert SiSU LaTeX output to pdf
- This package enables the conversion of SiSU LaTeX output to pdf.
- \.
- SiSU is a lightweight markup based document structuring, publishing and search
- framework for document collections.
- \.
- Homepage: <http://www.jus.uio.no/sisu>
-.fi
-
-
-.nf
- Package: sisu\-postgresql
- Architecture: all
- Depends: sisu, libdbd\-pg\-ruby, libdbi\-ruby, libdbm\-ruby, postgresql
- Recommends: sisu\-doc, libfcgi\-ruby
- Suggests: postgresql\-contrib
- Description: SiSU dependencies for use with postgresql database
- This package enables SiSU to populate a postgresql database. This is done at
- an object/paragraph level, making granular searches of documents possible.
- \.
- This relational database feature of SiSU is not required but provides
- interesting possibilities, including that of granular searches of documents
- for matching units of text, primarily paragraphs that can be displayed or
- identified by object citation number, from which an index of documents
- matched and each matched paragraph within them can be displayed.
- \.
- SiSU is a lightweight markup based document structuring, publishing and search
- framework for document collections.
- \.
- Homepage: <http://www.jus.uio.no/sisu>
-.fi
-
-
-.nf
- Package: sisu\-sqlite
- Architecture: all
- Depends: sisu, sqlite, libdbd\-sqlite\-ruby, libdbi\-ruby, libdbm\-ruby
- Recommends: sisu\-doc, libfcgi\-ruby
- Description: SiSU dependencies for use with sqlite database
- This package enables SiSU to populate an sqlite database. This is done at an
- object/paragraph level, making granular searches of documents possible.
- \.
- This relational database feature of SiSU is not required but provides
- interesting possibilities, including that of granular searches of documents
- for matching units of text, primarily paragraphs that can be displayed or
- identified by object citation number, from which an index of documents
- matched and each matched paragraph within them can be displayed.
- \.
- SiSU is a lightweight markup based document structuring, publishing and search
- framework for document collections.
- \.
- Homepage: <http://www.jus.uio.no/sisu>
-.fi
-
-.SH
-6.4 QUICK START
-
-.BR
-Most of the installation should be taken care of by the aptitude or rant
-install. (The rant install if run in full will also test run the generation of
-the first document).
-
-.BR
-After installation of sisu\-complete, move to the document samples directory
-
-.BR
- cd /usr/share/doc/sisu/sisu_markup_samples/dfsg
-
-.BR
-and run
-
-.BR
- sisu \-3 free_as_in_freedom.rms_and_free_software.sam_williams.sst
-
-.BR
-or the same:
-
-.BR
- sisu \-NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst
-
-.BR
-look at output results, see the \"sisu_manifest\" page created for the document
-
-.BR
-or to generate an online document move to a writable directory, as the file
-will be downloaded there and e.g.
-
-.BR
-sisu \-3
-<http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst>
-
-.BR
-the database stuff is extra perhaps, the latex stuff could be considered extra
-perhaps but neither needs to be installed for most of sisu output to work
-
-.BR
-examine source document, vim has syntax support
-
-.BR
-gvim free_as_in_freedom.rms_and_free_software.sam_williams.sst
-
-.BR
-additional markup samples in
-
-.BR
- <http://www.jus.uio.no/sisu/SiSU/2.html>
-
-.BR
-For help
-
-.BR
- man sisu
-
-.BR
-or
-
-.BR
- sisu \-\-help
-
-.BR
-e.g.
-
-.BR
-for the way sisu \"sees/maps\" your system
-
-.BR
- sisu \-\-help env
-
-.BR
-for list of commands and so on
-
-.BR
- sisu \-\-help commands
-
-.SH
-6.5 CONFIGURATION FILES
-
-.BR
-The default configuration/setup is contained within the program and is altered
-by configuration settings in
-.I etc
-[sisu \ version]/sisurc.yml or in ~/.sisu/sisurc.yml
-
-.BR
-* configuration file \- a yaml file
-
-.BR
- /etc/sisu/[sisu \ version]/sisurc.yml
-
-.BR
- ~/.sisu/sisurc.yml
-
-.BR
-* directory structure \- setting up of output and working directory.
-
-.BR
-* skins \- changing the appearance of a project, directory or individual
-documents within ~/.sisu/skin
-
-.BR
- ~/.sisu/skin/doc contains individual skins, with symbolic links from
-
-.BR
- ~/.sisu/skin/dir if the contents of a directory are to take a particular
- document skin.
-
-.BR
-* additional software \- eg. Tex and LaTeX (tetex, tetex\-base, tetex\-extra on
-.B Debian
-), Postgresql, \ [sqlite], trang, tidy, makeinfo, \... none of which are
-required for basic html or XML processing.
-
-.BR
-* if you use Vim as editor there is a syntax highlighter and fold resource
-config file for
-.B SiSU
-. I hope more syntax highlighters follow.
-
-.BR
-There are post installation steps (which are really part of the overall
-installation)
-
-.BR
-sisu \-C in your marked up document directory, should do some auto\-configuring
-provided you have the right permissions for the output directories. (and
-provided the output directories have already been specified if you are not
-using the defaults).
-
-.SH
-6.6 USE GENERAL OVERVIEW
-
-.BR
-Documents are marked up in
-.B SiSU
-syntax and kept in an ordinary text editable file, named with the suffix
-\.sst, or \.ssm
-
-.BR
-Marked up
-.B SiSU
-documents are usually kept in a sub\-directory of your choosing
-
-.BR
-use the interactive help and man pages
-
-.BR
- sisu \-\-help
-
-.BR
- man sisu
-
-.SH
-6.7 HELP
-
-.BR
-interactive help described below, or man page:
-
-.BR
- man sisu
-
-.BR
- man 8 sisu
-
-.BR
-\'man sisu_markup\-samples\' \ [if \ the \ sisu\-markup\-samples \ package \ is
-\ also \ installed]
-
-.BR
-Once installed an interactive help is available typing \'sisu\' (without) any
-flags, and select an option:
-
-.BR
- sisu
-
-.BR
-alternatively, you could type e.g.
-
-.BR
- sisu \-\-help commands
-
-.BR
- sisu \-\-help env
-
-.BR
- sisu \-\-help headers
-
-.BR
- sisu \-\-help markup
-
-.BR
- sisu \-\-help headings
-
-.BR
-etc.
-
-.BR
-for questions about mappings, output paths etc.
-
-.BR
- sisu \-\-help env
-
-.BR
- sisu \-\-help path
-
-.BR
- sisu \-\-help directory
-
-.SH
-6.8 DIRECTORY STRUCTURE
-
-.BR
-Once installed, type:
-
-.BR
- sisu \-\-help env
-
-.BR
-or
-
-.BR
- sisu \-V
-
-.SH
-6.9 CONFIGURATION FILE
-
-.BR
-The defaults can be changed via
-.B SiSU
-\'s configure file sisurc.yml which the program expects to find in \./_sisu
-~/.sisu or /etc/sisu (searched in that order, stopping on the first one found)
-
-.SH
-6.10 MARKUP
-
-.BR
-See man pages.
-
-.BR
- man sisu
-
-.BR
- man 8 sisu
-
-.BR
-Once installed there is some information on
-.B SiSU
-Markup in its help:
-
-.BR
- sisu \-\-help markup
-
-.BR
-and
-
-.BR
- sisu \-\-help headers
-
-.BR
-Sample marked up document are provided with the download tarball in the
-directory:
-
-.BR
- \./data/doc/sisu/sisu_markup_samples/dfsg
-
-.BR
-These are installed on the system usually at:
-
-.BR
- /usr/share/doc/sisu/sisu_markup_samples/dfsg
-
-.BR
-More markup samples are available in the package sisu\-markup\-samples
-
-.BR
- <http://www.jus.uio.no/sisu/SiSU/download.html#sisu\-markup\-samples>
-
-.BR
-Many more are available online off:
-
-.BR
- <http://www.jus.uio.no/sisu/SiSU/2.html>
-
-.SH
-6.11 ADDITIONAL THINGS
-
-.BR
-There is syntax support for some editors provided (together with a README file)
-in
-
-.BR
- \./data/sisu/conf/syntax
-
-.BR
-usually installed to:
-
-.BR
- /usr/share/sisu/conf/syntax
-
-.SH
-6.12 LICENSE
-
-.BR
-License: GPL 3 or later see the copyright file in
-
-.BR
- \./data/doc/sisu
-
-.BR
-usually installed to:
-
-.BR
- /usr/share/doc/sisu
-
-.SH
-6.13 SISU STANDARD
-
-.BR
-.B SiSU
-uses:
-
-.BR
-* Standard
-.B SiSU
-markup syntax,
-
-.BR
-* Standard
-.B SiSU
-meta\-markup syntax, and the
-
-.BR
-* Standard
-.B SiSU
-object citation numbering and system
-
-.BR
-© Ralph Amissah 1997, current 2006 All Rights Reserved.
-
-.BR
-* however note the License section
-
-.BR
-CHANGELOG
-
-.BR
- \./CHANGELOG
-
-.BR
-and see
-
-.BR
- <http://www.jus.uio.no/sisu/SiSU/changelog.html>
-
-.BR
- <http://www.jus.uio.no/sisu/SiSU/changelog_markup_samples.html>
-
-.SH
-EXTRACTS FROM MAN 8 SISU
-.BR
-
-.SH
-7. POST INSTALLATION SETUP
-.BR
-
-.SH
-7.1 POST INSTALLATION SETUP \- QUICK START
-
-.BR
-After installation of sisu\-complete, move to the document samples directory,
-
-.BR
- cd /usr/share/doc/sisu/sisu_markup_samples/dfsg
-
-.BR
-[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]
-
-.BR
-and in that directory, initialise the output directory with the command
-
-.BR
- sisu \-CC
-
-.BR
-then run:
-
-.BR
- sisu \-1 free_as_in_freedom.rms_and_free_software.sam_williams.sst
-
-.BR
-or the same:
-
-.BR
- sisu \-NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst
-
-.BR
-look at output results, see the \"sisu_manifest\" page created for the document
-
-.BR
-for an overview of your current sisu setup, type:
-
-.BR
- sisu \-\-help env
-
-.BR
-or
-
-.BR
- sisu \-V
-
-.BR
-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.
-
-.BR
- sisu \-1 <http://www.jus.uio.no/sisu/gpl3.fsf/gpl3.fsf.sst>
-
-.BR
- sisu \-3
- <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst>
-
-.BR
-examine source document, vim has syntax highlighting support
-
-.BR
-gvim free_as_in_freedom.rms_and_free_software.sam_williams.sst
-
-.BR
-additional markup samples in
-
-.BR
- <http://www.jus.uio.no/sisu/SiSU/2.html>
-
-.BR
-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.
-
-.BR
- sisu \-3
- <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip>
-
-.BR
-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:
-
-.BR
- sisu \-3 \-\-trust
- <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip>
-
-.BR
-For help
-
-.BR
- man sisu
-
-.BR
- sisu \-\-help
-
-.BR
- sisu \-\-help env for the way sisu \"sees/maps\" your system
-
-.BR
- sisu \-\-help commands for list of commands and so on
-
-.SH
-7.2 DOCUMENT MARKUP DIRECTORY
-
-.BR
-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:
-
-.BR
- mkdir ~/sisu_test
-
-.BR
- cd ~/sisu_test
-
-.BR
- cp \-a /usr/share/doc/sisu/sisu_markup_samples/dfsg/* ~/sisu_test/.
-
-.BR
-.B Tip:
-the markup syntax examples may be of interest
-
-.BR
- <http://www.jus.uio.no/sisu/sample/>
-
-.BR
-.B Tip:
-
-.BR
- sisu \-U \ [sisu \ markup \ filename]
-
-.BR
-should printout the different possible outputs and where sisu would place them.
-
-.BR
-.B Tip:
-if you want to toggle ansi color add
-
-.BR
- c
-
-.BR
-to your flags.
-
-.SH
-7.2.1 CONFIGURATION FILES
-
-.BR
-.B SiSU
-configuration file search path is:
-
-.BR
- \./_sisu/sisurc.yaml
-
-.BR
- ~/.sisu/sisurc.yaml
-
-.BR
- /etc/sisu/sisurc.yaml
-
-.BR
-.\\"%%
-.B Debian
-Installation Note
-
-.SH
-7.2.2 DEBIAN INSTALLATION NOTE
-
-.BR
-It is best you see
-
-.BR
- <http://www.jus.uio.no/sisu/SiSU/download.html#debian>
-
-.BR
-for up the most up to date information.
-
-.BR
-notes taken from the
-.B Debian
-control file (end edited), gives an idea of additional packages that
-.B SiSU
-can make use of if available, (the use/requirement of some of which are
-interdependent for specific actions by
-.B SiSU
-):
-
-.BR
-Package: sisu
-
-.BR
-.B SiSU
-is a lightweight markup based, command line oriented, document structuring,
-publishing and search framework for document collections.
-
-.BR
-With minimal preparation of a plain\-text, (UTF\-8) file, using its native
-markup syntax in your text editor of choice,
-.B SiSU
-can generate various document formats (most of which share a common object
-numbering system for locating content), including plain text, HTML, XHTML, XML,
-OpenDocument text (ODF:ODT), LaTeX, PDF files, and populate an SQL database
-with objects (roughly paragraph\-sized chunks) so searches may be performed and
-matches returned with that degree of granularity: your search criteria is met
-by these documents and at these locations within each document. Object
-numbering is particularly suitable for \"published\" works (finalized texts as
-opposed to works that are frequently changed or updated) for which it provides
-a fixed means of reference of content. Document outputs also share semantic
-meta\-data provided.
-
-.BR
-.B SiSU
-also provides concordance files, document content certificates and manifests
-of generated output.
-
-.BR
-A vim syntax highlighting file and an ftplugin with folds for sisu markup is
-provided, as are syntax highlighting files for kate, kwrite, gedit and
-diakonos. Vim 7 includes syntax highlighting for
-.B SiSU
-.
-
-.BR
-man pages, and interactive help are provided.
-
-.BR
-Dependencies for various features are taken care of in sisu related packages.
-The package sisu\-complete installs the whole of
-.B SiSU
-.
-
-.BR
-Additional document markup samples are provided in the package
-sisu\-markup\-samples which is found in the non\-free archive the licenses for
-the substantive content of the marked up documents provided is that provided by
-the author or original publisher.
-
-.BR
-Homepage: <http://www.jus.uio.no/sisu>
-
-.SH
-7.2.3 DOCUMENT RESOURCE CONFIGURATION
-
-.BR
-.B sisu
-resource configuration information is obtained from sources (where they
-exist):
-
-.BR
- ~/.sisu/sisurc.yaml
-
-.BR
- /etc/sisu/[sisu \ version]/sisurc.yaml
-
-.BR
- sisu program defaults
-
-.SH
-7.2.4 SKINS
-
-.BR
-.B Skins
-default document appearance may be modified using skins contained in
-sub\-directories located at the following paths:
-
-.BR
- \./_sisu/skin
-
-.BR
- ~/.sisu/skin
-
-.BR
- /etc/sisu/skin
-
-.BR
-more specifically, the following locations (or their /etc/sisu equivalent)
-should be used:
-
-.BR
- ~/.sisu/skin/doc
-
-.BR
-skins for individual documents;
-
-.BR
- ~/.sisu/skin/dir
-
-.BR
-skins for directories of matching names;
-
-.BR
- ~/.sisu/skin/site
-
-.BR
-site\-wide skin modifying the site\-wide appearance of documents.
-
-.BR
-Usually all skin files are placed in the document skin directory:
-
-.BR
- ~/.sisu/skin/doc
-
-.BR
-with softlinks being made to the skins contained there from other skin
-directories as required.
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Technical, Howto
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-11\-12
-
-.BR
-DC Date issued:
-.I 2002\-11\-12
-
-.BR
-DC Date available:
-.I 2002\-11\-12
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_howto.sst
-
-.BR
-Filetype:
-.I SiSU text insert 0.57
-
-.BR
-Sourcefile Digest, MD5(sisu_howto.sst)=
-.I c0491e0093434f4d962ce3b59e4985ca
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:45 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-.TP
-.BI 1.
-generated from source using rman
- <http://polyglotman.sourceforge.net/rman.html>
- With regard to
-.B SiSU
-man pages the formatting generated for markup syntax is not quite right, for
-that you might prefer the links under:
- <http://www.jus.uio.no/sample>
-.TP
-.BI 2.
-<http://www.jus.uio.no/sisu/man/>
-.TP
-.BI 3.
-<http://www.jus.uio.no/sisu/man/sisu.1.html>
-.TP
-.BI 4.
-<http://www.jus.uio.no/sisu/man/sisu.8.html>
-.TP
-.BI 5.
-<http://www.jus.uio.no/sisu/man/sisu_examples.1.html>
-.TP
-.BI 6.
-<http://www.jus.uio.no/sisu/man/sisu_webrick.1.html>
-.TP
-.BI 7.
-this is an endnote
-.TP
-.BI 8.
-<http://sisudoc.org>
-.TP
-.BI 10.
-<http://sisudoc.org>
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_howto/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_howto/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_howto/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_howto/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_howto/sisu_howto.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:51 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man8/sisu_quickstart.8 b/man/man8/sisu_quickstart.8
deleted file mode 100644
index 5d03d4fc..00000000
--- a/man/man8/sisu_quickstart.8
+++ /dev/null
@@ -1,513 +0,0 @@
-.TH "sisu_quickstart" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- QUICKSTART, INSTALLATION AND USE,
-RALPH AMISSAH
-.BR
-
-.SH
-QUICKSTART \- SISU INSTALLATION AND USE
-.BR
-
-.SH
-1. QUICKSTART \- GETTING STARTED HOWTO
-.BR
-
-.SH
-1.1 INSTALLATION
-
-.BR
-Installation is currently most straightforward and tested on the
-.B Debian
-platform, as there are packages for the installation of sisu and all
-requirements for what it does.
-
-.SH
-1.1.1 DEBIAN INSTALLATION
-
-.BR
-.B SiSU
-is available directly from the
-.B Debian
-Sid and testing archives (and possibly Ubuntu), assuming your
-/etc/apt/sources.list is set accordingly:
-
-
-.nf
- aptitude update
- aptitude install sisu\-complete
-.fi
-
-.BR
-The following /etc/apt/sources.list setting permits the download of additional
-markup samples:
-
-
-.nf
- #/etc/apt/sources.list
- deb http://ftp.fi.debian.org/debian/ unstable main non\-free contrib
- deb\-src http://ftp.fi.debian.org/debian/ unstable main non\-free contrib
- d
-.fi
-
-.BR
-The aptitude commands become:
-
-
-.nf
- aptitude update
- aptitude install sisu\-complete sisu\-markup\-samples
-.fi
-
-.BR
-If there are newer versions of
-.B SiSU
-upstream of the
-.B Debian
-archives, they will be available by adding the following to your
-/etc/apt/sources.list
-
-
-.nf
- #/etc/apt/sources.list
- deb http://www.jus.uio.no/sisu/archive unstable main non\-free
- deb\-src http://www.jus.uio.no/sisu/archive unstable main non\-free
-.fi
-
-.BR
-repeat the aptitude commands
-
-
-.nf
- aptitude update
- aptitude install sisu\-complete sisu\-markup\-samples
-.fi
-
-.BR
-Note however that it is not necessary to install sisu\-complete if not all
-components of sisu are to be used. Installing just the package sisu will
-provide basic functionality.
-
-.SH
-1.1.2 RPM INSTALLATION
-
-.BR
-RPMs are provided though untested, they are prepared by running alien against
-the source package, and against the debs.
-
-.BR
-They may be downloaded from:
-
-.BR
- <http://www.jus.uio.no/sisu/SiSU/download.html#rpm>
-
-.BR
-as root type:
-
-.BR
- rpm \-i \ [rpm \ package \ name]
-
-.SH
-1.1.3 INSTALLATION FROM SOURCE
-
-.BR
-To install
-.B SiSU
-from source check information at:
-
-.BR
- <http://www.jus.uio.no/sisu/SiSU/download.html#current>
-
-.BR
-* download the source package
-
-.BR
-* Unpack the source
-
-.BR
-Two alternative modes of installation from source are provided, setup.rb (by
-Minero Aoki) and a rant(by Stefan Lang) built install file, in either case: the
-first steps are the same, download and unpack the source file:
-
-.BR
-For basic use
-.B SiSU
-is only dependent on the programming language in which it is written
-.B Ruby
-, and
-.B SiSU
-will be able to generate html, various XMLs, including ODF (and will also
-produce LaTeX). Dependencies required for further actions, though it relies on
-the installation of additional dependencies which the source tarball does not
-take care of, for things like using a database (postgresql or sqlite)[^1] or
-converting LaTeX to pdf.
-
-.BR
-.B setup.rb
-
-.BR
-This is a standard ruby installer, using setup.rb is a three step process. In
-the root directory of the unpacked
-.B SiSU
-as root type:
-
-
-.nf
- ruby setup.rb config
- ruby setup.rb setup
- #[and \ as \ root:]
- ruby setup.rb install
-.fi
-
-.BR
-further information on setup.rb is available from:
-
-.BR
- <http://i.loveruby.net/en/projects/setup/>
-
-.BR
- <http://i.loveruby.net/en/projects/setup/doc/usage.html>
-
-.BR
-.B \"install\"
-
-.BR
-The \"install\" file provided is an installer prepared using \"rant\". In the
-root directory of the unpacked
-.B SiSU
-as root type:
-
-.BR
- ruby install base
-
-.BR
-or for a more complete installation:
-
-.BR
- ruby install
-
-.BR
-or
-
-.BR
- ruby install base
-
-.BR
-This makes use of Rant (by Stefan Lang) and the provided Rantfile. It has been
-configured to do post installation setup setup configuration and generation of
-first test file. Note however, that additional external package dependencies,
-such as tetex\-extra are not taken care of for you.
-
-.BR
-Further information on \"rant\" is available from:
-
-.BR
- <http://make.rubyforge.org/>
-
-.BR
- <http://rubyforge.org/frs/?group_id=615>
-
-.BR
-For a list of alternative actions you may type:
-
-.BR
- ruby install help
-
-.BR
- ruby install \-T
-
-.SH
-1.2 TESTING SISU, GENERATING OUTPUT
-
-.BR
-To check which version of sisu is installed:
-
-.BR
-sisu \-v
-
-.BR
-Depending on your mode of installation one or a number of markup sample files
-may be found either in the directory:
-
-.BR
-...
-
-.BR
-or
-
-.BR
-...
-
-.BR
-change directory to the appropriate one:
-
-.BR
-cd /usr/share/doc/sisu/sisu_markup_samples/dfsg
-
-.SH
-1.2.1 BASIC TEXT, PLAINTEXT, HTML, XML, ODF
-
-.BR
-Having moved to the directory that contains the markup samples (see
-instructions above if necessary), choose a file and run sisu against it
-
-.BR
-sisu \-NhwoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst
-
-.BR
-this will generate html including a concordance file, opendocument text format,
-plaintext, XHTML and various forms of XML, and OpenDocument text
-
-.SH
-1.2.2 LATEX / PDF
-
-.BR
-Assuming a LaTeX engine such as tetex or texlive is installed with the required
-modules (done automatically on selection of sisu\-pdf in
-.B Debian
-)
-
-.BR
-Having moved to the directory that contains the markup samples (see
-instructions above if necessary), choose a file and run sisu against it
-
-.BR
-sisu \-pv free_as_in_freedom.rms_and_free_software.sam_williams.sst
-
-.BR
-sisu \-3 free_as_in_freedom.rms_and_free_software.sam_williams.sst
-
-.BR
-should generate most available output formats: html including a concordance
-file, opendocument text format, plaintext, XHTML and various forms of XML, and
-OpenDocument text and pdf
-
-.SH
-1.2.3 RELATIONAL DATABASE \- POSTGRESQL, SQLITE
-
-.BR
-Relational databases need some setting up \- you must have permission to create
-the database and write to it when you run sisu.
-
-.BR
-Assuming you have the database installed and the requisite permissions
-
-.BR
-sisu \-\-sqlite \-\-recreate
-
-.BR
-sisu \-\-sqlite \-v \-\-import
-free_as_in_freedom.rms_and_free_software.sam_williams.sst
-
-.BR
-sisu \-\-pgsql \-\-recreate
-
-.BR
-sisu \-\-pgsql \-v \-\-import
-free_as_in_freedom.rms_and_free_software.sam_williams.sst
-
-.SH
-1.3 GETTING HELP
-
-.SH
-1.3.1 THE MAN PAGES
-
-.BR
-Type:
-
-.BR
- man sisu
-
-.BR
-The man pages are also available online, though not always kept as up to date
-as within the package itself:
-
-.BR
-* sisu.1 <http://www.jus.uio.no/sisu/man/sisu.1> \ [^2]
-
-.BR
-* sisu.8 <http://www.jus.uio.no/sisu/man/sisu.8> \ [^3]
-
-.BR
-* man directory <http://www.jus.uio.no/sisu/man> \ [^4]
-
-.SH
-1.3.2 BUILT IN HELP
-
-.BR
-sisu \-\-help
-
-.BR
-sisu \-\-help \-\-env
-
-.BR
-sisu \-\-help \-\-commands
-
-.BR
-sisu \-\-help \-\-markup
-
-.SH
-1.3.3 THE HOME PAGE
-
-.BR
-<http://www.jus.uio.no/sisu>
-
-.BR
-<http://www.jus.uio.no/sisu/SiSU>
-
-.SH
-1.4 MARKUP SAMPLES
-
-.BR
-A number of markup samples (along with output) are available off:
-
-.BR
-<http://www.jus.uio.no/sisu/SiSU/2.html>
-
-.BR
-Additional markup samples are packaged separately in the file:
-
-.BR
-.B *
-
-.BR
-On
-.B Debian
-they are available in non\-free[^5] to include them it is necessary to
-include non\-free in your /etc/apt/source.list or obtain them from the sisu
-home site.
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Quickstart, installation and use
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2006\-09\-06
-
-.BR
-DC Date available:
-.I 2006\-09\-06
-
-.BR
-DC Date issued:
-.I 2006\-09\-06
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_quickstart.sst
-
-.BR
-Filetype:
-.I SiSU text 0.57
-
-.BR
-Sourcefile Digest, MD5(sisu_quickstart.sst)=
-.I e76db98ca0d8c2bfe526dad55622fa7a
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:45 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-.TP
-.BI 1.
-There is nothing to stop MySQL support being added in future.
-.TP
-.BI 2.
-<http://www.jus.uio.no/sisu/man/sisu.1>
-.TP
-.BI 3.
-<http://www.jus.uio.no/sisu/man/sisu.8>
-.TP
-.BI 4.
-<http://www.jus.uio.no/sisu/man>
-.TP
-.BI 5.
-the \.B Debian
-Free Software guidelines require that everything distributed within \.B Debian
-can be changed - and the documents are authors\' works that while freely
-distributable are not freely changeable.
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_quickstart/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_quickstart/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_quickstart/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_quickstart/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_quickstart/sisu_quickstart.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:51 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man8/sisu_remote.8 b/man/man8/sisu_remote.8
deleted file mode 100644
index 41d836e1..00000000
--- a/man/man8/sisu_remote.8
+++ /dev/null
@@ -1,251 +0,0 @@
-.TH "sisu_remote" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- REMOTE OPERATIONS,
-RALPH AMISSAH
-.BR
-
-.SH
-SISU REMOTE OPERATIONS
-.BR
-
-.SH
-1. REMOTE SOURCE DOCUMENTS
-.BR
-
-.BR
-.B SiSU
-processing instructions can be run against remote source documents by
-providing the url of the documents against which the processing instructions
-are to be carried out. The remote
-.B SiSU
-documents can either be sisu marked up files in plaintext \.sst or \.ssm or;
-zipped sisu files, sisupod.zip or filename.ssp
-
-.BR
-.B \.sst / \.ssm \- sisu text files
-
-.BR
-.B SiSU
-can be run against source text files on a remote machine, provide the
-processing instruction and the url. The source file and any associated parts
-(such as images) will be downloaded and generated locally.
-
-
-.nf
- sisu \-3 http://[provide \ url \ to \ valid \ \.sst \ or \ \.ssm \ file]
-.fi
-
-.BR
-Any of the source documents in the sisu examples page can be used in this way,
-see <http://www.jus.uio.no/sisu/SiSU/2.html> and use the url for the desired
-document.
-
-.BR
-NOTE: to set up a remote machine to serve
-.B SiSU
-documents in this way, images should be in the directory relative to the
-document source \../_sisu/image
-
-.BR
-.B sisupod \- zipped sisu files
-
-.BR
-A sisupod is the zipped content of a sisu marked up text or texts and any other
-associated parts to the document such as images.
-
-.BR
-.B SiSU
-can be run against a sisupod on a (local or) remote machine, provide the
-processing instruction and the url, the sisupod will be downloaded and the
-documents it contains generated locally.
-
-
-.nf
- sisu \-3 http://[provide \ url \ to \ valid \ sisupod.zip \ or \ \.ssp \ file]
-.fi
-
-.BR
-Any of the source documents in the sisu examples page can be used in this way,
-see <http://www.jus.uio.no/sisu/SiSU/2.html> and use the url for the desired
-document.
-
-.SH
-REMOTE DOCUMENT OUTPUT
-.BR
-
-.SH
-2. REMOTE OUTPUT
-.BR
-
-.BR
-Once properly configured
-.B SiSU
-output can be automatically posted once generated to a designated remote
-machine using either rsync, or scp.
-
-.BR
-In order to do this some ssh authentication agent and keychain or similar tool
-will need to be configured. Once that is done the placement on a remote host
-can be done seamlessly with the \-r (for scp) or \-R (for rsync) flag, which
-may be used in conjunction with other processing flags, e.g.
-
-
-.nf
- sisu \-3R sisu_remote.sst
-.fi
-
-.SH
-2.1 COMMANDS
-
-.TP
-.B \ \-R \ \ [filename/wildcard]
-copies sisu output files to remote host using rsync. This requires that
-sisurc.yml has been provided with information on hostname and username, and
-that you have your \"keys\" and ssh agent in place. Note the behavior of rsync
-different if \-R is used with other flags from if used alone. Alone the rsync
-\-\-delete parameter is sent, useful for cleaning the remote directory (when
-\-R is used together with other flags, it is not). Also see \-r
-
-.TP
-.B \ \-r \ \ [filename/wildcard]
-copies sisu output files to remote host using scp. This requires that
-sisurc.yml has been provided with information on hostname and username, and
-that you have your \"keys\" and ssh agent in place. Also see \-R
-
-.SH
-2.2 CONFIGURATION
-
-.BR
-[expand \ on \ the \ setting \ up \ of \ an \ ssh\-agent \ / \ keychain]
-
-.SH
-3. REMOTE SERVERS
-.BR
-
-.BR
-As
-.B SiSU
-is generally operated using the command line, and works within a Unix type
-environment,
-.B SiSU
-the program and all documents can just as easily be on a remote server, to
-which you are logged on using a terminal, and commands and operations would be
-pretty much the same as they would be on your local machine.
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Remote Operations
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-08\-28
-
-.BR
-DC Date issued:
-.I 2002\-08\-28
-
-.BR
-DC Date available:
-.I 2002\-08\-28
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_remote.sst
-
-.BR
-Filetype:
-.I SiSU text 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_remote.sst)=
-.I 9bdac464998dc3f034fbd8f80df23b83
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:46 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_remote/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_remote/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_remote/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_remote/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_remote/sisu_remote.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:51 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man8/sisu_search.8 b/man/man8/sisu_search.8
deleted file mode 100644
index bbe444e4..00000000
--- a/man/man8/sisu_search.8
+++ /dev/null
@@ -1,639 +0,0 @@
-.TH "sisu_search" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- SEARCH,
-RALPH AMISSAH
-.BR
-
-.SH
-SISU SEARCH
-.BR
-
-.SH
-1. SISU SEARCH \- INTRODUCTION
-.BR
-
-.BR
-.B SiSU
-output can easily and conveniently be indexed by a number of standalone
-indexing tools, such as Lucene, Hyperestraier.
-
-.BR
-Because the document structure of sites created is clearly defined, and the
-text object citation system is available hypothetically at least, for all forms
-of output, it is possible to search the sql database, and either read results
-from that database, or just as simply map the results to the html output, which
-has richer text markup.
-
-.BR
-In addition to this
-.B SiSU
-has the ability to populate a relational sql type database with documents at
-an object level, with objects numbers that are shared across different output
-types, which make them searchable with that degree of granularity. Basically,
-your match criteria is met by these documents and at these locations within
-each document, which can be viewed within the database directly or in various
-output formats.
-
-.SH
-2. SQL
-.BR
-
-.SH
-2.1 POPULATING SQL TYPE DATABASES
-
-.BR
-.B SiSU
-feeds sisu markupd documents into sql type databases PostgreSQL[^1] and/or
-SQLite[^2] database together with information related to document structure.
-
-.BR
-This is one of the more interesting output forms, as all the structural data of
-the documents are retained (though can be ignored by the user of the database
-should they so choose). All site texts/documents are (currently) streamed to
-four tables:
-
-.BR
- * one containing semantic (and other) headers, including, title, author,
- subject, (the Dublin Core...);
-
-.BR
- * another the substantive texts by individual \"paragraph\" (or object) \-
- along with structural information, each paragraph being identifiable by its
- paragraph number (if it has one which almost all of them do), and the
- substantive text of each paragraph quite naturally being searchable (both in
- formatted and clean text versions for searching); and
-
-.BR
- * a third containing endnotes cross\-referenced back to the paragraph from
- which they are referenced (both in formatted and clean text versions for
- searching).
-
-.BR
- * a fourth table with a one to one relation with the headers table contains
- full text versions of output, eg. pdf, html, xml, and ascii.
-
-.BR
-There is of course the possibility to add further structures.
-
-.BR
-At this level
-.B SiSU
-loads a relational database with documents chunked into objects, their
-smallest logical structurally constituent parts, as text objects, with their
-object citation number and all other structural information needed to construct
-the document. Text is stored (at this text object level) with and without
-elementary markup tagging, the stripped version being so as to facilitate ease
-of searching.
-
-.BR
-Being able to search a relational database at an object level with the
-.B SiSU
-citation system is an effective way of locating content generated by
-.B SiSU
-. As individual text objects of a document stored (and indexed) together with
-object numbers, and all versions of the document have the same numbering,
-complex searches can be tailored to return just the locations of the search
-results relevant for all available output formats, with live links to the
-precise locations in the database or in html/xml documents; or, the structural
-information provided makes it possible to search the full contents of the
-database and have headings in which search content appears, or to search only
-headings etc. (as the Dublin Core is incorporated it is easy to make use of
-that as well).
-
-.SH
-3. POSTGRESQL
-.BR
-
-.SH
-3.1 NAME
-
-.BR
-.B SiSU
-\- Structured information, Serialized Units \- a document publishing system,
-postgresql dependency package
-
-.SH
-3.2 DESCRIPTION
-
-.BR
-Information related to using postgresql with sisu (and related to the
-sisu_postgresql dependency package, which is a dummy package to install
-dependencies needed for
-.B SiSU
-to populate a postgresql database, this being part of
-.B SiSU
-\- man sisu).
-
-.SH
-3.3 SYNOPSIS
-
-.BR
- sisu \-D \ [instruction] \ [filename/wildcard \ if \ required]
-
-.BR
- sisu \-D \-\-pg \-\-[instruction] \ [filename/wildcard \ if \ required]
-
-.SH
-3.4 COMMANDS
-
-.BR
-Mappings to two databases are provided by default, postgresql and sqlite, the
-same commands are used within sisu to construct and populate databases however
-\-d (lowercase) denotes sqlite and \-D (uppercase) denotes postgresql,
-alternatively \-\-sqlite or \-\-pgsql may be used
-
-.BR
-.B \-D or \-\-pgsql
-may be used interchangeably.
-
-.SH
-3.4.1 CREATE AND DESTROY DATABASE
-
-.TP
-.B \ \-\-pgsql \ \-\-createall
-\ initial \ step, \ creates \ required \ relations \ (tables, \ indexes) \ in
-\ existing \ (postgresql) \ database \ (a \ database \ should \ be \ created \
-manually \ and \ given \ the \ same \ name \ as \ working \ directory, \ as \
-requested) \ (rb.dbi) \
-
-.TP
-.B \ sisu \ \-D \ \-\-createdb
-\ creates \ database \ where \ no \ database \ existed \ before \
-
-.TP
-.B \ sisu \ \-D \ \-\-create
-\ creates \ database \ tables \ where \ no \ database \ tables \ existed \
-before \
-
-.TP
-.B \ sisu \ \-D \ \-\-Dropall
-\ destroys \ database \ (including \ all \ its \ content)! \ kills \ data \
-and \ drops \ tables, \ indexes \ and \ database \ associated \ with \ a \
-given \ directory \ (and \ directories \ of \ the \ same \ name). \
-
-.TP
-.B \ sisu \ \-D \ \-\-recreate
-\ destroys \ existing \ database \ and \ builds \ a \ new \ empty \ database
-\ structure \
-
-.SH
-3.4.2 IMPORT AND REMOVE DOCUMENTS
-
-.TP
-.B \ sisu \ \-D \ \-\-import \ \-v \ \ [filename/wildcard]
-populates database with the contents of the file. Imports documents(s)
-specified to a postgresql database (at an object level).
-
-.TP
-.B \ sisu \ \-D \ \-\-update \ \-v \ \ [filename/wildcard]
-updates file contents in database
-
-.TP
-.B \ sisu \ \-D \ \-\-remove \ \-v \ \ [filename/wildcard]
-removes specified document from postgresql database.
-
-.SH
-4. SQLITE
-.BR
-
-.SH
-4.1 NAME
-
-.BR
-.B SiSU
-\- Structured information, Serialized Units \- a document publishing system.
-
-.SH
-4.2 DESCRIPTION
-
-.BR
-Information related to using sqlite with sisu (and related to the sisu_sqlite
-dependency package, which is a dummy package to install dependencies needed for
-.B SiSU
-to populate an sqlite database, this being part of
-.B SiSU
-\- man sisu).
-
-.SH
-4.3 SYNOPSIS
-
-.BR
- sisu \-d \ [instruction] \ [filename/wildcard \ if \ required]
-
-.BR
- sisu \-d \-\-(sqlite|pg) \-\-[instruction] \ [filename/wildcard \ if \
- required]
-
-.SH
-4.4 COMMANDS
-
-.BR
-Mappings to two databases are provided by default, postgresql and sqlite, the
-same commands are used within sisu to construct and populate databases however
-\-d (lowercase) denotes sqlite and \-D (uppercase) denotes postgresql,
-alternatively \-\-sqlite or \-\-pgsql may be used
-
-.BR
-.B \-d or \-\-sqlite
-may be used interchangeably.
-
-.SH
-4.4.1 CREATE AND DESTROY DATABASE
-
-.TP
-.B \ \-\-sqlite \ \-\-createall
-\ initial \ step, \ creates \ required \ relations \ (tables, \ indexes) \ in
-\ existing \ (sqlite) \ database \ (a \ database \ should \ be \ created \
-manually \ and \ given \ the \ same \ name \ as \ working \ directory, \ as \
-requested) \ (rb.dbi) \
-
-.TP
-.B \ sisu \ \-d \ \-\-createdb
-\ creates \ database \ where \ no \ database \ existed \ before \
-
-.TP
-.B \ sisu \ \-d \ \-\-create
-\ creates \ database \ tables \ where \ no \ database \ tables \ existed \
-before \
-
-.TP
-.B \ sisu \ \-d \ \-\-dropall
-\ destroys \ database \ (including \ all \ its \ content)! \ kills \ data \
-and \ drops \ tables, \ indexes \ and \ database \ associated \ with \ a \
-given \ directory \ (and \ directories \ of \ the \ same \ name). \
-
-.TP
-.B \ sisu \ \-d \ \-\-recreate
-\ destroys \ existing \ database \ and \ builds \ a \ new \ empty \ database
-\ structure \
-
-.SH
-4.4.2 IMPORT AND REMOVE DOCUMENTS
-
-.TP
-.B \ sisu \ \-d \ \-\-import \ \-v \ \ [filename/wildcard]
-populates database with the contents of the file. Imports documents(s)
-specified to an sqlite database (at an object level).
-
-.TP
-.B \ sisu \ \-d \ \-\-update \ \-v \ \ [filename/wildcard]
-updates file contents in database
-
-.TP
-.B \ sisu \ \-d \ \-\-remove \ \-v \ \ [filename/wildcard]
-removes specified document from sqlite database.
-
-.SH
-5. INTRODUCTION
-.BR
-
-.SH
-5.1 SEARCH \- DATABASE FRONTEND SAMPLE, UTILISING DATABASE AND SISU FEATURES,
-INCLUDING OBJECT CITATION NUMBERING (BACKEND CURRENTLY POSTGRESQL)
-
-.BR
-Sample search frontend <http://search.sisudoc.org> \ [^3] A small database and
-sample query front\-end (search from) that makes use of the citation system,
-.I object citation numbering
-to demonstrates functionality.[^4]
-
-.BR
-.B SiSU
-can provide information on which documents are matched and at what locations
-within each document the matches are found. These results are relevant across
-all outputs using object citation numbering, which includes html, XML, LaTeX,
-PDF and indeed the SQL database. You can then refer to one of the other outputs
-or in the SQL database expand the text within the matched objects (paragraphs)
-in the documents matched.
-
-.BR
-Note you may set results either for documents matched and object number
-locations within each matched document meeting the search criteria; or display
-the names of the documents matched along with the objects (paragraphs) that
-meet the search criteria.[^5]
-
-.TP
-.B \ sisu \ \-F \ \-\-webserv\-webrick
-\ builds \ a \ cgi \ web \ search \ frontend \ for \ the \ database \ created
-\
-
-.BR
-The following is feedback on the setup on a machine provided by the help
-command:
-
-.BR
- sisu \-\-help sql
-
-
-.nf
- Postgresql
- user: ralph
- current db set: SiSU_sisu
- port: 5432
- dbi connect: DBI:Pg:database=SiSU_sisu;port=5432
- sqlite
- current db set: /home/ralph/sisu_www/sisu/sisu_sqlite.db
- dbi connect DBI:SQLite:/home/ralph/sisu_www/sisu/sisu_sqlite.db
-.fi
-
-.BR
-Note on databases built
-
-.BR
-By default, \ [unless \ otherwise \ specified] databases are built on a
-directory basis, from collections of documents within that directory. The name
-of the directory you choose to work from is used as the database name, i.e. if
-you are working in a directory called /home/ralph/ebook the database SiSU_ebook
-is used. \ [otherwise \ a \ manual \ mapping \ for \ the \ collection \ is \
-necessary]
-
-.SH
-5.2 SEARCH FORM
-
-.TP
-.B \ sisu \ \-F
-\ generates \ a \ sample \ search \ form, \ which \ must \ be \ copied \ to \
-the \ web\-server \ cgi \ directory \
-
-.TP
-.B \ sisu \ \-F \ \-\-webserv\-webrick
-\ generates \ a \ sample \ search \ form \ for \ use \ with \ the \ webrick \
-server, \ which \ must \ be \ copied \ to \ the \ web\-server \ cgi \ directory
-\
-
-.TP
-.B \ sisu \ \-Fv
-\ as \ above, \ and \ provides \ some \ information \ on \ setting \ up \
-hyperestraier \
-
-.TP
-.B \ sisu \ \-W
-\ starts \ the \ webrick \ server \ which \ should \ be \ available \
-wherever \ sisu \ is \ properly \ installed \
-
-.BR
-The generated search form must be copied manually to the webserver directory as
-instructed
-
-.SH
-6. HYPERESTRAIER
-.BR
-
-.BR
-See the documentation for hyperestraier:
-
-.BR
- <http://hyperestraier.sourceforge.net/>
-
-.BR
- /usr/share/doc/hyperestraier/index.html
-
-.BR
- man estcmd
-
-.BR
-on sisu_hyperestraier:
-
-.BR
- man sisu_hyperestraier
-
-.BR
- /usr/share/doc/sisu/sisu_markup/sisu_hyperestraier/index.html
-
-.BR
-NOTE: the examples that follow assume that sisu output is placed in the
-directory /home/ralph/sisu_www
-
-.BR
-(A) to generate the index within the webserver directory to be indexed:
-
-.BR
- estcmd gather \-sd \ [index \ name] \ [directory \ path \ to \ index]
-
-.BR
-the following are examples that will need to be tailored according to your
-needs:
-
-.BR
- cd /home/ralph/sisu_www
-
-.BR
- estcmd gather \-sd casket /home/ralph/sisu_www
-
-.BR
-you may use the \'find\' command together with \'egrep\' to limit indexing to
-particular document collection directories within the web server directory:
-
-.BR
- find /home/ralph/sisu_www \-type f | egrep
- \'/home/ralph/sisu_www/sisu/.+?.html$\' |estcmd gather \-sd casket \-
-
-.BR
-Check which directories in the webserver/output directory (~/sisu_www or
-elsewhere depending on configuration) you wish to include in the search index.
-
-.BR
-As sisu duplicates output in multiple file formats, it it is probably
-preferable to limit the estraier index to html output, and as it may also be
-desirable to exclude files \'plain.txt\', \'toc.html\' and
-\'concordance.html\', as these duplicate information held in other html output
-e.g.
-
-.BR
- find /home/ralph/sisu_www \-type f | egrep
- \'/sisu_www/(sisu|bookmarks)/.+?.html$\' | egrep \-v
- \'(doc|concordance).html$\' |estcmd gather \-sd casket \-
-
-.BR
-from your current document preparation/markup directory, you would construct a
-rune along the following lines:
-
-.BR
- find /home/ralph/sisu_www \-type f | egrep \'/home/ralph/sisu_www/([specify \
- first \ directory \ for \ inclusion]|[specify \ second \ directory \ for \
- inclusion]|[another \ directory \ for \ inclusion? \ \...])/.+?.html$\' |
- egrep \-v \'(doc|concordance).html$\' |estcmd gather \-sd
- /home/ralph/sisu_www/casket \-
-
-.BR
-(B) to set up the search form
-
-.BR
-(i) copy estseek.cgi to your cgi directory and set file permissions to 755:
-
-.BR
- sudo cp \-vi /usr/lib/estraier/estseek.cgi /usr/lib/cgi\-bin
-
-.BR
- sudo chmod \-v 755 /usr/lib/cgi\-bin/estseek.cgi
-
-.BR
- sudo cp \-v /usr/share/hyperestraier/estseek.* /usr/lib/cgi\-bin
-
-.BR
- \ [see \ estraier \ documentation \ for \ paths]
-
-.BR
-(ii) edit estseek.conf, with attention to the lines starting \'indexname:\' and
-\'replace:\':
-
-.BR
- indexname: /home/ralph/sisu_www/casket
-
-.BR
- replace: ^file:///home/ralph/sisu_www{{!}}http://localhost
-
-.BR
- replace: /index.html?${{!}}/
-
-.BR
-(C) to test using webrick, start webrick:
-
-.BR
- sisu \-W
-
-.BR
-and try open the url: <http://localhost:8081/cgi\-bin/estseek.cgi>
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_search/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Search
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-08\-28
-
-.BR
-DC Date issued:
-.I 2002\-08\-28
-
-.BR
-DC Date available:
-.I 2002\-08\-28
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_search._sst
-
-.BR
-Filetype:
-.I SiSU text insert 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_search._sst)=
-.I c085c2eb6d68f1b7d50435f673ede407
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:48 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-.TP
-.BI 1.
-<http://www.postgresql.org/>
- <http://advocacy.postgresql.org/>
- <http://en.wikipedia.org/wiki/Postgresql>
-.TP
-.BI 2.
-<http://www.hwaci.com/sw/sqlite/>
- <http://en.wikipedia.org/wiki/Sqlite>
-.TP
-.BI 3.
-<http://search.sisudoc.org>
-.TP
-.BI 4.
-(which could be extended further with current back-end). As regards scaling
-of the database, it is as scalable as the database (here Postgresql) and
-hardware allow.
-.TP
-.BI 5.
-of this feature when demonstrated to an IBM software innovations evaluator in
-2004 he said to paraphrase: this could be of interest to us. We have large
-document management systems, you can search hundreds of thousands of documents
-and we can tell you which documents meet your search criteria, but there is no
-way we can tell you without opening each document where within each your
-matches are found.
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_search/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_search/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_search/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_search/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_search/sisu_search.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:52 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu
diff --git a/man/man8/sisu_syntax_highlighting.8 b/man/man8/sisu_syntax_highlighting.8
deleted file mode 100644
index ab43f9ff..00000000
--- a/man/man8/sisu_syntax_highlighting.8
+++ /dev/null
@@ -1,307 +0,0 @@
-.TH "sisu_syntax_highlighting" "1" "2007-09-16" "0.59.1" "SiSU"
-.SH
-SISU \- SYNTAX HIGHLIGHTING,
-RALPH AMISSAH
-.BR
-
-.SH
-SISU SYNTAX HIGHLIGHTING
-.BR
-
-.SH
-1. EDITOR FILES, SYNTAX HIGHLIGHTING
-.BR
-
-.BR
-The directory:
-
-.BR
- \./data/sisu/conf/editor\-syntax\-etc/
-
-.BR
- /usr/share/sisu/conf/editor\-syntax\-etc
-
-.BR
-contains rudimentary sisu syntax highlighting files for:
-
-.BR
-* (g)vim <http://www.vim.org>
-
-.BR
- package: sisu\-vim
-
-.BR
-status: largely done
-
-.BR
- there is a vim syntax highlighting and folds component
-
-.BR
-* gedit <http://www.gnome.org/projects/gedit>
-
-.BR
-* gobby <http://gobby.0x539.de/>
-
-.BR
- file: sisu.lang
-
-.BR
-place in:
-
-.BR
- /usr/share/gtksourceview\-1.0/language\-specs
-
-.BR
-or
-
-.BR
- ~/.gnome2/gtksourceview\-1.0/language\-specs
-
-.BR
- status: very basic syntax highlighting
-
-.BR
- comments: this editor features display line wrap and is used by Goby!
-
-.BR
-* nano <http://www.nano\-editor.org>
-
-.BR
- file: nanorc
-
-.BR
-save as:
-
-.BR
- ~/.nanorc
-
-.BR
- status: basic syntax highlighting
-
-.BR
- comments: assumes dark background; no display line\-wrap; does line breaks
-
-.BR
-* diakonos (an editor written in ruby) <http://purepistos.net/diakonos>
-
-.BR
-file: diakonos.conf
-
-.BR
-save as:
-
-.BR
- ~/.diakonos/diakonos.conf
-
-.BR
-includes:
-
-.BR
- status: basic syntax highlighting
-
-.BR
-comments: assumes dark background; no display line\-wrap
-
-.BR
-* kate & kwrite <http://kate.kde.org>
-
-.BR
- file: sisu.xml
-
-.BR
- place in:
-
-.BR
- /usr/share/apps/katepart/syntax
-
-.BR
- or
-
-.BR
- ~/.kde/share/apps/katepart/syntax
-
-.BR
- \ [settings::configure \ kate::{highlighting,filetypes}]
-
-.BR
- \ [tools::highlighting::{markup,scripts}::
-.B \ SiSU
-]
-
-.BR
-* nedit <http://www.nedit.org>
-
-.BR
- file: sisu_nedit.pats
-
-.BR
- nedit \-import sisu_nedit.pats
-
-.BR
- status: a very clumsy first attempt \ [not \ really \ done]
-
-.BR
- comments: this editor features display line wrap
-
-.BR
-* emacs <http://www.gnu.org/software/emacs/emacs.html>
-
-.BR
- files: sisu\-mode.el
-
-.BR
- to file ~/.emacs add the following 2 lines:
-
-.BR
- (add\-to\-list \'load\-path \"/usr/share/sisu\-examples/config/syntax_hi\")
-
-.BR
- (require \'sisu\-mode.el)
-
-.BR
- \ [not \ done \ / \ not \ yet \ included]
-
-.BR
-* vim & gvim <http://www.vim.org>
-
-.BR
- files:
-
-.BR
- package is the most comprehensive sisu syntax highlighting and editor
- environment provided to date (is for vim/ gvim, and is separate from the
- contents of this directory)
-
-.BR
- status: this includes: syntax highlighting; vim folds; some error checking
-
-.BR
- comments: this editor features display line wrap
-
-.BR
-NOTE:
-
-.BR
-[
-.B \ SiSU
-\ parses \ files \ with \ long \ lines \ or \ line \ breaks, \ but, \ display
-\ linewrap \ (without \ line\-breaks) \ is \ a \ convenient \ editor \ feature
-\ to \ have \ for \ sisu \ markup]
-
-.SH
-DOCUMENT INFORMATION (METADATA)
-.BR
-
-.SH
-METADATA
-.BR
-
-.BR
-Document Manifest @
-<http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/sisu_manifest.html>
-
-.BR
-.B Dublin Core
-(DC)
-
-.BR
-.I DC tags included with this document are provided here.
-
-.BR
-DC Title:
-.I SiSU \- Syntax Highlighting
-
-.BR
-DC Creator:
-.I Ralph Amissah
-
-.BR
-DC Rights:
-.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
-3
-
-.BR
-DC Type:
-.I information
-
-.BR
-DC Date created:
-.I 2002\-11\-12
-
-.BR
-DC Date issued:
-.I 2002\-11\-12
-
-.BR
-DC Date available:
-.I 2002\-11\-12
-
-.BR
-DC Date modified:
-.I 2007\-09\-16
-
-.BR
-DC Date:
-.I 2007\-09\-16
-
-.BR
-.B Version Information
-
-.BR
-Sourcefile:
-.I sisu_syntax_highlighting.sst
-
-.BR
-Filetype:
-.I SiSU text insert 0.58
-
-.BR
-Sourcefile Digest, MD5(sisu_syntax_highlighting.sst)=
-.I 28dd0275c6fcd67bbedcd8aee9df4b3e
-
-.BR
-Skin_Digest:
-MD5(/home/ralph/grotto/theatre/dbld/builds/sisu/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
-.I 20fc43cf3eb6590bc3399a1aef65c5a9
-
-.BR
-.B Generated
-
-.BR
-Document (metaverse) last generated:
-.I Tue Sep 25 02:54:46 +0100 2007
-
-.BR
-Generated by:
-.I SiSU
-.I 0.59.1
-of 2007w39/2 (2007\-09\-25)
-
-.BR
-Ruby version:
-.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
-
-
-.TP
-Other versions of this document:
-.TP
-manifest: <http://www.jus.uio.no/sisu/sisu_syntax_highlighting/sisu_manifest.html>
-.TP
-html: <http://www.jus.uio.no/sisu/sisu_syntax_highlighting/toc.html>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_syntax_highlighting/portrait.pdf>
-.TP
-pdf: <http://www.jus.uio.no/sisu/sisu_syntax_highlighting/landscape.pdf>
-." .TP
-." manpage: http://www.jus.uio.no/sisu/sisu_syntax_highlighting/sisu_syntax_highlighting.1
-.TP
-at: <http://www.jus.uio.no/sisu>
-.TP
-.TP
-* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
-.TP
-* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
-.TP
-* Last Generated on: Tue Sep 25 02:54:51 +0100 2007
-.TP
-* SiSU http://www.jus.uio.no/sisu