aboutsummaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorRalph Amissah <ralph@amissah.com>2011-06-26 21:26:07 -0400
committerRalph Amissah <ralph@amissah.com>2011-06-26 22:40:25 -0400
commit1d239f2504dffc05c39efd38a10a27dba9e9c85e (patch)
tree485daaef736390ac2ed61a1a07d3b8507fee00b7
parentv2 v3: sisurc.yml, config settings (diff)
v3: documentation, on additional breaks in document, (remove some old info)sisu_3.0.13
* linebreak \\ (previously undocumented <br> kept but depreciated) [it is intended that this should close #617298 (post mail)] * page break (breaks column if column, else breaks page) * page new (new page, breaks page) * sisurc.yml set output directory structure by language * removed section on hyperestraier, too specialised for general manpage (also section not checked recently)
-rw-r--r--data/doc/sisu/CHANGELOG_v310
-rw-r--r--data/doc/sisu/html/sisu.1.html578
-rw-r--r--data/doc/sisu/markup-samples/sisu_manual/sisu.ssm2
-rw-r--r--data/doc/sisu/markup-samples/sisu_manual/sisu_commands.sst2
-rw-r--r--data/doc/sisu/markup-samples/sisu_manual/sisu_markup.sst39
-rw-r--r--man/man1/sisu.1255
6 files changed, 402 insertions, 484 deletions
diff --git a/data/doc/sisu/CHANGELOG_v3 b/data/doc/sisu/CHANGELOG_v3
index 8984a2ef..7f2093b0 100644
--- a/data/doc/sisu/CHANGELOG_v3
+++ b/data/doc/sisu/CHANGELOG_v3
@@ -34,6 +34,14 @@ http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.13.orig.tar.gz
* sisu syntax highlighting, linebreak \\ added (<br> kept)
* colors, added cursor line & column
+ * documentation, on additional breaks in document
+ * linebreak \\ (previously undocumented <br> kept but depreciated)
+ [it is intended that this should close #617298]
+ * page break (breaks column if column, else breaks page)
+ * page new (new page, breaks page)
+ * removed section on hyperestraier, too specialised for general manpage
+ (also section not checked recently)
+
* texpdf
* define latex \newcommands for some special characters to simplify
dealing with them in sisu code \hardspace \caret \pipe \curlyopen
@@ -67,7 +75,7 @@ http://www.jus.uio.no/sisu/pkg/src/sisu_3.0.13.orig.tar.gz
* urls (ansi screen reporting), add document language code
- * sysenv, accomodate
+ * sysenv, accommodate
* manifest
* manpage
* info (texinfo)
diff --git a/data/doc/sisu/html/sisu.1.html b/data/doc/sisu/html/sisu.1.html
index 06fa3f15..fb74b10d 100644
--- a/data/doc/sisu/html/sisu.1.html
+++ b/data/doc/sisu/html/sisu.1.html
@@ -148,7 +148,7 @@ offers great possibilities.
citation system to reliably reference its documents. <b>SiSU</b> works well in
a complementary manner with such collaborative technologies as Wikis, which
can take advantage of and be used to discuss the substance of content prepared
-in <b>SiSU</b>
+in <b>SiSU.</b>
<p> <br>
&lt;<a href='http://www.sisudoc.org/'>http://www.sisudoc.org/</a>
&gt;
@@ -193,8 +193,8 @@ footnotes at end of each paragraph that contains them [ &nbsp;-A &nbsp;for &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). Alias -c
+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). Alias -c
<p> </dd>
<dt><b>--concordance [filename/wildcard]</b> </dt>
@@ -347,7 +347,8 @@ file (scroll.html). Alias -h
<dd>prints license information.
<p> </dd>
-<dt><b>--machine [filename/wildcard/url]</b> </dt>
+<dt><b>--machine [filename/wildcard/url]</b>
+</dt>
<dd>see --dal (document abstraction level/layer)
<p> </dd>
@@ -361,7 +362,8 @@ indicated. (also see -V). Aliases -M and --keep-processing-files
<p> </dd>
<dt><b>-M [filename/wildcard/url]</b> </dt>
-<dd>see --maintenance
+<dd>
+<p>see --maintenance
<p> </dd>
<dt><b>-m [filename/wildcard/url]</b> </dt>
@@ -393,7 +395,7 @@ by most processing flags.
<dd>see --odt
<p> </dd>
-<dt><b>--odt [filename/wildcard/url]</b> </dt>
+<dt><b>--odt [filename/wildcard/url]</b></dt>
<dd>output basic document in opendocument file format (opendocument.odt). Alias
-o
<p> </dd>
@@ -587,8 +589,8 @@ paths in sisurc.yml. Alias -U
<p> </dd>
<dt><b>-u [filename/wildcard]</b> </dt>
-<dd>provides url mapping of output files for the flags
-requested for processing, also see -U
+<dd>provides url mapping of output files for the flags requested for processing,
+also see -U
<p> </dd>
<dt><b>--v2 [filename/wildcard]</b> </dt>
@@ -597,9 +599,9 @@ This is the default and is normally omitted.
<p> </dd>
<dt><b>--v3 [filename/wildcard]</b> </dt>
-<dd>invokes the sisu v3 document parser/generator. Currently
-under development and incomplete, v3 requires &gt;= ruby1.9.2p180. You may run
-sisu3 instead.
+<dd>invokes
+the sisu v3 document parser/generator. Currently under development and incomplete,
+v3 requires &gt;= ruby1.9.2p180. You may run sisu3 instead.
<p> </dd>
<dt><b>--verbose [filename/wildcard]</b> </dt>
@@ -609,7 +611,8 @@ created for each of the processing flag requests. Alias -v
<p> </dd>
<dt><b>-V</b> </dt>
-<dd>on its own, provides <b>SiSU</b> version and environment information (sisu --help env)
+<dd>on its own,
+provides <b>SiSU</b> version and environment information (sisu --help env)
<p> </dd>
<dt><b>-V [filename/wildcard]</b> </dt>
@@ -618,7 +621,6 @@ created for each of the processing flag requests. Alias -v
<dt><b>-v</b> </dt>
<dd>on its own, provides <b>SiSU</b> version information
-
<p> </dd>
<dt><b>-v [filename/wildcard]</b> </dt>
@@ -646,11 +648,13 @@ webserver points at sisu output directories, the default port is set to
<p> </dd>
<dt><b>--xhtml [filename/wildcard]</b> </dt>
-<dd>produces xhtml/XML output for browser viewing (sax parsing). Alias -b
+<dd>produces xhtml/XML output for
+browser viewing (sax parsing). Alias -b
<p> </dd>
<dt><b>--xml-dom [filename/wildcard]</b> </dt>
-<dd>produces XML output with deep document structure, in the nature of dom. Alias -X
+<dd>produces
+XML output with deep document structure, in the nature of dom. Alias -X
<p> </dd>
<dt><b>--xml-sax [filename/wildcard]</b> </dt>
@@ -757,7 +761,7 @@ updates/imports specified data to postgresql db (rb.dbi) [ &nbsp;-dv &nbsp;--upd
<dt><b>--pg --remove</b> </dt>
<dd>[filename/wildcard] removes specified data to postgresql
-db (rb.dbi) [ &nbsp;-d --remove &nbsp;sqlite &nbsp;equivalent]
+db (rb.dbi) [ &nbsp;-d &nbsp;--remove &nbsp;sqlite &nbsp;equivalent]
<p> </dd>
<dt><b>--pg --dropall</b> </dt>
@@ -1270,10 +1274,9 @@ html
<p> <br>
<b>resulting output:</b>
<p> <br>
-normal text, <b>emphasis</b> , <b>bold text</b> , <i>italics</i> , <i>underscore</i> , "citation",
-^superscript^, [subscript], ++inserted text++, --strikethrough--, monospace
-<p>
-<br>
+normal text, <b>emphasis,</b> <b>bold text,</b> <i>italics,</i> <i>underscore</i> , "citation", ^superscript^,
+[subscript], ++inserted text++, --strikethrough--, monospace
+<p> <br>
<p>normal text
<p> <br>
@@ -2037,7 +2040,48 @@ opening code tag code{# as demonstrated here:
44 | death."&rsquo;
</pre>
<p>
-<h2><a name='sect38' href='#toc38'>9.7 Book Index</a></h2>
+<h2><a name='sect38' href='#toc38'>9.7 Additional Breaks - Linebreaks Within Objects, Column and Page-breaks</a></h2>
+
+<p>
+
+<h2><a name='sect39' href='#toc39'>9.7.1 Line-breaks</a></h2>
+
+<p> <br>
+To break a line within a "paragraph object", two backslashes \\ with a space
+before and a space or newline after them may be used.
+<p> <br>
+<pre> To break a line within a "paragraph object",
+ two backslashes \\ with a space before
+ and a space or newline after them \\
+ may be used.
+</pre>
+<p> <br>
+The html break br enclosed in angle brackets (though undocumented) is available
+in versions prior to 3.0.13 and 2.9.7 (it remains available for the time being,
+but is depreciated).
+<p>
+<h2><a name='sect40' href='#toc40'>9.7.2 Page Breaks</a></h2>
+
+<p> <br>
+Page breaks are only relevant and honored in some output formats. A page
+break or a new page may be inserted manually using the following markup
+on a line on its own:
+<p> <br>
+<pre> &lt;:pb&gt;
+</pre>
+<p> <br>
+
+<p>or
+<p> <br>
+<pre> &lt;:pn&gt;
+</pre>
+<p> <br>
+page new &lt;:pn&gt; breaks the page, starts a new page.
+<p> <br>
+page break &lt;:pb&gt; breaks a column, starts a new column, if using columns,
+else breaks the page, starts a new page.
+<p>
+<h2><a name='sect41' href='#toc41'>9.8 Book Index</a></h2>
<p> <br>
To make an index append to paragraph the book index term relates to it,
@@ -2091,7 +2135,7 @@ be:
second sub-term, 1,
</pre>
<p>
-<h2><a name='sect39' href='#toc39'>10. Composite Documents Markup</a></h2>
+<h2><a name='sect42' href='#toc42'>10. Composite Documents Markup</a></h2>
<br>
<p> <br>
@@ -2127,11 +2171,11 @@ documents under consideration, and occasionally supported have been.
&lt;&lt; |filename.ssi|@|^|
</pre>
<p>
-<h2><a name='sect40' href='#toc40'>Markup Syntax History</a></h2>
+<h2><a name='sect43' href='#toc43'>Markup Syntax History</a></h2>
<br>
<p>
-<h2><a name='sect41' href='#toc41'>11. Notes Related to Files-types and Markup Syntax</a></h2>
+<h2><a name='sect44' href='#toc44'>11. Notes Related to Files-types and Markup Syntax</a></h2>
<br>
<p> 2.0 introduced new headers and is therefore incompatible with 1.0 though
@@ -2323,14 +2367,14 @@ in place of the 0.1 header, heading/structure notation
<b>SiSU</b> 0.1 headers and headings structure represented by header 0{~ and headings/structure
1{ 2{ 3{ 4{~ 5{ 6{
<p>
-<h2><a name='sect42' href='#toc42'>12. Sisu Filetypes</a></h2>
+<h2><a name='sect45' href='#toc45'>12. Sisu Filetypes</a></h2>
<br>
<p> <br>
<b>SiSU</b> has plaintext and binary filetypes, and can process either type of
document.
<p>
-<h2><a name='sect43' href='#toc43'>12.1 .sst .ssm .ssi Marked Up Plain Text</a></h2>
+<h2><a name='sect46' href='#toc46'>12.1 .sst .ssm .ssi Marked Up Plain Text</a></h2>
<p> <br>
<b>SiSU</b> documents are prepared as plain-text (utf-8) files with <b>SiSU</b> markup.
@@ -2351,7 +2395,7 @@ be located locally or on a remote server for which a url is provided.
sisu -s [filename]<br>
<p>
-<h2><a name='sect44' href='#toc44'>12.1.1 Sisu Text - Regular Files (.sst)</a></h2>
+<h2><a name='sect47' href='#toc47'>12.1.1 Sisu Text - Regular Files (.sst)</a></h2>
<p> <br>
The most common form of document in <b>SiSU</b> , see the section on <b>SiSU</b> markup.
@@ -2363,7 +2407,7 @@ The most common form of document in <b>SiSU</b> , see the section on <b>SiSU</b>
&lt;<a href='http://www.sisudoc.org/sisu/sisu_manual'>http://www.sisudoc.org/sisu/sisu_manual</a>
&gt;
<p>
-<h2><a name='sect45' href='#toc45'>12.1.2 Sisu Master Files (.ssm)</a></h2>
+<h2><a name='sect48' href='#toc48'>12.1.2 Sisu Master Files (.ssm)</a></h2>
<p> <br>
Composite documents which incorporate other <b>SiSU</b> documents which may be
@@ -2388,7 +2432,7 @@ with the same prefix and the suffix ._sst [^17]
&lt;<a href='http://www.sisudoc.org/sisu/sisu_manual'>http://www.sisudoc.org/sisu/sisu_manual</a>
&gt;
<p>
-<h2><a name='sect46' href='#toc46'>12.1.3 Sisu Insert Files (.ssi)</a></h2>
+<h2><a name='sect49' href='#toc49'>12.1.3 Sisu Insert Files (.ssi)</a></h2>
<p> <br>
Inserts are documents prepared solely for the purpose of being incorporated
@@ -2397,7 +2441,7 @@ except they are ignored by the <b>SiSU</b> processor. Making a file a .ssi file
is a quick and convenient way of flagging that it is not intended that
the file should be processed on its own.
<p>
-<h2><a name='sect47' href='#toc47'>12.2 Sisupod, Zipped Binary Container
+<h2><a name='sect50' href='#toc50'>12.2 Sisupod, Zipped Binary Container
(sisupod.zip, .ssp)</a></h2>
<p> <br>
@@ -2437,12 +2481,12 @@ locally or on a remote server for which a url is provided.
&lt;<a href='http://www.sisudoc.org/sisu/sisu_manual'>http://www.sisudoc.org/sisu/sisu_manual</a>
&gt;
<p>
-<h2><a name='sect48' href='#toc48'>13. Experimental Alternative Input
+<h2><a name='sect51' href='#toc51'>13. Experimental Alternative Input
Representations</a></h2>
<br>
<p>
-<h2><a name='sect49' href='#toc49'>13.1 Alternative Xml</a></h2>
+<h2><a name='sect52' href='#toc52'>13.1 Alternative Xml</a></h2>
<p> <br>
<b>SiSU</b> offers alternative XML input representations of documents as a proof
@@ -2470,7 +2514,7 @@ or the same:
sisu --from-sxml [filename/wildcard &nbsp;[.sxs.xml,.sxd.xml,sxn.xml]]<br>
<p>
-<h2><a name='sect50' href='#toc50'>13.1.1 Xml Sax Representation</a></h2>
+<h2><a name='sect53' href='#toc53'>13.1.1 Xml Sax Representation</a></h2>
<p> <br>
To convert from sst to simple xml (sax) representation:
@@ -2489,7 +2533,7 @@ or the same:
sisu --from-sxml [filename/wildcard &nbsp;[.sxs.xml,.sxd.xml,sxn.xml]]<br>
<p>
-<h2><a name='sect51' href='#toc51'>13.1.2 Xml Dom Representation</a></h2>
+<h2><a name='sect54' href='#toc54'>13.1.2 Xml Dom Representation</a></h2>
<p> <br>
To convert from sst to simple xml (dom) representation:
@@ -2508,7 +2552,7 @@ or the same:
sisu --from-sxml [filename/wildcard &nbsp;[.sxs.xml,.sxd.xml,sxn.xml]]<br>
<p>
-<h2><a name='sect52' href='#toc52'>13.1.3 Xml Node Representation</a></h2>
+<h2><a name='sect55' href='#toc55'>13.1.3 Xml Node Representation</a></h2>
<p> <br>
To convert from sst to simple xml (node) representation:
@@ -2527,11 +2571,11 @@ or the same:
sisu --from-sxml [filename/wildcard &nbsp;[.sxs.xml,.sxd.xml,sxn.xml]]<br>
<p>
-<h2><a name='sect53' href='#toc53'>14. Configuration</a></h2>
+<h2><a name='sect56' href='#toc56'>14. Configuration</a></h2>
<br>
<p>
-<h2><a name='sect54' href='#toc54'>14.1 Determining the Current Configuration</a></h2>
+<h2><a name='sect57' href='#toc57'>14.1 Determining the Current Configuration</a></h2>
<p> <br>
Information on the current configuration of <b>SiSU</b> should be available with
@@ -2548,7 +2592,7 @@ which is an alias for:
Either of these should be executed from within a directory that contains
sisu markup source documents.
<p>
-<h2><a name='sect55' href='#toc55'>14.2 Configuration Files (config.yml)</a></h2>
+<h2><a name='sect58' href='#toc58'>14.2 Configuration Files (config.yml)</a></h2>
<p> <br>
<b>SiSU</b> configration parameters are adjusted in the configuration file, which
@@ -2583,7 +2627,7 @@ database access details.
<p>If <b>SiSU</b> is installed a sample sisurc.yml may be found in /etc/sisu/sisurc.yml
<p>
-<h2><a name='sect56' href='#toc56'>15. Skins</a></h2>
+<h2><a name='sect59' href='#toc59'>15. Skins</a></h2>
<br>
<p> <br>
@@ -2618,7 +2662,7 @@ for document skins:
The skin itself is a ruby file which modifies the default appearances set
in the program.
<p>
-<h2><a name='sect57' href='#toc57'>15.1 Document Skin</a></h2>
+<h2><a name='sect60' href='#toc60'>15.1 Document Skin</a></h2>
<p> <br>
Documents take on a document skin, if the header of the document specifies
@@ -2627,7 +2671,7 @@ a skin to be used.
<pre> @skin: skin_united_nations
</pre>
<p>
-<h2><a name='sect58' href='#toc58'>15.2 Directory Skin</a></h2>
+<h2><a name='sect61' href='#toc61'>15.2 Directory Skin</a></h2>
<p> <br>
A directory may be mapped on to a particular skin, so all documents within
@@ -2639,13 +2683,13 @@ specifies the use of another skin, in the skin/doc directory).
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>
-<h2><a name='sect59' href='#toc59'>15.3 Site
+<h2><a name='sect62' href='#toc62'>15.3 Site
Skin</a></h2>
<p> <br>
A site skin, modifies the program default skin.
<p>
-<h2><a name='sect60' href='#toc60'>15.4 Sample Skins</a></h2>
+<h2><a name='sect63' href='#toc63'>15.4 Sample Skins</a></h2>
<p> <br>
With <b>SiSU</b> installed sample skins may be found in:
@@ -2667,7 +2711,7 @@ list) may be found in:
equivalent directory)<br>
<p>
-<h2><a name='sect61' href='#toc61'>16. Css - Cascading Style Sheets (for Html, Xhtml and Xml)</a></h2>
+<h2><a name='sect64' href='#toc64'>16. Css - Cascading Style Sheets (for Html, Xhtml and Xml)</a></h2>
<br>
<p> <br>
@@ -2695,11 +2739,11 @@ Under consideration is to permit the placement of a CSS file with a different
name in directory _sisu/css directory or equivalent, and change the default
CSS file that is looked for in a skin.[^18]
<p>
-<h2><a name='sect62' href='#toc62'>17. Organising Content</a></h2>
+<h2><a name='sect65' href='#toc65'>17. Organising Content</a></h2>
<br>
<p>
-<h2><a name='sect63' href='#toc63'>17.1 Directory Structure and Mapping</a></h2>
+<h2><a name='sect66' href='#toc66'>17.1 Directory Structure and Mapping</a></h2>
<p> <br>
The output directory root can be set in the sisurc.yml file. Under the root,
@@ -2726,15 +2770,15 @@ be output to the same output directory. Skins could be associated with each
institution on a directory basis and resulting documents will take on the
appropriate different appearance.
<p>
-<h2><a name='sect64' href='#toc64'>18. Homepages</a></h2>
+<h2><a name='sect67' href='#toc67'>18. Homepages</a></h2>
<br>
<p> <br>
<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:
+as custom built items, and are not created by <b>SiSU.</b> More accurately, <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> <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
@@ -2746,7 +2790,7 @@ 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>
-<h2><a name='sect65' href='#toc65'>18.1 Home Page and Other
+<h2><a name='sect68' href='#toc68'>18.1 Home Page and Other
Custom Built Pages in a Sub-directory</a></h2>
<p> <br>
@@ -2759,7 +2803,7 @@ command:
sisu -CC<br>
<p>
-<h2><a name='sect66' href='#toc66'>18.2 Home Page Within a Skin</a></h2>
+<h2><a name='sect69' href='#toc69'>18.2 Home Page Within a Skin</a></h2>
<p> <br>
Skins are described in a separate section, but basically are a file written
@@ -2789,11 +2833,11 @@ index.html
end
</pre>
<p>
-<h2><a name='sect67' href='#toc67'>19. Markup and Output Examples</a></h2>
+<h2><a name='sect70' href='#toc70'>19. Markup and Output Examples</a></h2>
<br>
<p>
-<h2><a name='sect68' href='#toc68'>19.1 Markup Examples</a></h2>
+<h2><a name='sect71' href='#toc71'>19.1 Markup Examples</a></h2>
<p> <br>
Current markup examples and document output samples are provided at &lt;<a href='http://www.jus.uio.no/sisu/SiSU/examples.html'>http://www.jus.uio.no/sisu/SiSU/examples.html</a>
@@ -2804,7 +2848,7 @@ For some documents hardly any markup at all is required at all, other than
a header, and an indication that the levels to be taken into account by
the program in generating its output are.
<p>
-<h2><a name='sect69' href='#toc69'>20. Sisu Search - Introduction</a></h2>
+<h2><a name='sect72' href='#toc72'>20. Sisu Search - Introduction</a></h2>
<br>
<p> <br>
@@ -2824,11 +2868,11 @@ 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>
-<h2><a name='sect70' href='#toc70'>21. Sql</a></h2>
+<h2><a name='sect73' href='#toc73'>21. Sql</a></h2>
<br>
<p>
-<h2><a name='sect71' href='#toc71'>21.1 Populating Sql Type Databases</a></h2>
+<h2><a name='sect74' href='#toc74'>21.1 Populating Sql Type Databases</a></h2>
<p> <br>
<b>SiSU</b> feeds sisu markupd documents into sql type databases PostgreSQL[^19]
@@ -2883,18 +2927,18 @@ 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>
-<h2><a name='sect72' href='#toc72'>22. Postgresql</a></h2>
+<h2><a name='sect75' href='#toc75'>22. Postgresql</a></h2>
<br>
<p>
-<h2><a name='sect73' href='#toc73'>22.1 Name</a></h2>
+<h2><a name='sect76' href='#toc76'>22.1 Name</a></h2>
<p> <br>
<b>SiSU</b> - Structured information, Serialized Units - a document publishing system,
<p>postgresql dependency package
<p>
-<h2><a name='sect74' href='#toc74'>22.2 Description</a></h2>
+<h2><a name='sect77' href='#toc77'>22.2 Description</a></h2>
<p> <br>
Information related to using postgresql with sisu (and related to the sisu_postgresql
@@ -2902,7 +2946,7 @@ 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>
-<h2><a name='sect75' href='#toc75'>22.3 Synopsis</a></h2>
+<h2><a name='sect78' href='#toc78'>22.3 Synopsis</a></h2>
<p> <br>
sisu -D [instruction] [filename/wildcard &nbsp;if &nbsp;required]<br>
@@ -2911,7 +2955,7 @@ sisu).
sisu -D --pg --[instruction] [filename/wildcard &nbsp;if &nbsp;required]<br>
<p>
-<h2><a name='sect76' href='#toc76'>22.4 Commands</a></h2>
+<h2><a name='sect79' href='#toc79'>22.4 Commands</a></h2>
<p> <br>
Mappings to two databases are provided by default, postgresql and sqlite,
@@ -2922,7 +2966,7 @@ however -d (lowercase) denotes sqlite and -D (uppercase) denotes postgresql,
<p> <br>
<b>-D or --pgsql</b> may be used interchangeably.
<p>
-<h2><a name='sect77' href='#toc77'>22.4.1 Create and Destroy Database</a></h2>
+<h2><a name='sect80' href='#toc80'>22.4.1 Create and Destroy Database</a></h2>
<p>
@@ -2959,7 +3003,7 @@ of the same name).
<p> </dd>
</dl>
-<h2><a name='sect78' href='#toc78'>22.4.2 Import and Remove Documents</a></h2>
+<h2><a name='sect81' href='#toc81'>22.4.2 Import and Remove Documents</a></h2>
<p>
<dl>
@@ -2982,17 +3026,17 @@ database.
<p> </dd>
</dl>
-<h2><a name='sect79' href='#toc79'>23. Sqlite</a></h2>
+<h2><a name='sect82' href='#toc82'>23. Sqlite</a></h2>
<br>
<p>
-<h2><a name='sect80' href='#toc80'>23.1 Name</a></h2>
+<h2><a name='sect83' href='#toc83'>23.1 Name</a></h2>
<p> <br>
<b>SiSU</b> - Structured information, Serialized Units - a document publishing system.
<p>
-<h2><a name='sect81' href='#toc81'>23.2 Description</a></h2>
+<h2><a name='sect84' href='#toc84'>23.2 Description</a></h2>
<p> <br>
Information related to using sqlite with sisu (and related to the sisu_sqlite
@@ -3000,7 +3044,7 @@ 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>
-<h2><a name='sect82' href='#toc82'>23.3 Synopsis</a></h2>
+<h2><a name='sect85' href='#toc85'>23.3 Synopsis</a></h2>
<p> <br>
sisu -d [instruction] [filename/wildcard &nbsp;if &nbsp;required]<br>
@@ -3009,7 +3053,7 @@ for <b>SiSU</b> to populate an sqlite database, this being part of <b>SiSU</b> -
sisu -d --(sqlite|pg) --[instruction] [filename/wildcard &nbsp;if &nbsp;required]<br>
<p>
-<h2><a name='sect83' href='#toc83'>23.4 Commands</a></h2>
+<h2><a name='sect86' href='#toc86'>23.4 Commands</a></h2>
<p> <br>
Mappings to two databases are provided by default, postgresql and sqlite,
@@ -3020,7 +3064,7 @@ however -d (lowercase) denotes sqlite and -D (uppercase) denotes postgresql,
<p> <br>
<b>-d or --sqlite</b> may be used interchangeably.
<p>
-<h2><a name='sect84' href='#toc84'>23.4.1 Create and Destroy Database</a></h2>
+<h2><a name='sect87' href='#toc87'>23.4.1 Create and Destroy Database</a></h2>
<p>
@@ -3057,7 +3101,7 @@ of the same name).
<p> </dd>
</dl>
-<h2><a name='sect85' href='#toc85'>23.4.2 Import and Remove Documents</a></h2>
+<h2><a name='sect88' href='#toc88'>23.4.2 Import and Remove Documents</a></h2>
<p>
<dl>
@@ -3080,11 +3124,11 @@ database.
<p> </dd>
</dl>
-<h2><a name='sect86' href='#toc86'>24. Introduction</a></h2>
+<h2><a name='sect89' href='#toc89'>24. Introduction</a></h2>
<br>
<p>
-<h2><a name='sect87' href='#toc87'>24.1 Search - Database Frontend Sample, Utilising Database and Sisu Features,</a></h2>
+<h2><a name='sect90' href='#toc90'>24.1 Search - Database Frontend Sample, Utilising Database and Sisu Features,</a></h2>
INCLUDING
OBJECT CITATION NUMBERING (BACKEND CURRENTLY POSTGRESQL)
<p> <br>
@@ -3139,7 +3183,7 @@ SiSU_ebook is used. [otherwise &nbsp;a &nbsp;manual &nbsp;mapping &nbsp;for &nbs
<p> </dd>
</dl>
-<h2><a name='sect88' href='#toc88'>24.2
+<h2><a name='sect91' href='#toc91'>24.2
Search Form</a></h2>
<p>
@@ -3176,122 +3220,17 @@ search form for use with the webrick server, which must be copied to the
<p> </dd>
</dl>
-<h2><a name='sect89' href='#toc89'>25. Hyperestraier</a></h2>
+<h2><a name='sect92' href='#toc92'>25. Sisu_webrick</a></h2>
<br>
-<p> <br>
-See the documentation for hyperestraier:
-<p> <br>
- &lt;<a href='http://hyperestraier.sourceforge.net/'>http://hyperestraier.sourceforge.net/</a>
-&gt;<br>
-
-<p> <br>
- /usr/share/doc/hyperestraier/index.html<br>
-
-<p> <br>
- man estcmd<br>
-
-<p> <br>
-NOTE: the examples that follow assume that sisu output is placed in the
-
-<p>directory /home/ralph/sisu_www
-<p> <br>
-(A) to generate the index within the webserver directory to be indexed:
-
-<p> <br>
- estcmd gather -sd [index &nbsp;name] [directory &nbsp;path &nbsp;to &nbsp;index]<br>
-
-<p> <br>
-the following are examples that will need to be tailored according to your
-needs:
-<p> <br>
- cd /home/ralph/sisu_www<br>
-
-<p> <br>
- estcmd gather -sd casket /home/ralph/sisu_www<br>
-
-<p> <br>
-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> <br>
- find /home/ralph/sisu_www -type f | egrep<br>
- &rsquo;/home/ralph/sisu_www/sisu/.+?.html$&rsquo; |estcmd gather -sd casket -<br>
-
-<p> <br>
-Check which directories in the webserver/output directory (~/sisu_www or
-elsewhere depending on configuration) you wish to include in the search
-index.
-<p> <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 &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> <br>
- find /home/ralph/sisu_www -type f | egrep<br>
- &rsquo;/sisu_www/(sisu|bookmarks)/.+?.html$&rsquo; | egrep -v &rsquo;(doc|concordance).html$&rsquo;<br>
- |estcmd gather -sd casket -<br>
-
-<p> <br>
-from your current document preparation/markup directory, you would construct
-a rune along the following lines:
-<p> <br>
- 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> <br>
-(B) to set up the search form
-<p> <br>
-(i) copy estseek.cgi to your cgi directory and set file permissions to 755:
-
-<p> <br>
- sudo cp -vi /usr/lib/estraier/estseek.cgi /usr/lib/cgi-bin<br>
-
-<p> <br>
- sudo chmod -v 755 /usr/lib/cgi-bin/estseek.cgi<br>
-
-<p> <br>
- sudo cp -v /usr/share/hyperestraier/estseek.* /usr/lib/cgi-bin<br>
-
-<p> <br>
- [see &nbsp;estraier &nbsp;documentation &nbsp;for &nbsp;paths]<br>
-
-<p> <br>
-(ii) edit estseek.conf, with attention to the lines starting &rsquo;indexname:&rsquo;
-and
-<p> <br>
- indexname: /home/ralph/sisu_www/casket<br>
-
-<p> <br>
- replace: ^file:///home/ralph/sisu_www{{!}}<a href='http://localhost'>http://localhost</a>
-<br>
-
-<p> <br>
- replace: /index.html?${{!}}/<br>
-
-<p> <br>
-(C) to test using webrick, start webrick:
-<p> <br>
- sisu -W<br>
-
-<p> <br>
-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>
-<h2><a name='sect90' href='#toc90'>26. Sisu_webrick</a></h2>
-<br>
-
-<p>
-<h2><a name='sect91' href='#toc91'>26.1 Name</a></h2>
+<h2><a name='sect93' href='#toc93'>25.1 Name</a></h2>
<p> <br>
<b>SiSU</b> - Structured information, Serialized Units - a document publishing system
<p>
-<h2><a name='sect92' href='#toc92'>26.2 Synopsis</a></h2>
+<h2><a name='sect94' href='#toc94'>25.2 Synopsis</a></h2>
<p> <br>
sisu_webrick [port]
@@ -3301,7 +3240,7 @@ sisu_webrick [port]
<p> <br>
sisu -W [port]
<p>
-<h2><a name='sect93' href='#toc93'>26.3 Description</a></h2>
+<h2><a name='sect95' href='#toc95'>25.3 Description</a></h2>
<p> <br>
sisu_webrick is part of <b>SiSU</b> (man sisu) sisu_webrick starts <b>Ruby</b> <b>SiSU</b>
@@ -3312,7 +3251,7 @@ The default port for sisu_webrick is set to 8081, this may be modified
in the yaml file: ~/.sisu/sisurc.yml a sample of which is provided as /etc/sisu/sisurc.yml
(or in the equivalent directory on your system).
<p>
-<h2><a name='sect94' href='#toc94'>26.4 Summary of Man Page</a></h2>
+<h2><a name='sect96' href='#toc96'>25.4 Summary of Man Page</a></h2>
<p>
<br>
@@ -3323,7 +3262,7 @@ sisu_webrick, may be started on it&rsquo;s own with the command: sisu_webrick
<p>where no port is given and settings are unchanged the default port is 8081
<p>
-<h2><a name='sect95' href='#toc95'>26.5 Document Processing Command Flags</a></h2>
+<h2><a name='sect97' href='#toc97'>25.5 Document Processing Command Flags</a></h2>
<p> <br>
sisu -W [port] starts <b>Ruby</b> Webrick web-server, serving <b>SiSU</b> output directories,
@@ -3331,7 +3270,7 @@ on the port provided, or if no port is provided and the defaults have not
<p>been changed in ~/.sisu/sisurc.yaml then on port 8081
<p>
-<h2><a name='sect96' href='#toc96'>26.6 Further Information</a></h2>
+<h2><a name='sect98' href='#toc98'>25.6 Further Information</a></h2>
<p>
<br>
@@ -3343,12 +3282,12 @@ For more information on <b>SiSU</b> see: &lt;<a href='http://www.sisudoc.org/'>h
<p>or man sisu
<p>
-<h2><a name='sect97' href='#toc97'>26.7 Author</a></h2>
+<h2><a name='sect99' href='#toc99'>25.7 Author</a></h2>
<p> <br>
Ralph Amissah &lt;ralph@amissah.com&gt; or &lt;ralph.amissah@gmail.com&gt;
<p>
-<h2><a name='sect98' href='#toc98'>26.8 See Also</a></h2>
+<h2><a name='sect100' href='#toc100'>25.8 See Also</a></h2>
<p> <br>
<a href='http:~/bin/man2html?sisu:1'>sisu(1)</a>
@@ -3359,7 +3298,7 @@ Ralph Amissah &lt;ralph@amissah.com&gt; or &lt;ralph.amissah@gmail.com&gt;
<br>
<p>
-<h2><a name='sect99' href='#toc99'>27. Remote Source Documents</a></h2>
+<h2><a name='sect101' href='#toc101'>26. Remote Source Documents</a></h2>
<br>
<p> <br>
@@ -3406,11 +3345,11 @@ way, see &lt;<a href='http://www.jus.uio.no/sisu/SiSU/examples.html'>http://www.
&gt; and use the url for
the desired document.
<p>
-<h2><a name='sect100' href='#toc100'>Remote Document Output</a></h2>
+<h2><a name='sect102' href='#toc102'>Remote Document Output</a></h2>
<br>
<p>
-<h2><a name='sect101' href='#toc101'>28. Remote Output</a></h2>
+<h2><a name='sect103' href='#toc103'>27. Remote Output</a></h2>
<br>
<p> <br>
@@ -3425,7 +3364,7 @@ which may be used in conjunction with other processing flags, e.g.
<pre> sisu -3R sisu_remote.sst
</pre>
<p>
-<h2><a name='sect102' href='#toc102'>28.1 Commands</a></h2>
+<h2><a name='sect104' href='#toc104'>27.1 Commands</a></h2>
<p>
<dl>
@@ -3448,12 +3387,12 @@ ssh agent in place. Also see -R
<p> </dd>
</dl>
-<h2><a name='sect103' href='#toc103'>28.2 Configuration</a></h2>
+<h2><a name='sect105' href='#toc105'>27.2 Configuration</a></h2>
<p> <br>
[expand &nbsp;on &nbsp;the &nbsp;setting &nbsp;up &nbsp;of &nbsp;an &nbsp;ssh-agent &nbsp;/ &nbsp;keychain]
<p>
-<h2><a name='sect104' href='#toc104'>29. Remote Servers</a></h2>
+<h2><a name='sect106' href='#toc106'>28. Remote Servers</a></h2>
<br>
<p> <br>
@@ -3463,18 +3402,18 @@ 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>
-<h2><a name='sect105' href='#toc105'>30. Quickstart - Getting Started Howto</a></h2>
+<h2><a name='sect107' href='#toc107'>29. Quickstart - Getting Started Howto</a></h2>
<br>
<p>
-<h2><a name='sect106' href='#toc106'>30.1 Installation</a></h2>
+<h2><a name='sect108' href='#toc108'>29.1 Installation</a></h2>
<p> <br>
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>
-<h2><a name='sect107' href='#toc107'>30.1.1 Debian Installation</a></h2>
+<h2><a name='sect109' href='#toc109'>29.1.1 Debian Installation</a></h2>
<p> <br>
<b>SiSU</b> is available directly from the <b>Debian</b> Sid and testing archives (and
@@ -3524,7 +3463,7 @@ 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>
-<h2><a name='sect108' href='#toc108'>30.1.2 Rpm Installation</a></h2>
+<h2><a name='sect110' href='#toc110'>29.1.2 Rpm Installation</a></h2>
<p> <br>
RPMs are provided though untested, they are prepared by running alien against
@@ -3541,7 +3480,7 @@ as root type:
rpm -i [rpm &nbsp;package &nbsp;name]<br>
<p>
-<h2><a name='sect109' href='#toc109'>30.1.3 Installation from Source</a></h2>
+<h2><a name='sect111' href='#toc111'>29.1.3 Installation from Source</a></h2>
<p> <br>
To install <b>SiSU</b> from source check information at:
@@ -3560,7 +3499,7 @@ case: the first steps are the same, download and unpack the source file:
<p> <br>
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, EPUB, various
+it is written <b>Ruby,</b> and <b>SiSU</b> will be able to generate html, EPUB, 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
@@ -3632,7 +3571,7 @@ For a list of alternative actions you may type:
ruby install -T<br>
<p>
-<h2><a name='sect110' href='#toc110'>30.2 Testing Sisu, Generating Output</a></h2>
+<h2><a name='sect112' href='#toc112'>29.2 Testing Sisu, Generating Output</a></h2>
<p> <br>
To check which version of sisu is installed:
@@ -3655,7 +3594,7 @@ change directory to the appropriate one:
<p>cd /usr/share/doc/sisu/markup-samples/samples
<p>
-<h2><a name='sect111' href='#toc111'>30.2.1 Basic Text, Plaintext,
+<h2><a name='sect113' href='#toc113'>29.2.1 Basic Text, Plaintext,
Html, Xml, Odf, Epub</a></h2>
<p> <br>
@@ -3670,7 +3609,7 @@ this will generate html including a concordance file, opendocument text
format, plaintext, XHTML and various forms of XML, and OpenDocument text
<p>
-<h2><a name='sect112' href='#toc112'>30.2.2 LaTeX / Pdf</a></h2>
+<h2><a name='sect114' href='#toc114'>29.2.2 LaTeX / Pdf</a></h2>
<p> <br>
Assuming a LaTeX engine such as tetex or texlive is installed with the
@@ -3691,7 +3630,7 @@ file, opendocument text format, plaintext, XHTML and various forms of XML,
<p>and OpenDocument text and pdf
<p>
-<h2><a name='sect113' href='#toc113'>30.2.3 Relational Database - Postgresql, Sqlite</a></h2>
+<h2><a name='sect115' href='#toc115'>29.2.3 Relational Database - Postgresql, Sqlite</a></h2>
<p>
<br>
@@ -3716,10 +3655,10 @@ create the database and write to it when you run sisu.
<p>sisu --pgsql -v --import free_as_in_freedom.rms_and_free_software.sam_williams.sst
<p>
-<h2><a name='sect114' href='#toc114'>30.3 Getting Help</a></h2>
+<h2><a name='sect116' href='#toc116'>29.3 Getting Help</a></h2>
<p>
-<h2><a name='sect115' href='#toc115'>30.3.1 the Man Pages</a></h2>
+<h2><a name='sect117' href='#toc117'>29.3.1 the Man Pages</a></h2>
<p> <br>
Type:
@@ -3739,7 +3678,7 @@ date as within the package itself:
* man directory &lt;<a href='http://www.jus.uio.no/sisu/man'>http://www.jus.uio.no/sisu/man</a>
&gt; [^27]
<p>
-<h2><a name='sect116' href='#toc116'>30.3.2 Built in Help</a></h2>
+<h2><a name='sect118' href='#toc118'>29.3.2 Built in Help</a></h2>
<p> <br>
@@ -3754,7 +3693,7 @@ date as within the package itself:
<p>sisu --help --markup
<p>
-<h2><a name='sect117' href='#toc117'>30.3.3 the Home Page</a></h2>
+<h2><a name='sect119' href='#toc119'>29.3.3 the Home Page</a></h2>
<p> <br>
&lt;<a href='http://www.sisudoc.org/'>http://www.sisudoc.org/</a>
@@ -3766,7 +3705,7 @@ date as within the package itself:
&lt;<a href='http://www.jus.uio.no/sisu/SiSU'>http://www.jus.uio.no/sisu/SiSU</a>
&gt;
<p>
-<h2><a name='sect118' href='#toc118'>30.4 Markup Samples</a></h2>
+<h2><a name='sect120' href='#toc120'>29.4 Markup Samples</a></h2>
<p> <br>
A number of markup samples (along with output) are available off:
@@ -3782,7 +3721,7 @@ On <b>Debian</b> they are available in non-free[^28] to include them it is neces
to include non-free in your /etc/apt/source.list or obtain them from the
sisu home site.
<p>
-<h2><a name='sect119' href='#toc119'>31. Editor Files, Syntax Highlighting</a></h2>
+<h2><a name='sect121' href='#toc121'>30. Editor Files, Syntax Highlighting</a></h2>
<br>
<p> <br>
@@ -3952,10 +3891,9 @@ the<br>
NOTE:
<p> <br>
[ &nbsp;.B &nbsp;SiSU &nbsp;parses &nbsp;files &nbsp;with &nbsp;long &nbsp;lines &nbsp;or &nbsp;line &nbsp;breaks, &nbsp;display &nbsp;linewrap
-&nbsp;(without &nbsp;line-breaks) &nbsp;is &nbsp;a &nbsp;convenient editor &nbsp;feature &nbsp;to &nbsp;have &nbsp;for &nbsp;sisu &nbsp;markup]
-
+&nbsp;(without &nbsp;line-breaks) &nbsp;is &nbsp;a &nbsp;convenient
<p>
-<h2><a name='sect120' href='#toc120'>32. How Does Sisu Work?</a></h2>
+<h2><a name='sect122' href='#toc122'>31. How Does Sisu Work?</a></h2>
<br>
<p> <br>
@@ -3977,7 +3915,7 @@ layout, publishing, content certification, concordance etc.), and makes
it possible to take advantage of some of the strengths of established ways
of representing documents, (or indeed to create new ones).
<p>
-<h2><a name='sect121' href='#toc121'>33. Summary of
+<h2><a name='sect123' href='#toc123'>32. Summary of
Features</a></h2>
<br>
@@ -4122,11 +4060,11 @@ present. For example objects could be saved individually and identified
by their hashes, with an index of how the objects relate to each other
to form a document.
<p>
-<h2><a name='sect122' href='#toc122'>34. Help Sources</a></h2>
+<h2><a name='sect124' href='#toc124'>33. Help Sources</a></h2>
<br>
<p>
-<h2><a name='sect123' href='#toc123'>34.1 Man Pages</a></h2>
+<h2><a name='sect125' href='#toc125'>33.1 Man Pages</a></h2>
<p> <br>
man sisu<br>
@@ -4183,14 +4121,14 @@ to form a document.
man sisu_webrick<br>
<p>
-<h2><a name='sect124' href='#toc124'>34.2 Sisu Generated Output - Links to HTML</a></h2>
+<h2><a name='sect126' href='#toc126'>33.2 Sisu Generated Output - Links to HTML</a></h2>
<p> <br>
Note <b>SiSU</b> documentation is prepared in <b>SiSU</b> and output is available in
multiple formats including amongst others html, pdf, odf and epub, which
may be also be accessed via the html pages[^29]
<p>
-<h2><a name='sect125' href='#toc125'>34.2.1 Www.sisudoc.org</a></h2>
+<h2><a name='sect127' href='#toc127'>33.2.1 Www.sisudoc.org</a></h2>
<p> <br>
&lt;<a href='http://sisudoc.org/sisu/sisu_manual/index.html'>http://sisudoc.org/sisu/sisu_manual/index.html</a>
@@ -4200,10 +4138,10 @@ may be also be accessed via the html pages[^29]
&gt;<br>
<p>
-<h2><a name='sect126' href='#toc126'>34.3 Man2html</a></h2>
+<h2><a name='sect128' href='#toc128'>33.3 Man2html</a></h2>
<p>
-<h2><a name='sect127' href='#toc127'>34.3.1 Locally Installed</a></h2>
+<h2><a name='sect129' href='#toc129'>33.3.1 Locally Installed</a></h2>
<p> <br>
@@ -4224,7 +4162,7 @@ may be also be accessed via the html pages[^29]
/usr/share/doc/sisu/html/sisu_webrick.1.html<br>
<p>
-<h2><a name='sect128' href='#toc128'>34.3.2 WWW.jus.uio.no/sisu</a></h2>
+<h2><a name='sect130' href='#toc130'>33.3.2 Www.jus.uio.no/Sisu</a></h2>
<p> <br>
&lt;<a href='http://www.jus.uio.no/sisu/man/sisu.1.html'>http://www.jus.uio.no/sisu/man/sisu.1.html</a>
@@ -4364,7 +4302,7 @@ while freely distributable are not freely changeable.
29. named index.html or more extensively through sisu_manifest.html <br>
<p>
-<h2><a name='sect129' href='#toc129'>See Also</a></h2>
+<h2><a name='sect131' href='#toc131'>See Also</a></h2>
<br>
<a href='http:~/bin/man2html?sisu:1'><i>sisu</i>(1)</a>
, <br>
@@ -4387,14 +4325,14 @@ while freely distributable are not freely changeable.
<a href='http:~/bin/man2html?sisu_vim:7'><i>sisu_vim</i>(7)</a>
<p>
-<h2><a name='sect130' href='#toc130'>Homepage</a></h2>
+<h2><a name='sect132' href='#toc132'>Homepage</a></h2>
<br>
More information about <b>SiSU</b> can be found at &lt;<a href='http://www.sisudoc.org/'><i>http://www.sisudoc.org/</i></a>
&gt; or &lt;<a href='http://www.jus.uio.no/sisu/'><i>http://www.jus.uio.no/sisu/</i></a>
&gt;.
<p>
-<h2><a name='sect131' href='#toc131'>Author</a></h2>
+<h2><a name='sect133' href='#toc133'>Author</a></h2>
<b>SiSU</b> is written by Ralph Amissah &lt;<i>ralph@amissah.com</i>&gt;. <p>
<hr><p>
@@ -4438,100 +4376,102 @@ More information about <b>SiSU</b> can be found at &lt;<a href='http://www.sisud
<li><a name='toc35' href='#sect35'>9.6.2 Poem</a></li>
<li><a name='toc36' href='#sect36'>9.6.3 Group</a></li>
<li><a name='toc37' href='#sect37'>9.6.4 Code</a></li>
-<li><a name='toc38' href='#sect38'>9.7 Book Index</a></li>
-<li><a name='toc39' href='#sect39'>10. Composite Documents Markup</a></li>
-<li><a name='toc40' href='#sect40'>Markup Syntax History</a></li>
-<li><a name='toc41' href='#sect41'>11. Notes Related to Files-types and Markup Syntax</a></li>
-<li><a name='toc42' href='#sect42'>12. Sisu Filetypes</a></li>
-<li><a name='toc43' href='#sect43'>12.1 .sst .ssm .ssi Marked Up Plain Text</a></li>
-<li><a name='toc44' href='#sect44'>12.1.1 Sisu Text - Regular Files (.sst)</a></li>
-<li><a name='toc45' href='#sect45'>12.1.2 Sisu Master Files (.ssm)</a></li>
-<li><a name='toc46' href='#sect46'>12.1.3 Sisu Insert Files (.ssi)</a></li>
-<li><a name='toc47' href='#sect47'>12.2 Sisupod, Zipped Binary Container (sisupod.zip, .ssp)</a></li>
-<li><a name='toc48' href='#sect48'>13. Experimental Alternative Input Representations</a></li>
-<li><a name='toc49' href='#sect49'>13.1 Alternative Xml</a></li>
-<li><a name='toc50' href='#sect50'>13.1.1 Xml Sax Representation</a></li>
-<li><a name='toc51' href='#sect51'>13.1.2 Xml Dom Representation</a></li>
-<li><a name='toc52' href='#sect52'>13.1.3 Xml Node Representation</a></li>
-<li><a name='toc53' href='#sect53'>14. Configuration</a></li>
-<li><a name='toc54' href='#sect54'>14.1 Determining the Current Configuration</a></li>
-<li><a name='toc55' href='#sect55'>14.2 Configuration Files (config.yml)</a></li>
-<li><a name='toc56' href='#sect56'>15. Skins</a></li>
-<li><a name='toc57' href='#sect57'>15.1 Document Skin</a></li>
-<li><a name='toc58' href='#sect58'>15.2 Directory Skin</a></li>
-<li><a name='toc59' href='#sect59'>15.3 Site Skin</a></li>
-<li><a name='toc60' href='#sect60'>15.4 Sample Skins</a></li>
-<li><a name='toc61' href='#sect61'>16. Css - Cascading Style Sheets (for Html, Xhtml and Xml)</a></li>
-<li><a name='toc62' href='#sect62'>17. Organising Content</a></li>
-<li><a name='toc63' href='#sect63'>17.1 Directory Structure and Mapping</a></li>
-<li><a name='toc64' href='#sect64'>18. Homepages</a></li>
-<li><a name='toc65' href='#sect65'>18.1 Home Page and Other Custom Built Pages in a Sub-directory</a></li>
-<li><a name='toc66' href='#sect66'>18.2 Home Page Within a Skin</a></li>
-<li><a name='toc67' href='#sect67'>19. Markup and Output Examples</a></li>
-<li><a name='toc68' href='#sect68'>19.1 Markup Examples</a></li>
-<li><a name='toc69' href='#sect69'>20. Sisu Search - Introduction</a></li>
-<li><a name='toc70' href='#sect70'>21. Sql</a></li>
-<li><a name='toc71' href='#sect71'>21.1 Populating Sql Type Databases</a></li>
-<li><a name='toc72' href='#sect72'>22. Postgresql</a></li>
-<li><a name='toc73' href='#sect73'>22.1 Name</a></li>
-<li><a name='toc74' href='#sect74'>22.2 Description</a></li>
-<li><a name='toc75' href='#sect75'>22.3 Synopsis</a></li>
-<li><a name='toc76' href='#sect76'>22.4 Commands</a></li>
-<li><a name='toc77' href='#sect77'>22.4.1 Create and Destroy Database</a></li>
-<li><a name='toc78' href='#sect78'>22.4.2 Import and Remove Documents</a></li>
-<li><a name='toc79' href='#sect79'>23. Sqlite</a></li>
-<li><a name='toc80' href='#sect80'>23.1 Name</a></li>
-<li><a name='toc81' href='#sect81'>23.2 Description</a></li>
-<li><a name='toc82' href='#sect82'>23.3 Synopsis</a></li>
-<li><a name='toc83' href='#sect83'>23.4 Commands</a></li>
-<li><a name='toc84' href='#sect84'>23.4.1 Create and Destroy Database</a></li>
-<li><a name='toc85' href='#sect85'>23.4.2 Import and Remove Documents</a></li>
-<li><a name='toc86' href='#sect86'>24. Introduction</a></li>
-<li><a name='toc87' href='#sect87'>24.1 Search - Database Frontend Sample, Utilising Database and Sisu Features,</a></li>
-<li><a name='toc88' href='#sect88'>24.2 Search Form</a></li>
-<li><a name='toc89' href='#sect89'>25. Hyperestraier</a></li>
-<li><a name='toc90' href='#sect90'>26. Sisu_webrick</a></li>
-<li><a name='toc91' href='#sect91'>26.1 Name</a></li>
-<li><a name='toc92' href='#sect92'>26.2 Synopsis</a></li>
-<li><a name='toc93' href='#sect93'>26.3 Description</a></li>
-<li><a name='toc94' href='#sect94'>26.4 Summary of Man Page</a></li>
-<li><a name='toc95' href='#sect95'>26.5 Document Processing Command Flags</a></li>
-<li><a name='toc96' href='#sect96'>26.6 Further Information</a></li>
-<li><a name='toc97' href='#sect97'>26.7 Author</a></li>
-<li><a name='toc98' href='#sect98'>26.8 See Also</a></li>
-<li><a name='toc99' href='#sect99'>27. Remote Source Documents</a></li>
-<li><a name='toc100' href='#sect100'>Remote Document Output</a></li>
-<li><a name='toc101' href='#sect101'>28. Remote Output</a></li>
-<li><a name='toc102' href='#sect102'>28.1 Commands</a></li>
-<li><a name='toc103' href='#sect103'>28.2 Configuration</a></li>
-<li><a name='toc104' href='#sect104'>29. Remote Servers</a></li>
-<li><a name='toc105' href='#sect105'>30. Quickstart - Getting Started Howto</a></li>
-<li><a name='toc106' href='#sect106'>30.1 Installation</a></li>
-<li><a name='toc107' href='#sect107'>30.1.1 Debian Installation</a></li>
-<li><a name='toc108' href='#sect108'>30.1.2 Rpm Installation</a></li>
-<li><a name='toc109' href='#sect109'>30.1.3 Installation from Source</a></li>
-<li><a name='toc110' href='#sect110'>30.2 Testing Sisu, Generating Output</a></li>
-<li><a name='toc111' href='#sect111'>30.2.1 Basic Text, Plaintext, Html, Xml, Odf, Epub</a></li>
-<li><a name='toc112' href='#sect112'>30.2.2 LaTeX / Pdf</a></li>
-<li><a name='toc113' href='#sect113'>30.2.3 Relational Database - Postgresql, Sqlite</a></li>
-<li><a name='toc114' href='#sect114'>30.3 Getting Help</a></li>
-<li><a name='toc115' href='#sect115'>30.3.1 the Man Pages</a></li>
-<li><a name='toc116' href='#sect116'>30.3.2 Built in Help</a></li>
-<li><a name='toc117' href='#sect117'>30.3.3 the Home Page</a></li>
-<li><a name='toc118' href='#sect118'>30.4 Markup Samples</a></li>
-<li><a name='toc119' href='#sect119'>31. Editor Files, Syntax Highlighting</a></li>
-<li><a name='toc120' href='#sect120'>32. How Does Sisu Work?</a></li>
-<li><a name='toc121' href='#sect121'>33. Summary of Features</a></li>
-<li><a name='toc122' href='#sect122'>34. Help Sources</a></li>
-<li><a name='toc123' href='#sect123'>34.1 Man Pages</a></li>
-<li><a name='toc124' href='#sect124'>34.2 Sisu Generated Output - Links to HTML</a></li>
-<li><a name='toc125' href='#sect125'>34.2.1 Www.sisudoc.org</a></li>
-<li><a name='toc126' href='#sect126'>34.3 Man2html</a></li>
-<li><a name='toc127' href='#sect127'>34.3.1 Locally Installed</a></li>
-<li><a name='toc128' href='#sect128'>34.3.2 WWW.jus.uio.no/sisu</a></li>
-<li><a name='toc129' href='#sect129'>See Also</a></li>
-<li><a name='toc130' href='#sect130'>Homepage</a></li>
-<li><a name='toc131' href='#sect131'>Author</a></li>
+<li><a name='toc38' href='#sect38'>9.7 Additional Breaks - Linebreaks Within Objects, Column and Page-breaks</a></li>
+<li><a name='toc39' href='#sect39'>9.7.1 Line-breaks</a></li>
+<li><a name='toc40' href='#sect40'>9.7.2 Page Breaks</a></li>
+<li><a name='toc41' href='#sect41'>9.8 Book Index</a></li>
+<li><a name='toc42' href='#sect42'>10. Composite Documents Markup</a></li>
+<li><a name='toc43' href='#sect43'>Markup Syntax History</a></li>
+<li><a name='toc44' href='#sect44'>11. Notes Related to Files-types and Markup Syntax</a></li>
+<li><a name='toc45' href='#sect45'>12. Sisu Filetypes</a></li>
+<li><a name='toc46' href='#sect46'>12.1 .sst .ssm .ssi Marked Up Plain Text</a></li>
+<li><a name='toc47' href='#sect47'>12.1.1 Sisu Text - Regular Files (.sst)</a></li>
+<li><a name='toc48' href='#sect48'>12.1.2 Sisu Master Files (.ssm)</a></li>
+<li><a name='toc49' href='#sect49'>12.1.3 Sisu Insert Files (.ssi)</a></li>
+<li><a name='toc50' href='#sect50'>12.2 Sisupod, Zipped Binary Container (sisupod.zip, .ssp)</a></li>
+<li><a name='toc51' href='#sect51'>13. Experimental Alternative Input Representations</a></li>
+<li><a name='toc52' href='#sect52'>13.1 Alternative Xml</a></li>
+<li><a name='toc53' href='#sect53'>13.1.1 Xml Sax Representation</a></li>
+<li><a name='toc54' href='#sect54'>13.1.2 Xml Dom Representation</a></li>
+<li><a name='toc55' href='#sect55'>13.1.3 Xml Node Representation</a></li>
+<li><a name='toc56' href='#sect56'>14. Configuration</a></li>
+<li><a name='toc57' href='#sect57'>14.1 Determining the Current Configuration</a></li>
+<li><a name='toc58' href='#sect58'>14.2 Configuration Files (config.yml)</a></li>
+<li><a name='toc59' href='#sect59'>15. Skins</a></li>
+<li><a name='toc60' href='#sect60'>15.1 Document Skin</a></li>
+<li><a name='toc61' href='#sect61'>15.2 Directory Skin</a></li>
+<li><a name='toc62' href='#sect62'>15.3 Site Skin</a></li>
+<li><a name='toc63' href='#sect63'>15.4 Sample Skins</a></li>
+<li><a name='toc64' href='#sect64'>16. Css - Cascading Style Sheets (for Html, Xhtml and Xml)</a></li>
+<li><a name='toc65' href='#sect65'>17. Organising Content</a></li>
+<li><a name='toc66' href='#sect66'>17.1 Directory Structure and Mapping</a></li>
+<li><a name='toc67' href='#sect67'>18. Homepages</a></li>
+<li><a name='toc68' href='#sect68'>18.1 Home Page and Other Custom Built Pages in a Sub-directory</a></li>
+<li><a name='toc69' href='#sect69'>18.2 Home Page Within a Skin</a></li>
+<li><a name='toc70' href='#sect70'>19. Markup and Output Examples</a></li>
+<li><a name='toc71' href='#sect71'>19.1 Markup Examples</a></li>
+<li><a name='toc72' href='#sect72'>20. Sisu Search - Introduction</a></li>
+<li><a name='toc73' href='#sect73'>21. Sql</a></li>
+<li><a name='toc74' href='#sect74'>21.1 Populating Sql Type Databases</a></li>
+<li><a name='toc75' href='#sect75'>22. Postgresql</a></li>
+<li><a name='toc76' href='#sect76'>22.1 Name</a></li>
+<li><a name='toc77' href='#sect77'>22.2 Description</a></li>
+<li><a name='toc78' href='#sect78'>22.3 Synopsis</a></li>
+<li><a name='toc79' href='#sect79'>22.4 Commands</a></li>
+<li><a name='toc80' href='#sect80'>22.4.1 Create and Destroy Database</a></li>
+<li><a name='toc81' href='#sect81'>22.4.2 Import and Remove Documents</a></li>
+<li><a name='toc82' href='#sect82'>23. Sqlite</a></li>
+<li><a name='toc83' href='#sect83'>23.1 Name</a></li>
+<li><a name='toc84' href='#sect84'>23.2 Description</a></li>
+<li><a name='toc85' href='#sect85'>23.3 Synopsis</a></li>
+<li><a name='toc86' href='#sect86'>23.4 Commands</a></li>
+<li><a name='toc87' href='#sect87'>23.4.1 Create and Destroy Database</a></li>
+<li><a name='toc88' href='#sect88'>23.4.2 Import and Remove Documents</a></li>
+<li><a name='toc89' href='#sect89'>24. Introduction</a></li>
+<li><a name='toc90' href='#sect90'>24.1 Search - Database Frontend Sample, Utilising Database and Sisu Features,</a></li>
+<li><a name='toc91' href='#sect91'>24.2 Search Form</a></li>
+<li><a name='toc92' href='#sect92'>25. Sisu_webrick</a></li>
+<li><a name='toc93' href='#sect93'>25.1 Name</a></li>
+<li><a name='toc94' href='#sect94'>25.2 Synopsis</a></li>
+<li><a name='toc95' href='#sect95'>25.3 Description</a></li>
+<li><a name='toc96' href='#sect96'>25.4 Summary of Man Page</a></li>
+<li><a name='toc97' href='#sect97'>25.5 Document Processing Command Flags</a></li>
+<li><a name='toc98' href='#sect98'>25.6 Further Information</a></li>
+<li><a name='toc99' href='#sect99'>25.7 Author</a></li>
+<li><a name='toc100' href='#sect100'>25.8 See Also</a></li>
+<li><a name='toc101' href='#sect101'>26. Remote Source Documents</a></li>
+<li><a name='toc102' href='#sect102'>Remote Document Output</a></li>
+<li><a name='toc103' href='#sect103'>27. Remote Output</a></li>
+<li><a name='toc104' href='#sect104'>27.1 Commands</a></li>
+<li><a name='toc105' href='#sect105'>27.2 Configuration</a></li>
+<li><a name='toc106' href='#sect106'>28. Remote Servers</a></li>
+<li><a name='toc107' href='#sect107'>29. Quickstart - Getting Started Howto</a></li>
+<li><a name='toc108' href='#sect108'>29.1 Installation</a></li>
+<li><a name='toc109' href='#sect109'>29.1.1 Debian Installation</a></li>
+<li><a name='toc110' href='#sect110'>29.1.2 Rpm Installation</a></li>
+<li><a name='toc111' href='#sect111'>29.1.3 Installation from Source</a></li>
+<li><a name='toc112' href='#sect112'>29.2 Testing Sisu, Generating Output</a></li>
+<li><a name='toc113' href='#sect113'>29.2.1 Basic Text, Plaintext, Html, Xml, Odf, Epub</a></li>
+<li><a name='toc114' href='#sect114'>29.2.2 LaTeX / Pdf</a></li>
+<li><a name='toc115' href='#sect115'>29.2.3 Relational Database - Postgresql, Sqlite</a></li>
+<li><a name='toc116' href='#sect116'>29.3 Getting Help</a></li>
+<li><a name='toc117' href='#sect117'>29.3.1 the Man Pages</a></li>
+<li><a name='toc118' href='#sect118'>29.3.2 Built in Help</a></li>
+<li><a name='toc119' href='#sect119'>29.3.3 the Home Page</a></li>
+<li><a name='toc120' href='#sect120'>29.4 Markup Samples</a></li>
+<li><a name='toc121' href='#sect121'>30. Editor Files, Syntax Highlighting</a></li>
+<li><a name='toc122' href='#sect122'>31. How Does Sisu Work?</a></li>
+<li><a name='toc123' href='#sect123'>32. Summary of Features</a></li>
+<li><a name='toc124' href='#sect124'>33. Help Sources</a></li>
+<li><a name='toc125' href='#sect125'>33.1 Man Pages</a></li>
+<li><a name='toc126' href='#sect126'>33.2 Sisu Generated Output - Links to HTML</a></li>
+<li><a name='toc127' href='#sect127'>33.2.1 Www.sisudoc.org</a></li>
+<li><a name='toc128' href='#sect128'>33.3 Man2html</a></li>
+<li><a name='toc129' href='#sect129'>33.3.1 Locally Installed</a></li>
+<li><a name='toc130' href='#sect130'>33.3.2 Www.jus.uio.no/Sisu</a></li>
+<li><a name='toc131' href='#sect131'>See Also</a></li>
+<li><a name='toc132' href='#sect132'>Homepage</a></li>
+<li><a name='toc133' href='#sect133'>Author</a></li>
</ul>
</body>
</html>
diff --git a/data/doc/sisu/markup-samples/sisu_manual/sisu.ssm b/data/doc/sisu/markup-samples/sisu_manual/sisu.ssm
index c26aeabd..89d8556a 100644
--- a/data/doc/sisu/markup-samples/sisu_manual/sisu.ssm
+++ b/data/doc/sisu/markup-samples/sisu_manual/sisu.ssm
@@ -86,8 +86,6 @@
<< sisu_search_cgi.ssi
-<< sisu_hyperestraier.ssi
-
<< sisu_webrick.sst
<< sisu_remote.sst
diff --git a/data/doc/sisu/markup-samples/sisu_manual/sisu_commands.sst b/data/doc/sisu/markup-samples/sisu_manual/sisu_commands.sst
index 36e1bb9c..a5f380a9 100644
--- a/data/doc/sisu/markup-samples/sisu_manual/sisu_commands.sst
+++ b/data/doc/sisu/markup-samples/sisu_manual/sisu_commands.sst
@@ -208,7 +208,7 @@ see --rsync
see --scp
!_ --sample-search-form [--webserv=webrick] <br>
-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. Alias -F
+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). Alias -F
!_ --scp [filename/wildcard] <br>
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 --rsync. Alias -r
diff --git a/data/doc/sisu/markup-samples/sisu_manual/sisu_markup.sst b/data/doc/sisu/markup-samples/sisu_manual/sisu_markup.sst
index 65dc4e91..a246d160 100644
--- a/data/doc/sisu/markup-samples/sisu_manual/sisu_markup.sst
+++ b/data/doc/sisu/markup-samples/sisu_manual/sisu_markup.sst
@@ -1108,6 +1108,45 @@ code{#
}code
+2~ Additional breaks - linebreaks within objects, column and page-breaks
+
+3~ line-breaks
+
+To break a line within a "paragraph object", two backslashes \\\\ \\ with a space before and a space or newline after them \\ may be used.
+
+code{
+
+To break a line within a "paragraph object",
+two backslashes \\ with a space before
+and a space or newline after them \\
+may be used.
+
+}code
+
+The html break br enclosed in angle brackets (though undocumented) is available in versions prior to 3.0.13 and 2.9.7 (it remains available for the time being, but is depreciated).
+
+3~ page breaks
+
+Page breaks are only relevant and honored in some output formats. A page break or a new page may be inserted manually using the following markup on a line on its own:
+
+code{
+
+<:pb>
+
+}code
+
+or
+
+code{
+
+<:pn>
+
+}code
+
+page new <:pn> breaks the page, starts a new page.
+
+page break <:pb> breaks a column, starts a new column, if using columns, else breaks the page, starts a new page.
+
2~ Book index
To make an index append to paragraph the book index term relates to it, using an equal sign and curly braces.
diff --git a/man/man1/sisu.1 b/man/man1/sisu.1
index c152d5eb..2994ef64 100644
--- a/man/man1/sisu.1
+++ b/man/man1/sisu.1
@@ -1,4 +1,4 @@
-.TH "sisu" "1" "2011\-04\-17" "3.0.7\-beta\-rb1.9.2p180" "SiSU"
+.TH "sisu" "1" "2011-06-24" "3.0.13-beta-rb1.9.2p180" "SiSU"
.br
.SH NAME
.br
@@ -174,8 +174,7 @@ system to reliably reference its documents.
works well in a complementary manner with such collaborative technologies as
Wikis, which can take advantage of and be used to discuss the substance of
content prepared in
-.B SiSU
-.
+.B SiSU.
.br
<http://www.sisudoc.org/>
@@ -1266,12 +1265,9 @@ normally be marked 1.1.1 or 1.1.2 or 1.2.1 or 2.1.1 etc. in a document
.br
normal text,
-.B emphasis
-,
-.B bold text
-,
-.I italics
-,
+.B emphasis,
+.B bold text,
+.I italics,
.I underscore
, "citation", ^superscript^, [subscript], ++inserted text++,
\-\-strikethrough\-\-, monospace
@@ -2098,7 +2094,53 @@ tag code{# as demonstrated here:
44 | death."'
.fi
-.SH 9.7 BOOK INDEX
+.SH 9.7 ADDITIONAL BREAKS \- LINEBREAKS WITHIN OBJECTS, COLUMN AND PAGE\-BREAKS
+
+.SH 9.7.1 LINE\-BREAKS
+
+.br
+To break a line within a "paragraph object", two backslashes \e\e
+with a space before and a space or newline after them
+may be used.
+
+.nf
+ To break a line within a "paragraph object",
+ two backslashes \e\e with a space before
+ and a space or newline after them \e\e
+ may be used.
+.fi
+
+.br
+The html break br enclosed in angle brackets (though undocumented) is available
+in versions prior to 3.0.13 and 2.9.7 (it remains available for the time being,
+but is depreciated).
+
+.SH 9.7.2 PAGE BREAKS
+
+.br
+Page breaks are only relevant and honored in some output formats. A page break
+or a new page may be inserted manually using the following markup on a line on
+its own:
+
+.nf
+ <:pb>
+.fi
+
+.br
+or
+
+.nf
+ <:pn>
+.fi
+
+.br
+page new <:pn> breaks the page, starts a new page.
+
+.br
+page break <:pb> breaks a column, starts a new column, if using columns, else
+breaks the page, starts a new page.
+
+.SH 9.8 BOOK INDEX
.br
To make an index append to paragraph the book index term relates to it, using
@@ -2945,8 +2987,8 @@ appearance.
.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.
+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
@@ -3357,125 +3399,16 @@ installed
The generated search form must be copied manually to the webserver directory as
instructed
-.SH 25. HYPERESTRAIER
-.br
-
-.br
-See the documentation for hyperestraier:
-
-.br
- <http://hyperestraier.sourceforge.net/>
-
-.br
- /usr/share/doc/hyperestraier/index.html
-
-.br
- man estcmd
-
-.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
-
+.SH 25. SISU_WEBRICK
.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 26. SISU_WEBRICK
-.br
-
-.SH 26.1 NAME
+.SH 25.1 NAME
.br
.B SiSU
\- Structured information, Serialized Units \- a document publishing system
-.SH 26.2 SYNOPSIS
+.SH 25.2 SYNOPSIS
.br
sisu_webrick [port]
@@ -3486,7 +3419,7 @@ or
.br
sisu \-W [port]
-.SH 26.3 DESCRIPTION
+.SH 25.3 DESCRIPTION
.br
sisu_webrick is part of
@@ -3504,7 +3437,7 @@ The default port for sisu_webrick is set to 8081, this may be modified in the
yaml file: ~/.sisu/sisurc.yml a sample of which is provided as
/etc/sisu/sisurc.yml (or in the equivalent directory on your system).
-.SH 26.4 SUMMARY OF MAN PAGE
+.SH 25.4 SUMMARY OF MAN PAGE
.br
sisu_webrick, may be started on it's own with the command: sisu_webrick [port]
@@ -3513,7 +3446,7 @@ or using the sisu command with the \-W flag: sisu \-W [port]
.br
where no port is given and settings are unchanged the default port is 8081
-.SH 26.5 DOCUMENT PROCESSING COMMAND FLAGS
+.SH 25.5 DOCUMENT PROCESSING COMMAND FLAGS
.br
sisu \-W [port] starts
@@ -3523,7 +3456,7 @@ Webrick web\-server, serving
output directories, on the port provided, or if no port is provided and the
defaults have not been changed in ~/.sisu/sisurc.yaml then on port 8081
-.SH 26.6 FURTHER INFORMATION
+.SH 25.6 FURTHER INFORMATION
.br
For more information on
@@ -3533,12 +3466,12 @@ see: <http://www.sisudoc.org/> or <http://www.jus.uio.no/sisu>
.br
or man sisu
-.SH 26.7 AUTHOR
+.SH 25.7 AUTHOR
.br
Ralph Amissah <ralph@amissah.com> or <ralph.amissah@gmail.com>
-.SH 26.8 SEE ALSO
+.SH 25.8 SEE ALSO
.br
sisu(1)
@@ -3546,7 +3479,7 @@ Ralph Amissah <ralph@amissah.com> or <ralph.amissah@gmail.com>
.br
sisu_vim(7)
-.SH 27. REMOTE SOURCE DOCUMENTS
+.SH 26. REMOTE SOURCE DOCUMENTS
.br
.br
@@ -3607,7 +3540,7 @@ desired document.
.SH REMOTE DOCUMENT OUTPUT
.br
-.SH 28. REMOTE OUTPUT
+.SH 27. REMOTE OUTPUT
.br
.br
@@ -3626,7 +3559,7 @@ be used in conjunction with other processing flags, e.g.
sisu \-3R sisu_remote.sst
.fi
-.SH 28.1 COMMANDS
+.SH 27.1 COMMANDS
.TP
.B \-R [filename/wildcard]
@@ -3643,12 +3576,12 @@ 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 28.2 CONFIGURATION
+.SH 27.2 CONFIGURATION
.br
[expand \ on \ the \ setting \ up \ of \ an \ ssh\-agent \ / \ keychain]
-.SH 29. REMOTE SERVERS
+.SH 28. REMOTE SERVERS
.br
.br
@@ -3661,10 +3594,10 @@ 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 30. QUICKSTART \- GETTING STARTED HOWTO
+.SH 29. QUICKSTART \- GETTING STARTED HOWTO
.br
-.SH 30.1 INSTALLATION
+.SH 29.1 INSTALLATION
.br
Installation is currently most straightforward and tested on the
@@ -3672,7 +3605,7 @@ Installation is currently most straightforward and tested on the
platform, as there are packages for the installation of sisu and all
requirements for what it does.
-.SH 30.1.1 DEBIAN INSTALLATION
+.SH 29.1.1 DEBIAN INSTALLATION
.br
.B SiSU
@@ -3736,7 +3669,7 @@ 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 30.1.2 RPM INSTALLATION
+.SH 29.1.2 RPM INSTALLATION
.br
RPMs are provided though untested, they are prepared by running alien against
@@ -3754,7 +3687,7 @@ as root type:
.br
rpm \-i [rpm \ package \ name]
-.SH 30.1.3 INSTALLATION FROM SOURCE
+.SH 29.1.3 INSTALLATION FROM SOURCE
.br
To install
@@ -3779,8 +3712,8 @@ first steps are the same, download and unpack the source file:
For basic use
.B SiSU
is only dependent on the programming language in which it is written
-.B Ruby
-, and
+.B Ruby,
+and
.B SiSU
will be able to generate html, EPUB, various XMLs, including ODF (and will
also produce LaTeX). Dependencies required for further actions, though it
@@ -3861,7 +3794,7 @@ For a list of alternative actions you may type:
.br
ruby install \-T
-.SH 30.2 TESTING SISU, GENERATING OUTPUT
+.SH 29.2 TESTING SISU, GENERATING OUTPUT
.br
To check which version of sisu is installed:
@@ -3888,7 +3821,7 @@ change directory to the appropriate one:
.br
cd /usr/share/doc/sisu/markup\-samples/samples
-.SH 30.2.1 BASIC TEXT, PLAINTEXT, HTML, XML, ODF, EPUB
+.SH 29.2.1 BASIC TEXT, PLAINTEXT, HTML, XML, ODF, EPUB
.br
Having moved to the directory that contains the markup samples (see
@@ -3901,7 +3834,7 @@ sisu \-NhwoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst
this will generate html including a concordance file, opendocument text format,
plaintext, XHTML and various forms of XML, and OpenDocument text
-.SH 30.2.2 LATEX / PDF
+.SH 29.2.2 LATEX / PDF
.br
Assuming a LaTeX engine such as tetex or texlive is installed with the required
@@ -3924,7 +3857,7 @@ 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 30.2.3 RELATIONAL DATABASE \- POSTGRESQL, SQLITE
+.SH 29.2.3 RELATIONAL DATABASE \- POSTGRESQL, SQLITE
.br
Relational databases need some setting up \- you must have permission to create
@@ -3947,9 +3880,9 @@ sisu \-\-pgsql \-\-recreate
sisu \-\-pgsql \-v \-\-import
free_as_in_freedom.rms_and_free_software.sam_williams.sst
-.SH 30.3 GETTING HELP
+.SH 29.3 GETTING HELP
-.SH 30.3.1 THE MAN PAGES
+.SH 29.3.1 THE MAN PAGES
.br
Type:
@@ -3970,7 +3903,7 @@ as within the package itself:
.br
* man directory <http://www.jus.uio.no/sisu/man> [^27]
-.SH 30.3.2 BUILT IN HELP
+.SH 29.3.2 BUILT IN HELP
.br
sisu \-\-help
@@ -3984,7 +3917,7 @@ sisu \-\-help \-\-commands
.br
sisu \-\-help \-\-markup
-.SH 30.3.3 THE HOME PAGE
+.SH 29.3.3 THE HOME PAGE
.br
<http://www.sisudoc.org/>
@@ -3995,7 +3928,7 @@ sisu \-\-help \-\-markup
.br
<http://www.jus.uio.no/sisu/SiSU>
-.SH 30.4 MARKUP SAMPLES
+.SH 29.4 MARKUP SAMPLES
.br
A number of markup samples (along with output) are available off:
@@ -4016,7 +3949,7 @@ they are available in non\-free[^28] 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 31. EDITOR FILES, SYNTAX HIGHLIGHTING
+.SH 30. EDITOR FILES, SYNTAX HIGHLIGHTING
.br
.br
@@ -4198,7 +4131,7 @@ NOTE:
but, \ display \ linewrap \ (without \ line\-breaks) \ is \ a \ convenient \
editor \ feature \ to \ have \ for \ sisu \ markup]
-.SH 32. HOW DOES SISU WORK?
+.SH 31. HOW DOES SISU WORK?
.br
.br
@@ -4222,7 +4155,7 @@ document layout, publishing, content certification, concordance etc.), and
makes it possible to take advantage of some of the strengths of established
ways of representing documents, (or indeed to create new ones).
-.SH 33. SUMMARY OF FEATURES
+.SH 32. SUMMARY OF FEATURES
.br
.br
@@ -4382,10 +4315,10 @@ present. For example objects could be saved individually and identified by
their hashes, with an index of how the objects relate to each other to form a
document.
-.SH 34. HELP SOURCES
+.SH 33. HELP SOURCES
.br
-.SH 34.1 MAN PAGES
+.SH 33.1 MAN PAGES
.br
man sisu
@@ -4441,7 +4374,7 @@ document.
.br
man sisu_webrick
-.SH 34.2 SISU GENERATED OUTPUT \- LINKS TO HTML
+.SH 33.2 SISU GENERATED OUTPUT \- LINKS TO HTML
.br
Note
@@ -4451,7 +4384,7 @@ documentation is prepared in
and output is available in multiple formats including amongst others html,
pdf, odf and epub, which may be also be accessed via the html pages[^29]
-.SH 34.2.1 WWW.SISUDOC.ORG
+.SH 33.2.1 WWW.SISUDOC.ORG
.br
<http://sisudoc.org/sisu/sisu_manual/index.html>
@@ -4459,9 +4392,9 @@ pdf, odf and epub, which may be also be accessed via the html pages[^29]
.br
<http://sisudoc.org/sisu/sisu_manual/index.html>
-.SH 34.3 MAN2HTML
+.SH 33.3 MAN2HTML
-.SH 34.3.1 LOCALLY INSTALLED
+.SH 33.3.1 LOCALLY INSTALLED
.br
file:///usr/share/doc/sisu/html/sisu.1.html
@@ -4481,7 +4414,7 @@ file:///usr/share/doc/sisu/html/sisu.1.html
.br
/usr/share/doc/sisu/html/sisu_webrick.1.html
-.SH 34.3.2 WWW.jus.uio.no/sisu
+.SH 33.3.2 WWW.JUS.UIO.NO/SISU
.br
<http://www.jus.uio.no/sisu/man/sisu.1.html>