From 3d67c3ba4610cbe83a45078219a3ac61648406ef Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Tue, 25 Sep 2007 03:09:22 +0100 Subject: documentation regenerated --- .../sisu_manual/sisu_manual/doc.html | 4602 ++++++++++---------- 1 file changed, 2325 insertions(+), 2277 deletions(-) (limited to 'data/doc/manuals_generated/sisu_manual/sisu_manual/doc.html') diff --git a/data/doc/manuals_generated/sisu_manual/sisu_manual/doc.html b/data/doc/manuals_generated/sisu_manual/sisu_manual/doc.html index 2aa81b23..cd983c21 100644 --- a/data/doc/manuals_generated/sisu_manual/sisu_manual/doc.html +++ b/data/doc/manuals_generated/sisu_manual/sisu_manual/doc.html @@ -22,7 +22,7 @@ - + @@ -784,472 +784,476 @@ 32. Remote Servers +

+ Download +

+

- 33. Download SiSU - Linux/Unix + 33. Download SiSU - Linux/Unix

- SiSU Current Version - Linux/Unix + SiSU Current Version - Linux/Unix
- Source (tarball tar.gz) + Source (tarball tar.gz)
- Git (source control management) + Git (source control management)
- Debian + Debian
- RPM + RPM

- Installation + Installation

- 34. Installation + 34. Installation

- 34.1 Debian + 34.1 Debian
- 34.2 Other Unix / Linux + 34.2 Other Unix / Linux
- 34.2.1 source tarball + 34.2.1 source tarball

- 35. SiSU Components, Dependencies and Notes + 35. SiSU Components, Dependencies and Notes

- 35.1 sisu + 35.1 sisu
- 35.2 sisu-complete + 35.2 sisu-complete
- 35.3 sisu-examples + 35.3 sisu-examples
- 35.4 sisu-pdf + 35.4 sisu-pdf
- 35.5 sisu-postgresql + 35.5 sisu-postgresql
- 35.6 sisu-remote + 35.6 sisu-remote
- 35.7 sisu-sqlite + 35.7 sisu-sqlite

- 36. Quickstart - Getting Started Howto + 36. Quickstart - Getting Started Howto

- 36.1 Installation + 36.1 Installation
- 36.1.1 Debian Installation + 36.1.1 Debian Installation
- 36.1.2 RPM Installation + 36.1.2 RPM Installation
- 36.1.3 Installation from source + 36.1.3 Installation from source
- 36.2 Testing SiSU, generating output + 36.2 Testing SiSU, generating output
- 36.2.1 basic text, plaintext, html, XML, ODF + 36.2.1 basic text, plaintext, html, XML, ODF
- 36.2.2 LaTeX / pdf + 36.2.2 LaTeX / pdf
- 36.2.3 relational database - postgresql, sqlite + 36.2.3 relational database - postgresql, sqlite
- 36.3 Getting Help + 36.3 Getting Help
- 36.3.1 The man pages + 36.3.1 The man pages
- 36.3.2 Built in help + 36.3.2 Built in help
- 36.3.3 The home page + 36.3.3 The home page
- 36.4 Markup Samples + 36.4 Markup Samples

- HowTo + HowTo

- 37. Getting Help + 37. Getting Help

- 37.1 SiSU "man" pages + 37.1 SiSU "man" pages
- 37.2 SiSU built-in help + 37.2 SiSU built-in help
- 37.3 Command Line with Flags - Batch Processing + 37.3 Command Line with Flags - Batch Processing

- 38. Setup, initialisation + 38. Setup, initialisation

- 38.1 initialise output directory + 38.1 initialise output directory
- 38.1.1 Use of search functionality, an example using sqlite + 38.1.1 Use of search functionality, an example using sqlite
- 38.2 misc + 38.2 misc
- 38.2.1 url for output files -u -U + 38.2.1 url for output files -u -U
- 38.2.2 toggle screen color + 38.2.2 toggle screen color
- 38.2.3 verbose mode + 38.2.3 verbose mode
- 38.2.4 quiet mode + 38.2.4 quiet mode
- 38.2.5 maintenance mode intermediate files kept -M + 38.2.5 maintenance mode intermediate files kept -M
- 38.2.6 start the webrick server + 38.2.6 start the webrick server
- 38.3 remote placement of output + 38.3 remote placement of output

- 39. Configuration Files + 39. Configuration Files

- 40. Markup + 40. Markup

- 40.1 Headers + 40.1 Headers
- 40.2 Font Face + 40.2 Font Face
- 40.2.1 Bold + 40.2.1 Bold
- 40.2.2 Italics + 40.2.2 Italics
- 40.2.3 Underscore + 40.2.3 Underscore
- 40.2.4 Strikethrough + 40.2.4 Strikethrough
- 40.3 Endnotes + 40.3 Endnotes
- 40.4 Links + 40.4 Links
- 40.5 Number Titles + 40.5 Number Titles
- 40.6 Line operations + 40.6 Line operations
- 40.7 Tables + 40.7 Tables
- 40.8 Grouped Text + 40.8 Grouped Text
- 40.9 Composite Document + 40.9 Composite Document

- 41. Change Appearance + 41. Change Appearance

- 41.1 Skins + 41.1 Skins
- 41.2 CSS + 41.2 CSS

- Extracts from the README + Extracts from the README

- 42. README + 42. README

- 42.1 Online Information, places to look + 42.1 Online Information, places to look
- 42.2 Installation + 42.2 Installation
- 42.2.1 Debian + 42.2.1 Debian
- 42.2.2 RPM + 42.2.2 RPM
- 42.2.3 Source package .tgz + 42.2.3 Source package .tgz
- 42.2.4 to use setup.rb + 42.2.4 to use setup.rb
- 42.2.5 to use install (prapared with "Rake") + 42.2.5 to use install (prapared with "Rake")
- 42.2.6 to use install (prapared with "Rant") + 42.2.6 to use install (prapared with "Rant")
- 42.3 Dependencies + 42.3 Dependencies
- 42.4 Quick start + 42.4 Quick start
- 42.5 Configuration files + 42.5 Configuration files
- 42.6 Use General Overview + 42.6 Use General Overview
- 42.7 Help + 42.7 Help
- 42.8 Directory Structure + 42.8 Directory Structure
- 42.9 Configuration File + 42.9 Configuration File
- 42.10 Markup + 42.10 Markup
- 42.11 Additional Things + 42.11 Additional Things
- 42.12 License + 42.12 License
- 42.13 SiSU Standard + 42.13 SiSU Standard

- Extracts from man 8 sisu + Extracts from man 8 sisu

- 43. Post Installation Setup + 43. Post Installation Setup

- 43.1 Post Installation Setup - Quick start + 43.1 Post Installation Setup - Quick start
- 43.2 Document markup directory + 43.2 Document markup directory
- 43.2.1 Configuration files + 43.2.1 Configuration files
- 43.2.2 Debian INSTALLATION Note + 43.2.2 Debian INSTALLATION Note
- 43.2.3 Document Resource Configuration + 43.2.3 Document Resource Configuration
- 43.2.4 Skins + 43.2.4 Skins

- 44. FAQ - Frequently Asked/Answered Questions + 44. FAQ - Frequently Asked/Answered Questions

- 44.1 Why are urls produced with the -v (and -u) flag that point to a web server on port 8081? + 44.1 Why are urls produced with the -v (and -u) flag that point to a web server on port 8081?
- 44.2 I cannot find my output, where is it? + 44.2 I cannot find my output, where is it?
- 44.3 I do not get any pdf output, why? + 44.3 I do not get any pdf output, why?
- 44.4 Where is the latex (or some other interim) output? + 44.4 Where is the latex (or some other interim) output?
- 44.5 Why isn't SiSU markup XML + 44.5 Why isn't SiSU markup XML
- 44.6 LaTeX claims to be a document preparation system for high-quality typesetting. Can the same be said about SiSU? + 44.6 LaTeX claims to be a document preparation system for high-quality typesetting. Can the same be said about SiSU?
- 44.7 How do I create GIN or GiST index in Postgresql for use in SiSU + 44.7 How do I create GIN or GiST index in Postgresql for use in SiSU
- 44.8 Where is version 1.0? + 44.8 Where is version 1.0?

- 45. Editor Files, Syntax Highlighting + 45. Editor Files, Syntax Highlighting

- 46. Help Sources + 46. Help Sources

- 46.1 man pages + 46.1 man pages
- 46.1.1 man + 46.1.1 man
- 46.2 sisu generated output - links to html + 46.2 sisu generated output - links to html
- 46.2.1 locally installed + 46.2.1 locally installed
- 46.2.2 www.sisudoc.org + 46.2.2 www.sisudoc.org
- 46.2.3 www.jus.uio.no/sisu + 46.2.3 www.jus.uio.no/sisu
- 46.2.4 man2html + 46.2.4 man2html
- 46.2.5 locally installed + 46.2.5 locally installed
- 46.2.6 www.sisudoc.org + 46.2.6 www.sisudoc.org
- 46.2.7 www.jus.uio.no/sisu + 46.2.7 www.jus.uio.no/sisu

@@ -16399,7 +16403,7 @@

- Ralph Amissah <<ralph@amissah.com>> or <<ralph.amissah@gmail.com>> + Ralph Amissah <ralph@amissah.com> or <ralph.amissah@gmail.com>

@@ -16788,363 +16792,377 @@ + +
-

+

+ + Download +

+

 +

+   1151 +

+
+ + +
+

33. Download SiSU - Linux/Unix

-   1151 +   1152

-
+
SiSU Current Version - Linux/Unix

-   1152 +   1153

-
+
Source (tarball tar.gz)

-   1153 +   1154

-

+

Download the latest version of SiSU (and SiSU markup samples):  65 

-   1154 +   1155

-
  • +
  • sisu_0.59.1.orig.tar.gz (of 2007-09-23:38/7)   66 

    • -   1155 +   1156

    -

    +

    cgi generated sample search form

    -   1156 +   1157

    -

    +

    order results on files of the same title, in multiple files (with different filenames)

    -   1157 +   1158

    -

    +

    postgresql, character case sensitivity, control, on/off

    -   1158 +   1159

    -

    +

    tail decoration, gplv3 & sisu info

    -   1159 +   1160

    -

    +

    texinfo/info (pinfo) module starts to do something vaguely useful again [not a much used module, testing required]

    -   1160 +   1161

    -

    +

    print XML rendition of document structure to screen -T

    -   1161 +   1162

    -

    +

    help on environment visited, sisu -V

    -   1162 +   1163

    -

    +

    sisurc.yml default, color set to true [apologies if this causes anyone any inconvenience, it is configurable in sisurc.yml]

    -   1163 +   1164

    -

    +

    help and man pages, some work man(8) related

    -   1164 +   1165

    -

    +

    sisu-install (install ruby rant script renamed) and permissions set to executable

    -   1165 +   1166

    -
  • +
  • sisu-markup-samples_1.0.8.orig.tar.gz (of 2007-08-19:33/7 )   67 

    • -   1166 +   1167

    -

    +

    For installation notes see <http://www.jus.uio.no/sisu/SiSU/download.html>

    -   1167 +   1168

    -

    +

    For changelogs see <http://www.jus.uio.no/sisu/SiSU/changelog.html>

    -   1168 +   1169

    -

    +


    Tulva, by Leena Krohn

      68 

    -   1169 +   1170

    -
    +
    Git (source control management)

    -   1170 +   1171

    -

    +

    Git repository currently at:

    -   1171 +   1172

    -
  • +
  • git clone git://sisudoc.org/git/sisu/

    • -   1172 +   1173

    -
  • +
  • <http://search.sisudoc.org/cgi-bin/gitweb.cgi?p=sisu;a=summary>

    • -   1173 +   1174

    -
    +
    Debian

    -   1174 +   1175

    -

    +

    This section contains information on the latest SiSU release. For installation notes see <http://www.jus.uio.no/sisu/sisu_download/installation.html>

    -   1175 +   1176

    -

    +

    SiSU is updated fairly regularly in Debian testing and unstable, and should be available therefrom.

    -   1176 +   1177

    -

    +

    To add this archive, should you still choose to do so, add the following lines to your /etc/apt/sources.list

    -   1177 +   1178

    -

    +

      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 @@ -17153,551 +17171,551 @@

    -   1178 +   1179

    -

    +

    Source

    -   1179 +   1180

    -
  • +
  • sisu_0.59.1.orig.tar.gz   69 

    • -   1180 +   1181

    -
  • +
  • sisu_0.59.1-1.diff.gz   70 

    • -   1181 +   1182

    -
  • +
  • sisu_0.59.1-1.dsc   71 

    • -   1182 +   1183

    -

    +

    Debs

    -   1183 +   1184

    -
  • +
  • sisu_0.59.1-1_all.deb   72 

    • -   1184 +   1185

    -
  • +
  • sisu-complete_0.59.1-1_all.deb   73 

    • -   1185 +   1186

    -
  • +
  • sisu-pdf_0.59.1-1_all.deb   74 

    • -   1186 +   1187

    -
  • +
  • sisu-postgresql_0.59.1-1_all.deb   75 

    • -   1187 +   1188

    -
  • +
  • sisu-sqlite_0.59.1-1_all.deb   76 

    • -   1188 +   1189

    -

    +

    For changelogs see:

    -   1189 +   1190

    -

    +

    <http://www.jus.uio.no/sisu/SiSU/changelog.html>

    -   1190 +   1191

    -

    +

    <http://www.jus.uio.no/sisu/sisu_changelog/changelog.html>

    -   1191 +   1192

    -

    +

    non-free

    -   1192 +   1193

    -

    +

    Book markup samples have been moved to non-free as the substantive text of the documents are available under the author or original publisher's license, and usually do not comply with the Debian Free Software Guidelines.

    -   1193 +   1194

    -
  • +
  • sisu-markup-samples_1.0.8-1_all.deb   77 

    • -   1194 +   1195

    -
  • +
  • sisu-markup-samples_1.0.8-1.dsc   78 

    • -   1195 +   1196

    -

    +

    For changelogs see:

    -   1196 +   1197

    -

    +

    <http://www.jus.uio.no/sisu/SiSU/changelog_markup_samples.html>

    -   1197 +   1198

    -

    +

    <http://www.jus.uio.no/sisu/sisu_markup_samples_changelog/changelog_markup_samples.html>

    -   1198 +   1199

    -
    +
    RPM

    -   1199 +   1200

    -

    +

    The RPM is generated Alien  79  from two deb packages (sisu and sisu-doc). Dependencies are not handled, not even that of the essential Ruby.

    -   1200 +   1201

    -
  • +
  • sisu-0.59.1-2.noarch.rpm   80 

    • -   1201 +   1202

    -
  • +
  • sisu-0.59.1-2.noarch.rpm   81 

    • -   1202 +   1203

    -
  • +
  • sisu-markup-samples_1.0.8.orig-2.noarch.rpm   82 

    • -   1203 +   1204

    -

    +

    sudo rpm -i [package name]

    -   1204 +   1205

    -

    +

    Installation

    -   1205 +   1206

    -

    +

    34. Installation

    -   1206 +   1207

    -

    +

    See the download pages   83  for information related to installation.

    -   1207 +   1208

    -
    +
    34.1 Debian

    -   1208 +   1209

    -

    +

    SiSU is developed on Debian, and packages are available for Debian that take care of the dependencies encountered on installation.

    -   1209 +   1210

    -

    +

    The package is divided into the following components:

    -   1210 +   1211

    -

    +

    sisu, the base code, (the main package on which the others depend), without any dependencies other than ruby (and for convenience the ruby webrick web server), this generates a number of types of output on its own, other packages provide additional functionality, and have their dependencies

    -   1211 +   1212

    -

    +

    sisu-complete, a dummy package that installs the whole of greater sisu as described below, apart from sisu-examples

    -   1212 +   1213

    -

    +

    sisu-pdf, dependencies used by sisu to produce pdf from LaTeX generated

    -   1213 +   1214

    -

    +

    sisu-postgresql, dependencies used by sisu to populate postgresql database (further configuration is necessary)

    -   1214 +   1215

    -

    +

    sisu-remote, dependencies used to place sisu output on a remote server (further configuration is necessary)

    -   1215 +   1216

    -

    +

    sisu-sqlite, dependencies used by sisu to populate sqlite database

    -   1216 +   1217

    -

    +

    sisu-markup-samples, sisu markup samples and other miscellany (under Debian Free Software Guidelines non-free)

    -   1217 +   1218

    -

    +

    SiSU is available off Debian Unstable and Testing   84  install it using apt-get, aptitude or alternative Debian install tools. SiSU is currently comprised of eight packages.

    -   1218 +   1219

    -

    +

    Initial packaging is done here and to get the latest version of SiSU available you may add the following line(s) to your sources list:

    -   1219 +   1220

    -

    +

      #/etc/apt/sources.list

      deb http://www.jus.uio.no/sisu/archive unstable main non-free
    @@ -17707,40 +17725,40 @@

    -   1220 +   1221

    -

    +

    The non-free section is for sisu markup samples provided, which contain authored works the substantive text of which cannot be changed, and which as a result do not meet the debian free software guidelines.

    -   1221 +   1222

    -

    +

    On Debian there is little more to know beyond how to install software on Debian using apt, aptitude or synaptic.

    -   1222 +   1223

    -

    +

      #Using aptitude:

        aptitude update

    @@ -17750,14 +17768,14 @@

    -   1223 +   1224

    -

    +

      Using apt-get

        apt-get update

    @@ -17767,1938 +17785,1938 @@

    -   1224 +   1225

    -
    +
    34.2 Other Unix / Linux

    -   1225 +   1226

    -

    +

    A source tarball or an rpms built using alien are available, (however dependencies have not been tested). SiSU is first packaged and tested with dependency handling for Debian.   85  Information on dependencies configured for Debian is provided as this may be of assistance.

    -   1226 +   1227

    -
    +
    34.2.1 source tarball

    -   1227 +   1228

    -

    +

    installation with provided install script

    -   1228 +   1229

    -

    +

    To install SiSU, in the root directory of the unpacked SiSU as root type:  86 

    -   1229 +   1230

    -

    +

    ruby install

    -   1230 +   1231

    -

    +

    Once installed see man 8 sisu for information on additional programs that sisu makes use of.

    -   1231 +   1232

    -

    +

    Further notes on install script.

    -   1232 +   1233

    -

    +

    The install script is prepared using Rant, and a Rantfile is provided,  87  with more comprehensive install options, and post install and setup configuration and generation of first test file, if you have installed Stefan Lang's Rant   88  installed. While in the package directory, type: rant help, or rant -T, or to install SiSU as root, type:

    -   1233 +   1234

    -

    +

    install is an install script prepared using Stefan Lang's Rant   89  It should work whether you have previously installed Rant or not. It has fairly comprehensive install options, and can do some post install and setup configuration and generation of first test file. For options type:

    -   1234 +   1235

    -

    +

    ruby install -T

    -   1235 +   1236

    -

    +

    To install as root type:

    -   1236 +   1237

    -

    +

    ruby install

    -   1237 +   1238

    -

    +

    For a minimal install type:

    -   1238 +   1239

    -

    +

    ruby install base

    -   1239 +   1240

    -

    +

    installation with setup.rb

    -   1240 +   1241

    -

    +

    setup.rb   90  is provided the package and will install SiSU  91  installation is a 3 step process  92  the following string assumes you are in the package directory and that you have root as sudo:

    -   1241 +   1242

    -

    +

    ruby setup.rb config && ruby setup.rb setup && sudo ruby setup.rb install

    -   1242 +   1243

    -

    +

    installation of rpm

    -   1243 +   1244

    -

    +

    The RPM is generated from the source file using Alien.  93  Dependencies are not handled, not even that of the essential Ruby.

    -   1244 +   1245

    -

    +

    35. SiSU Components, Dependencies and Notes

    -   1245 +   1246

    -

    +

    The dependency lists are from the Debian control file for SiSU version 0.36, and may assist in building SiSU on other distributions.

    -   1246 +   1247

    -
    +
    35.1 sisu

    -   1247 +   1248

    -
  • +
  • the base code, (the main package on which the others depend), without any dependencies other than ruby (and for convenience the ruby webrick web server), this generates a number of types of output on its own, other packages provide additional functionality, and have their dependencies

    • -   1248 +   1249

    -

    +

    Depends: on ruby (>=1.8.2), libwebrick-ruby

    -   1249 +   1250

    -

    +

    Recommends: sisu-pdf, sisu-sqlite, sisu-postgresql, sisu-examples, librmagick-ruby, trang, tidy, libtidy, librexml-ruby, zip, unzip, openssl

    -   1250 +   1251

    -

    +

    initialise directory

    -   1251 +   1252

    -

    +

    sisu -CC

    -   1252 +   1253

    -

    +

    html

    -   1253 +   1254

    -

    +

    sisu -hv [filename/wildcard]

    -   1254 +   1255

    -

    +

    sisu -Hv [filename/wildcard]

    -   1255 +   1256

    -

    +

    LaTeX (but sisu-pdf dependencies required to convert that to pdf)

    -   1256 +   1257

    -

    +

    sisu -pv [filename/wildcard]

    -   1257 +   1258

    -

    +

    plain text Unix with footnotes

    -   1258 +   1259

    -

    +

    sisu -av [filename/wildcard]

    -   1259 +   1260

    -

    +

    plain text Dos with footnotes

    -   1260 +   1261

    -

    +

    sisu -Av [filename/wildcard]

    -   1261 +   1262

    -

    +

    plain text Unix with endnotes

    -   1262 +   1263

    -

    +

    sisu -ev [filename/wildcard]

    -   1263 +   1264

    -

    +

    plain text Dos with endnotes

    -   1264 +   1265

    -

    +

    sisu -Ev [filename/wildcard]

    -   1265 +   1266

    -

    +

    openoffice odt

    -   1266 +   1267

    -

    +

    sisu -ov [filename/wildcard]

    -   1267 +   1268

    -

    +

    xhtml

    -   1268 +   1269

    -

    +

    sisu -bv [filename/wildcard]

    -   1269 +   1270

    -

    +

    XML SAX

    -   1270 +   1271

    -

    +

    sisu -xv [filename/wildcard]

    -   1271 +   1272

    -

    +

    XML DOM

    -   1272 +   1273

    -

    +

    sisu -Xv [filename/wildcard]

    -   1273 +   1274

    -

    +

    wordmap (a rudimentary index of content)

    -   1274 +   1275

    -

    +

    sisu -wv [filename/wildcard]

    -   1275 +   1276

    -

    +

    document content certificate

    -   1276 +   1277

    -

    +

    sisu -Nv [filename/wildcard]

    -   1277 +   1278

    -

    +

    placement of sourcefile in output directory

    -   1278 +   1279

    -

    +

    sisu -sv [filename/wildcard]

    -   1279 +   1280

    -

    +

    creation of source tarball with images, and placement of source tarball in ouput directory

    -   1280 +   1281

    -

    +

    sisu -Sv [filename/wildcard]

    -   1281 +   1282

    -

    +

    manifest of output produced (polls output directory and provides links to existing output)

    -   1282 +   1283

    -

    +

    sisu -yv [filename/wildcard]

    -   1283 +   1284

    -

    +

    url for output files -u -U

    -   1284 +   1285

    -

    +

    sisu -uv[and other flags] [filename/wildcard]

    -   1285 +   1286

    -

    +

    sisu -Uv [filename/wildcard]

    -   1286 +   1287

    -

    +

    toggle screen colour

    -   1287 +   1288

    -

    +

    sisu -cv[and processing flags] [filename/wildcard]

    -   1288 +   1289

    -

    +

    verbose mode

    -   1289 +   1290

    -

    +

    sisu -v[and processing flags] [filename/wildcard]

    -   1290 +   1291

    -

    +

    sisu -V[and processing flags] [filename/wildcard]

    -   1291 +   1292

    -

    +

    quiet mode

    -   1292 +   1293

    -

    +

    sisu -q[and processing flags] [filename/wildcard]

    -   1293 +   1294

    -

    +

    maintenance mode, intermediate files kept -M

    -   1294 +   1295

    -

    +

    sisu -Mv[and other flags] [filename/wildcard]

    -   1295 +   1296

    -

    +

    [the -v is for verbose]

    -   1296 +   1297

    -

    +

    start the webrick server

    -   1297 +   1298

    -

    +

    sisu -W

    -   1298 +   1299

    -
    +
    35.2 sisu-complete

    -   1299 +   1300

    -
  • +
  • a dummy package that installs the whole SiSU, apart from sisu-examples

    • -   1300 +   1301

    -

    +

    Depends: ruby (>=1.8.2), sisu, sisu-pdf, sisu-postgresql, sisu-remote, sisu-sqlite

    -   1301 +   1302

    -

    +

    Recommends: sisu-examples

    -   1302 +   1303

    -
    +
    35.3 sisu-examples

    -   1303 +   1304

    -
  • +
  • installs sisu markup samples and other miscelleny

    • -   1304 +   1305

    -

    +

    Depends: sisu

    -   1305 +   1306

    -
    +
    35.4 sisu-pdf

    -   1306 +   1307

    -
  • +
  • dependencies used by sisu to produce pdf from LaTeX generated

    • -   1307 +   1308

    -

    +

    Depends: sisu, tetex-bin, tetex-extra, latex-ucs

    -   1308 +   1309

    -

    +

    Suggests: evince, xpdf

    -   1309 +   1310

    -

    +

    converts sisu LaTeX produced to pdf

    -   1310 +   1311

    -

    +

    sisu -pv [filename/wildcard]

    -   1311 +   1312

    -

    +

    [the -v is for verbose]

    -   1312 +   1313

    -
    +
    35.5 sisu-postgresql

    -   1313 +   1314

    -
  • +
  • dependencies used by sisu to populate postgresql database (further configuration is necessary)

    • -   1314 +   1315

    -

    +

    Depends: sisu, postgresql-8.1, libdbi-ruby, libdbm-ruby, libdbd-pg-ruby

    -   1315 +   1316

    -

    +

    Suggests: pgaccess, libdbd-pgsql, postgresql-contrib-8.1

    -   1316 +   1317

    -

    +

    installs dependencies for sisu to work with and populate postgresql database

    -   1317 +   1318

    -

    +

    create database

    -   1318 +   1319

    -

    +

    sisu -Dv createall

    -   1319 +   1320

    -

    +

    drop database

    -   1320 +   1321

    -

    +

    sisu -Dv dropall

    -   1321 +   1322

    -

    +

    import content

    -   1322 +   1323

    -

    +

    sisu -Div [filename/wildcard]

    -   1323 +   1324

    -

    +

    sisu -Dv import [filename/wildcard]

    -   1324 +   1325

    -

    +

    update content

    -   1325 +   1326

    -

    +

    sisu -Duv [filename/wildcard]

    -   1326 +   1327

    -

    +

    sisu -Dv update [filename/wildcard]

    -   1327 +   1328

    -

    +

    [the -v is for verbose]

    -   1328 +   1329

    -

    +

    The following are available without installation of the sisu-postgresql component, but are of interest in this context

    -   1329 +   1330

    -

    +

    generate a sample database query form for use with webserver on port 80

    -   1330 +   1331

    -

    +

    sisu -F

    -   1331 +   1332

    -

    +

    or for use with webrick server

    -   1332 +   1333

    -

    +

    sisu -F webrick

    -   1333 +   1334

    -

    +

    to start webrick server

    -   1334 +   1335

    -

    +

    sisu -W

    -   1335 +   1336

    -
    +
    35.6 sisu-remote

    -   1336 +   1337

    -
  • +
  • dependencies used to place sisu output on a remote server (further configuration is necessary)

    • -   1337 +   1338

    -

    +

    scp

    -   1338 +   1339

    -

    +

    sisu -vr[and processing flags] [filename/wildcard]

    -   1339 +   1340

    -

    +

    rsync

    -   1340 +   1341

    -

    +

    sisu -vR[and processing flags] [filename/wildcard]

    -   1341 +   1342

    -

    +

    [the -v is for verbose]

    -   1342 +   1343

    -

    +

    Depends: sisu, rsync, openssh-client|lsh-client, keychain

    -   1343 +   1344

    -
    +
    35.7 sisu-sqlite

    -   1344 +   1345

    -
  • +
  • dependencies used by sisu to populate sqlite database

    • -   1345 +   1346

    -

    +

    Depends: sisu, sqlite, libdbi-ruby, libdbm-ruby, libdbd-sqlite-ruby

    -   1346 +   1347

    -

    +

    Suggests: libdbd-sqlite

    -   1347 +   1348

    -

    +

    installs dependencies for sisu to work with and populate sqlite database

    -   1348 +   1349

    -

    +

    create database

    -   1349 +   1350

    -

    +

    sisu -dv createall

    -   1350 +   1351

    -

    +

    drop database

    -   1351 +   1352

    -

    +

    sisu -dv dropall

    -   1352 +   1353

    -

    +

    update content

    -   1353 +   1354

    -

    +

    sisu -div [filename/wildcard]

    -   1354 +   1355

    -

    +

    sisu -dv import [filename/wildcard]

    -   1355 +   1356

    -

    +

    update content

    -   1356 +   1357

    -

    +

    sisu -duv [filename/wildcard]

    -   1357 +   1358

    -

    +

    sisu -dv update [filename/wildcard]

    -   1358 +   1359

    -

    +

    [the -v is for verbose]

    -   1359 +   1360

    -

    +

    The following are available without installation of the sisu-sqlite component, but are of interest in this context

    -   1360 +   1361

    -

    +

    generate a sample database query form for use with webserver on port 80

    -   1361 +   1362

    -

    +

    sisu -F

    -   1362 +   1363

    -

    +

    or for use with webrick server

    -   1363 +   1364

    -

    +

    sisu -F webrick

    -   1364 +   1365

    -

    +

    to start webrick server

    -   1365 +   1366

    -

    +

    sisu -W

    -   1366 +   1367

    -

    +

    36. Quickstart - Getting Started Howto

    -   1367 +   1368

    -
    +
    36.1 Installation

    -   1368 +   1369

    -

    +

    Installation is currently most straightforward and tested on the Debian platform, as there are packages for the installation of sisu and all requirements for what it does.

    -   1369 +   1370

    -
    +
    36.1.1 Debian Installation

    -   1370 +   1371

    -

    +

    SiSU is available directly from the Debian Sid and testing archives (and possibly Ubuntu), assuming your /etc/apt/sources.list is set accordingly:

    -   1371 +   1372

    -

    +

        aptitude update
        aptitude install sisu-complete @@ -19707,27 +19725,27 @@

    -   1372 +   1373

    -

    +

    The following /etc/apt/sources.list setting permits the download of additional markup samples:

    -   1373 +   1374

    -

    +

      #/etc/apt/sources.list

        deb http://ftp.fi.debian.org/debian/ unstable main non-free contrib
    @@ -19738,27 +19756,27 @@

    -   1374 +   1375

    -

    +

    The aptitude commands become:

    -   1375 +   1376

    -

    +

        aptitude update
        aptitude install sisu-complete sisu-markup-samples @@ -19767,27 +19785,27 @@

    -   1376 +   1377

    -

    +

    If there are newer versions of SiSU upstream of the Debian archives, they will be available by adding the following to your /etc/apt/sources.list

    -   1377 +   1378

    -

    +

      #/etc/apt/sources.list

        deb http://www.jus.uio.no/sisu/archive unstable main non-free
    @@ -19797,27 +19815,27 @@

    -   1378 +   1379

    -

    +

    repeat the aptitude commands

    -   1379 +   1380

    -

    +

        aptitude update
        aptitude install sisu-complete sisu-markup-samples @@ -19826,224 +19844,224 @@

    -   1380 +   1381

    -

    +

    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.

    -   1381 +   1382

    -
    +
    36.1.2 RPM Installation

    -   1382 +   1383

    -

    +

    RPMs are provided though untested, they are prepared by running alien against the source package, and against the debs.

    -   1383 +   1384

    -

    +

    They may be downloaded from:

    -   1384 +   1385

    -

    +

    <http://www.jus.uio.no/sisu/SiSU/download.html#rpm>

    -   1385 +   1386

    -

    +

    as root type:

    -   1386 +   1387

    -

    +

    rpm -i [rpm package name]

    -   1387 +   1388

    -
    +
    36.1.3 Installation from source

    -   1388 +   1389

    -

    +

    To install SiSU from source check information at:

    -   1389 +   1390

    -

    +

    <http://www.jus.uio.no/sisu/SiSU/download.html#current>

    -   1390 +   1391

    -
  • +
  • download the source package

    • -   1391 +   1392

    -
  • +
  • Unpack the source

    • -   1392 +   1393

    -

    +

    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:

    -   1393 +   1394

    -

    +

    For basic use SiSU is only dependent on the programming language in which it is written Ruby, and 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)  94  or converting LaTeX to pdf.

    -   1394 +   1395

    -

    +

    setup.rb

    -   1395 +   1396

    -

    +

    This is a standard ruby installer, using setup.rb is a three step process. In the root directory of the unpacked SiSU as root type:

    -   1396 +   1397

    - -
    -

    +

          ruby setup.rb config
          ruby setup.rb setup
    @@ -20052,19 +20070,6 @@

    		-

    -   1397 -

    -
    - - -
    -

    - further information on setup.rb is available from: -

    -

      1398 @@ -20074,8 +20079,8 @@
    -

    - <http://i.loveruby.net/en/projects/setup/> +

    + further information on setup.rb is available from:

    		@@ -20088,7 +20093,7 @@

    - <http://i.loveruby.net/en/projects/setup/doc/usage.html> + <http://i.loveruby.net/en/projects/setup/>

    		@@ -20100,8 +20105,8 @@
    -

    - "install" +

    + <http://i.loveruby.net/en/projects/setup/doc/usage.html>

    		@@ -20114,7 +20119,7 @@

    - The "install" file provided is an installer prepared using "rant". In the root directory of the unpacked SiSU as root type: + "install"

    		@@ -20126,8 +20131,8 @@
    -

    - ruby install base +

    + The "install" file provided is an installer prepared using "rant". In the root directory of the unpacked SiSU as root type:

    		@@ -20139,8 +20144,8 @@
    -

    - or for a more complete installation: +

    + ruby install base

    		@@ -20152,8 +20157,8 @@
    -

    - ruby install +

    + or for a more complete installation:

    		@@ -20165,8 +20170,8 @@
    -

    - or +

    + ruby install

    		@@ -20178,8 +20183,8 @@
    -

    - ruby install base +

    + or

    		@@ -20191,8 +20196,8 @@
    -

    - 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. +

    + ruby install base

    		@@ -20205,7 +20210,7 @@

    - Further information on "rant" is available from: + 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.

    		@@ -20217,8 +20222,8 @@
    -

    - <http://make.rubyforge.org/> +

    + Further information on "rant" is available from:

    		@@ -20231,7 +20236,7 @@

    - <http://rubyforge.org/frs/?group_id=615> + <http://make.rubyforge.org/>

    		@@ -20243,8 +20248,8 @@
    -

    - For a list of alternative actions you may type: +

    + <http://rubyforge.org/frs/?group_id=615>

    		@@ -20256,8 +20261,8 @@
    -

    - ruby install help +

    + For a list of alternative actions you may type:

    		@@ -20270,7 +20275,7 @@

    - ruby install -T + ruby install help

    		@@ -20282,10 +20287,9 @@
    -
    - - 36.2 Testing SiSU, generating output -
    +

    + ruby install -T +

    @@ -20296,9 +20300,10 @@
    -

    - To check which version of sisu is installed: -

    +
    + + 36.2 Testing SiSU, generating output +

    @@ -20310,7 +20315,7 @@

    - sisu -v + To check which version of sisu is installed:

    		@@ -20323,7 +20328,7 @@

    - Depending on your mode of installation one or a number of markup sample files may be found either in the directory: + sisu -v

    		@@ -20336,7 +20341,7 @@

    - ... + Depending on your mode of installation one or a number of markup sample files may be found either in the directory:

    		@@ -20349,7 +20354,7 @@

    - or + ...

    		@@ -20362,7 +20367,7 @@

    - ... + or

    		@@ -20375,7 +20380,7 @@

    - change directory to the appropriate one: + ...

    		@@ -20388,7 +20393,7 @@

    - cd /usr/share/doc/sisu/sisu_markup_samples/dfsg + change directory to the appropriate one:

    		@@ -20400,10 +20405,9 @@
    -
    - - 36.2.1 basic text, plaintext, html, XML, ODF -
    +

    + cd /usr/share/doc/sisu/sisu_markup_samples/dfsg +

    @@ -20414,9 +20418,10 @@
    -

    - Having moved to the directory that contains the markup samples (see instructions above if necessary), choose a file and run sisu against it -

    +
    + + 36.2.1 basic text, plaintext, html, XML, ODF +

    @@ -20428,7 +20433,7 @@

    - sisu -NhwoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst + Having moved to the directory that contains the markup samples (see instructions above if necessary), choose a file and run sisu against it

    		@@ -20441,7 +20446,7 @@

    - this will generate html including a concordance file, opendocument text format, plaintext, XHTML and various forms of XML, and OpenDocument text + sisu -NhwoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst

    		@@ -20453,10 +20458,9 @@
    -
    - - 36.2.2 LaTeX / pdf -
    +

    + this will generate html including a concordance file, opendocument text format, plaintext, XHTML and various forms of XML, and OpenDocument text +

    @@ -20467,9 +20471,10 @@
    -

    - Assuming a LaTeX engine such as tetex or texlive is installed with the required modules (done automatically on selection of sisu-pdf in Debian) -

    +
    + + 36.2.2 LaTeX / pdf +

    @@ -20481,7 +20486,7 @@

    - Having moved to the directory that contains the markup samples (see instructions above if necessary), choose a file and run sisu against it + Assuming a LaTeX engine such as tetex or texlive is installed with the required modules (done automatically on selection of sisu-pdf in Debian)

    		@@ -20494,7 +20499,7 @@

    - sisu -pv free_as_in_freedom.rms_and_free_software.sam_williams.sst + Having moved to the directory that contains the markup samples (see instructions above if necessary), choose a file and run sisu against it

    		@@ -20507,7 +20512,7 @@

    - sisu -3 free_as_in_freedom.rms_and_free_software.sam_williams.sst + sisu -pv free_as_in_freedom.rms_and_free_software.sam_williams.sst

    		@@ -20520,7 +20525,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 + sisu -3 free_as_in_freedom.rms_and_free_software.sam_williams.sst

    		@@ -20532,10 +20537,9 @@
    -
    - - 36.2.3 relational database - postgresql, sqlite -
    +

    + 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 +

    @@ -20546,9 +20550,10 @@
    -

    - Relational databases need some setting up - you must have permission to create the database and write to it when you run sisu. -

    +
    + + 36.2.3 relational database - postgresql, sqlite +

    @@ -20560,7 +20565,7 @@

    - Assuming you have the database installed and the requisite permissions + Relational databases need some setting up - you must have permission to create the database and write to it when you run sisu.

    		@@ -20573,7 +20578,7 @@

    - sisu --sqlite --recreate + Assuming you have the database installed and the requisite permissions

    		@@ -20586,7 +20591,7 @@

    - sisu --sqlite -v --import free_as_in_freedom.rms_and_free_software.sam_williams.sst + sisu --sqlite --recreate

    		@@ -20599,7 +20604,7 @@

    - sisu --pgsql --recreate + sisu --sqlite -v --import free_as_in_freedom.rms_and_free_software.sam_williams.sst

    		@@ -20612,7 +20617,7 @@

    - sisu --pgsql -v --import free_as_in_freedom.rms_and_free_software.sam_williams.sst + sisu --pgsql --recreate

    		@@ -20624,712 +20629,712 @@ + +
    -
    +

    + sisu --pgsql -v --import free_as_in_freedom.rms_and_free_software.sam_williams.sst +

    +
    		 +

    +   1441 +

    +
    + + +
    +
    36.3 Getting Help

    -   1441 +   1442

    -
    +
    36.3.1 The man pages

    -   1442 +   1443

    -

    +

    Type:

    -   1443 +   1444

    -

    +

    man sisu

    -   1444 +   1445

    -

    +

    The man pages are also available online, though not always kept as up to date as within the package itself:

    -   1445 +   1446

    -
  • +
  • sisu.1   95 

    • -   1446 +   1447

    -
  • +
  • sisu.8   96 

    • -   1447 +   1448

    -
  • +
  • man directory   97 

    • -   1448 +   1449

    -
    +
    36.3.2 Built in help

    -   1449 +   1450

    -

    +

    sisu --help

    -   1450 +   1451

    -

    +

    sisu --help --env

    -   1451 +   1452

    -

    +

    sisu --help --commands

    -   1452 +   1453

    -

    +

    sisu --help --markup

    -   1453 +   1454

    -
    +
    36.3.3 The home page

    -   1454 +   1455

    -

    +

    <http://www.jus.uio.no/sisu>

    -   1455 +   1456

    -

    +

    <http://www.jus.uio.no/sisu/SiSU>

    -   1456 +   1457

    -
    +
    36.4 Markup Samples

    -   1457 +   1458

    -

    +

    A number of markup samples (along with output) are available off:

    -   1458 +   1459

    -

    +

    <http://www.jus.uio.no/sisu/SiSU/2.html>

    -   1459 +   1460

    -

    +

    Additional markup samples are packaged separately in the file:

    -   1460 +   1461

    -

    +

    *

    -   1461 +   1462

    -

    +

    On Debian they are available in non-free  98  to include them it is necessary to include non-free in your /etc/apt/source.list or obtain them from the sisu home site.

    -   1462 +   1463

    -

    +

    HowTo

    -   1463 +   1464

    -

    +

    37. Getting Help

    -   1464 +   1465

    -

    +

    An online manual of sorts should be available at:

    -   1465 +   1466

    -

    +

    <http://www.jus.uio.no/sisu_manual/>

    -   1466 +   1467

    -

    +

    The manual pages provided with 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.

    -   1467 +   1468

    -
    +
    37.1 SiSU "man" pages

    -   1468 +   1469

    -

    +

    If SiSU is installed on your system usual man commands should be available, try:

    -   1469 +   1470

    -

    +

    man sisu

    -   1470 +   1471

    -

    +

    The SiSU man pages can be viewed online at:  99 

    -   1471 +   1472

    -

    +

    An online version of the sisu man page is available here:

    -   1472 +   1473

    -
  • +
  • various sisu man pages   100 

    • -   1473 +   1474

    -
  • +
  • sisu.1   101 

    • -   1474 +   1475

    -
  • +
  • sisu.8   102 

    • -   1475 +   1476

    -
  • +
  • sisu_examples.1   103 

    • -   1476 +   1477

    -
  • +
  • sisu_webrick.1   104 

    • -   1477 +   1478

    -
    +
    37.2 SiSU built-in help

    -   1478 +   1479

    -

    +

    sisu --help

    -   1479 +   1480

    -

    +

    sisu --help [subject]

    -   1480 +   1481

    -

    +

    sisu --help env [for feedback on the way your system is setup with regard to sisu]

    -   1481 +   1482

    -

    +

    sisu -V [same as above command]

    -   1482 +   1483

    -

    +

    sisu --help commands

    -   1483 +   1484

    -

    +

    sisu --help markup

    -   1484 +   1485

    -
    +
    37.3 Command Line with Flags - Batch Processing

    -   1485 +   1486

    -

    +

    Running sisu (alone without any flags, filenames or wildcards) brings up the interactive help, as does any sisu command that is not recognised.

    -   1486 +   1487

    -

    +

    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.

    -   1487 +   1488

    -

    +

    38. Setup, initialisation

    -   1488 +   1489

    -
    +
    38.1 initialise output directory

    -   1489 +   1490

    -

    +

    Images, css files for a document directory are copied to their respective locations in the output directory.

    -   1490 +   1491

    -

    +

    while within your document markup/preparation directory, issue the following command

    -   1491 +   1492

    -

    +

    sisu -CC

    -   1492 +   1493

    - -
    -
    +
    38.1.1 Use of search functionality, an example using sqlite
    		-

    -   1493 -

    -
    - - -
    -

    - SiSU can populate PostgreSQL and Sqlite databases and provides a sample search form for querying these databases. -

    -

      1494 @@ -21340,7 +21345,7 @@

    - This note provides an example to get you started and will use sqlite + SiSU can populate PostgreSQL and Sqlite databases and provides a sample search form for querying these databases.

    		@@ -21353,7 +21358,7 @@

    - It is necessary to: + This note provides an example to get you started and will use sqlite

    		@@ -21366,7 +21371,7 @@

    - (1) make sure the required dependencies have been installed + It is necessary to:

    		@@ -21379,7 +21384,7 @@

    - (2) have a directory with sisu markup samples that is writable + (1) make sure the required dependencies have been installed

    		@@ -21392,7 +21397,7 @@

    - (3) use sisu to create a database + (2) have a directory with sisu markup samples that is writable

    		@@ -21405,7 +21410,7 @@

    - (4) use sisu tp populate a database + (3) use sisu to create a database

    		@@ -21418,7 +21423,7 @@

    - (5) use sisu to start the webrick (httpd) server + (4) use sisu tp populate a database

    		@@ -21431,7 +21436,7 @@

    - (6) use sisu to create a search form + (5) use sisu to start the webrick (httpd) server

    		@@ -21444,7 +21449,7 @@

    - (7) copy the search form to the cgi directory + (6) use sisu to create a search form

    		@@ -21457,7 +21462,7 @@

    - (8) open up the form in your browser + (7) copy the search form to the cgi directory

    		@@ -21470,7 +21475,7 @@

    - (9) query the database using the search form + (8) open up the form in your browser

    		@@ -21483,7 +21488,7 @@

    - (1) make sure the required dependencies have been installed + (9) query the database using the search form

    		@@ -21496,7 +21501,7 @@

    - if you use Debian, the following command will install the required dependencies + (1) make sure the required dependencies have been installed

    		@@ -21509,7 +21514,7 @@

    - aptitude install sisu-sqlite + if you use Debian, the following command will install the required dependencies

    		@@ -21522,7 +21527,7 @@

    - (2) have a directory with sisu markup samples that is writable + aptitude install sisu-sqlite

    		@@ -21535,7 +21540,7 @@

    - ideally copy the sisu-examples directory to your home directory (because the directory in which you run this example should be writable) + (2) have a directory with sisu markup samples that is writable

    		@@ -21548,7 +21553,7 @@

    - cp -rv /usr/share/sisu-examples/sample/document_samples_sisu_markup ~/. + ideally copy the sisu-examples directory to your home directory (because the directory in which you run this example should be writable)

    		@@ -21561,7 +21566,7 @@

    - (3) use sisu to create an sqlite database + cp -rv /usr/share/sisu-examples/sample/document_samples_sisu_markup ~/.

    		@@ -21574,7 +21579,7 @@

    - within the sisu-examples directory + (3) use sisu to create an sqlite database

    		@@ -21587,7 +21592,7 @@

    - sisu -dv createall + within the sisu-examples directory

    		@@ -21600,7 +21605,7 @@

    - (4) use sisu tp populate a database with some text + sisu -dv createall

    		@@ -21613,7 +21618,7 @@

    - within the sisu-examples directory + (4) use sisu tp populate a database with some text

    		@@ -21626,7 +21631,7 @@

    - sisu -div free_*.sst + within the sisu-examples directory

    		@@ -21639,7 +21644,7 @@

    - or + sisu -div free_*.sst

    		@@ -21652,7 +21657,7 @@

    - sisu -dv import free_*.sst debian_constitution_v1.2.sst debian_social_contract_v1.1.sst gpl2.fsf.sst + or

    		@@ -21665,7 +21670,7 @@

    - (5) use sisu to start the webrick (httpd) server (if it has not already been started): + sisu -dv import free_*.sst debian_constitution_v1.2.sst debian_social_contract_v1.1.sst gpl2.fsf.sst

    		@@ -21678,7 +21683,7 @@

    - sisu -W + (5) use sisu to start the webrick (httpd) server (if it has not already been started):

    		@@ -21691,7 +21696,7 @@

    - (6) use sisu to create a search form (for use with the webrick server, and your sample documents) + sisu -W

    		@@ -21704,7 +21709,7 @@

    - within the sisu-examples directory + (6) use sisu to create a search form (for use with the webrick server, and your sample documents)

    		@@ -21717,7 +21722,7 @@

    - sisu -F webrick + within the sisu-examples directory

    		@@ -21730,7 +21735,7 @@

    - #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 + sisu -F webrick

    		@@ -21743,7 +21748,7 @@

    - #now this should be possible: sisu -F webrick + #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

    		@@ -21756,7 +21761,7 @@

    - (7) copy the search form to the cgi directory + #now this should be possible: sisu -F webrick

    		@@ -21769,7 +21774,7 @@

    - the string should be provided as output from the previous command + (7) copy the search form to the cgi directory

    		@@ -21782,7 +21787,7 @@

    - sudo cp -vi /usr/share/sisu-examples/sample/document_samples_sisu_markup/sisu_sqlite.cgi /usr/lib/cgi-bin + the string should be provided as output from the previous command

    		@@ -21795,7 +21800,7 @@

    - sudo chmod -v 755 /usr/lib/cgi-bin/sisu_sqlite.cgi + sudo cp -vi /usr/share/sisu-examples/sample/document_samples_sisu_markup/sisu_sqlite.cgi /usr/lib/cgi-bin

    		@@ -21808,7 +21813,7 @@

    - (8) open up the form in your browser and query it + sudo chmod -v 755 /usr/lib/cgi-bin/sisu_sqlite.cgi

    		@@ -21821,7 +21826,7 @@

    - url: + (8) open up the form in your browser and query it

    		@@ -21834,7 +21839,7 @@

    - <http://localhost:8081/cgi-bin/sisu_sqlite.cgi> + url:

    		@@ -21847,7 +21852,7 @@

    - or as instructed by command sisu -F webrick + <http://localhost:8081/cgi-bin/sisu_sqlite.cgi>

    		@@ -21860,7 +21865,7 @@

    - (9) query the database using the search form + or as instructed by command sisu -F webrick

    		@@ -21873,7 +21878,7 @@

    - if there are other options in the dropdown menu select + (9) query the database using the search form

    		@@ -21886,7 +21891,7 @@

    - document_samples_sisu_markup + if there are other options in the dropdown menu select

    		@@ -21899,7 +21904,7 @@

    - and search for some text, e.g.: + document_samples_sisu_markup

    		@@ -21912,7 +21917,7 @@

    - aim OR project + and search for some text, e.g.:

    		@@ -21924,9 +21929,9 @@
    -
  • - selecting the index radio button gives an index of results using the object numbers -
    • +

    + aim OR project +

    @@ -21938,7 +21943,7 @@
  • - selecting the text radio button gives the content of the matched paragraphs with the match highlighted + selecting the index radio button gives an index of results using the object numbers
    		• @@ -21950,9 +21955,9 @@
    -

    - (10) to start again with a new database -

    +
  • + selecting the text radio button gives the content of the matched paragraphs with the match highlighted +

    • @@ -21964,7 +21969,7 @@

    - to start from scratch you can drop the database with the command + (10) to start again with a new database

    		@@ -21977,7 +21982,7 @@

    - sisu -dv dropall + to start from scratch you can drop the database with the command

    		@@ -21990,7 +21995,7 @@

    - and go to step 3 + sisu -dv dropall

    		@@ -22003,7 +22008,7 @@

    - to get to step 3 in one step with a single command + and go to step 3

    		@@ -22016,7 +22021,7 @@

    - sisu -dv recreate + to get to step 3 in one step with a single command

    		@@ -22029,7 +22034,7 @@

    - continue subsequent steps + sisu -dv recreate

    		@@ -22041,423 +22046,423 @@ + +
    -
    +

    + continue subsequent steps +

    +
    		 +

    +   1549 +

    +
    + + +
    +
    38.2 misc

    -   1549 +   1550

    -
    +
    38.2.1 url for output files -u -U

    -   1550 +   1551

    -

    +

    sisu -uv[and other flags] [filename/wildcard]

    -   1551 +   1552

    -

    +

    sisu -Uv [filename/wildcard]

    -   1552 +   1553

    -
    +
    38.2.2 toggle screen color

    -   1553 +   1554

    -

    +

    sisu -cv[and processing flags] [filename/wildcard]

    -   1554 +   1555

    -
    +
    38.2.3 verbose mode

    -   1555 +   1556

    -

    +

    sisu -v[and processing flags] [filename/wildcard]

    -   1556 +   1557

    -

    +

    sisu -V[and processing flags] [filename/wildcard]

    -   1557 +   1558

    -
    +
    38.2.4 quiet mode

    -   1558 +   1559

    -

    +

    sisu -q[and processing flags] [filename/wildcard]

    -   1559 +   1560

    -
    +
    38.2.5 maintenance mode intermediate files kept -M

    -   1560 +   1561

    -

    +

    sisu -Mv[and other flags] [filename/wildcard]

    -   1561 +   1562

    -
    +
    38.2.6 start the webrick server

    -   1562 +   1563

    -

    +

    sisu -W

    -   1563 +   1564

    -
    +
    38.3 remote placement of output

    -   1564 +   1565

    -

    +

    configuration is necessary

    -   1565 +   1566

    -

    +

    scp

    -   1566 +   1567

    -

    +

    sisu -vr[and processing flags] [filename/wildcard]

    -   1567 +   1568

    -

    +

    rsync

    -   1568 +   1569

    -

    +

    sisu -vR[and processing flags] [filename/wildcard]

    -   1569 +   1570

    -

    +

    39. Configuration Files

    -   1570 +   1571

    -

    +

    Sample provided, on untarring the source tarball:

    -   1571 +   1572

    -

    +

    conf/sisu/sisurc.yaml

    -   1572 +   1573

    -

    +

    and on installation under:

    -   1573 +   1574

    -

    +

    /etc/sisu/sisurc.yaml

    -   1574 +   1575

    -

    +

    The following paths are searched:

    -   1575 +   1576

    -

    +

    ./_sisu/sisurc.yaml

    -   1576 +   1577

    -

    +

    ~/.sisu/sisurc.yaml

    -   1577 +   1578

    -

    +

    ./etc/sisu/sisurc.yaml

    -   1578 +   1579

    - -
    -

    +

    40. Markup

    		-

    -   1579 -

    -
    - - -
    -

    - See sample markup provided on -

    -

      1580 @@ -22468,7 +22473,7 @@

    - <http://www.jus.uio.no/sisu> + See sample markup provided on

    		@@ -22481,7 +22486,7 @@

    - <http://www.jus.uio.no/sisu_markup> + <http://www.jus.uio.no/sisu>

    		@@ -22494,7 +22499,7 @@

    - <http://www.jus.uio.no/sisu/SiSU> + <http://www.jus.uio.no/sisu_markup>

    		@@ -22507,7 +22512,7 @@

    - in particular for each of the document output samples provided, the source document is provided as well + <http://www.jus.uio.no/sisu/SiSU>

    		@@ -22520,7 +22525,7 @@

    - <http://www.jus.uio.no/sisu/SiSU/2#books> + in particular for each of the document output samples provided, the source document is provided as well

    		@@ -22533,7 +22538,7 @@

    - on untarring the source tarball: + <http://www.jus.uio.no/sisu/SiSU/2#books>

    		@@ -22545,8 +22550,8 @@
    -

    - data/sisu-examples/sample/document_samples_sisu_markup/ +

    + on untarring the source tarball:

    		@@ -22558,8 +22563,8 @@
    -

    - or the same once source is installed (or sisu-examples) under: +

    + data/sisu-examples/sample/document_samples_sisu_markup/

    		@@ -22571,8 +22576,8 @@
    -

    - /usr/share/sisu-examples/sample/document_samples_sisu_markup/ +

    + or the same once source is installed (or sisu-examples) under:

    		@@ -22584,8 +22589,8 @@
    -

    - Some notes are contained within the man page, man sisu and within sisu help via the commands sisu help markup and sisu help headers +

    + /usr/share/sisu-examples/sample/document_samples_sisu_markup/

    		@@ -22598,7 +22603,7 @@

    - 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: + Some notes are contained within the man page, man sisu and within sisu help via the commands sisu help markup and sisu help headers

    		@@ -22610,10 +22615,9 @@
    -
    - - 40.1 Headers -
    +

    + 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: +

    @@ -22624,9 +22628,10 @@
    -

    - Headers @headername: provide information related to the document, this may relate to -

    +
    + + 40.1 Headers +

    @@ -22638,7 +22643,7 @@

    - 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 + Headers @headername: provide information related to the document, this may relate to

    		@@ -22651,7 +22656,7 @@

    - 2. semantic information about the document including the dublin core + 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

    		@@ -22663,10 +22668,9 @@
    -
    - - 40.2 Font Face -
    +

    + 2. semantic information about the document including the dublin core +

    @@ -22677,9 +22681,10 @@
    -

    - Defaults are set. You may change the face to: bold, italics, underscore, strikethrough, ... -

    +
    + + 40.2 Font Face +

    @@ -22690,10 +22695,9 @@
    -
    - - 40.2.1 Bold -
    +

    + Defaults are set. You may change the face to: bold, italics, underscore, strikethrough, ... +

    @@ -22704,9 +22708,10 @@
    -

    - \@bold: [list of words that should be made bold within document] -

    +
    + + 40.2.1 Bold +

    @@ -22718,7 +22723,7 @@

    - bold line + \@bold: [list of words that should be made bold within document]

    		@@ -22731,7 +22736,7 @@

    - !_ bold line + bold line

    		@@ -22744,7 +22749,7 @@

    - bold word or sentence + !_ bold line

    		@@ -22757,7 +22762,7 @@

    - !{ bold word or sentence }! + bold word or sentence

    		@@ -22770,7 +22775,7 @@

    - *{ bold word or sentence }* + !{ bold word or sentence }!

    		@@ -22783,7 +22788,7 @@

    - boldword or boldword + *{ bold word or sentence }*

    		@@ -22796,7 +22801,7 @@

    - *boldword* or !boldword! + boldword or boldword

    		@@ -22808,10 +22813,9 @@
    -
    - - 40.2.2 Italics -
    +

    + *boldword* or !boldword! +

    @@ -22822,9 +22826,10 @@
    -

    - \@italics: [list of words that should be italicised within document] -

    +
    + + 40.2.2 Italics +

    @@ -22836,7 +22841,7 @@

    - italicise word or sentence + \@italics: [list of words that should be italicised within document]

    		@@ -22849,7 +22854,7 @@

    - /{ italicise word or sentence }/ + italicise word or sentence

    		@@ -22862,7 +22867,7 @@

    - italicisedword + /{ italicise word or sentence }/

    		@@ -22875,7 +22880,7 @@

    - /italicisedword/ + italicisedword

    		@@ -22887,10 +22892,9 @@
    -
    - - 40.2.3 Underscore -
    +

    + /italicisedword/ +

    @@ -22901,9 +22905,10 @@
    -

    - underscore word or sentence -

    +
    + + 40.2.3 Underscore +

    @@ -22915,7 +22920,7 @@

    - _{ underscore word or sentence }_ + underscore word or sentence

    		@@ -22928,7 +22933,7 @@

    - underscoreword + _{ underscore word or sentence }_

    		@@ -22940,10 +22945,9 @@
    -
    - - 40.2.4 Strikethrough -
    +

    + underscoreword +

    @@ -22954,9 +22958,10 @@
    -

    - strikethrough word or sentence -

    +
    + + 40.2.4 Strikethrough +

    @@ -22968,7 +22973,7 @@

    - -{ strikethrough word or sentence }- + strikethrough word or sentence

    		@@ -22981,7 +22986,7 @@

    - strikeword + -{ strikethrough word or sentence }-

    		@@ -22994,7 +22999,7 @@

    - -strikeword- + strikeword

    		@@ -23006,10 +23011,9 @@
    -
    - - 40.3 Endnotes -
    +

    + -strikeword- +

    @@ -23020,9 +23024,10 @@
    -

    - There are two forms of markup for endnotes, they cannot be mixed within the same document -

    +
    + + 40.3 Endnotes +

    @@ -23034,7 +23039,7 @@

    - here  105  + There are two forms of markup for endnotes, they cannot be mixed within the same document

    		@@ -23047,7 +23052,7 @@

    - 1. preferred endnote markup + here  105 

    		@@ -23060,7 +23065,7 @@

    - here~{ this is an endnote }~ + 1. preferred endnote markup

    		@@ -23073,7 +23078,7 @@

    - 2. alternative markup equivalent, kept because it is possible to search and replace to get markup in existing texts such as Project Gutenberg + here~{ this is an endnote }~

    		@@ -23086,7 +23091,7 @@

    - here~^ + 2. alternative markup equivalent, kept because it is possible to search and replace to get markup in existing texts such as Project Gutenberg

    		@@ -23099,7 +23104,7 @@

    - ^~ this is an endote + here~^

    		@@ -23111,10 +23116,9 @@
    -
    - - 40.4 Links -
    +

    + ^~ this is an endote +

    @@ -23125,9 +23129,10 @@
    -

    - SiSU -

    +
    + + 40.4 Links +

    @@ -23139,7 +23144,7 @@

    - { SiSU }http://sisudoc.org + SiSU

    		@@ -23152,7 +23157,7 @@

    - + { SiSU }http://sisudoc.org

    		@@ -23165,7 +23170,7 @@

    - {sisu.png }http://sisudoc.org +

    		@@ -23178,7 +23183,7 @@

    - + {sisu.png }http://sisudoc.org

    		@@ -23191,7 +23196,7 @@

    - { tux.png 64x80 }image +

    		@@ -23204,7 +23209,7 @@

    - SiSU   106  + { tux.png 64x80 }image

    		@@ -23217,7 +23222,7 @@

    - { SiSU }http://sisudoc.org + SiSU   106 

    		@@ -23230,7 +23235,7 @@

    - is equivalent to: + { SiSU }http://sisudoc.org

    		@@ -23243,7 +23248,7 @@

    - { SiSU }http://sisudoc.org ~{ <http://sisudoc.org> }~ + is equivalent to:

    		@@ -23256,7 +23261,7 @@

    - the same can be done with an image: + { SiSU }http://sisudoc.org ~{ <http://sisudoc.org> }~

    		@@ -23269,7 +23274,7 @@

    -

    SiSU

      108  + the same can be done with an image:

    		@@ -23282,7 +23287,7 @@

    - { sisu.png "SiSU" }http://sisudoc.org +

    SiSU

      108 

    		@@ -23294,244 +23299,257 @@ + +
    -
    +

    + { sisu.png "SiSU" }http://sisudoc.org +

    +
    		 +

    +   1644 +

    +
    + + +
    +
    40.5 Number Titles

    -   1644 +   1645

    -

    +

    Set with the header @markup:

    -   1645 +   1646

    -
    +
    40.6 Line operations

    -   1646 +   1647

    -

    +

    Line Operations (marker placed at start of line)

    -   1647 +   1648

    -

    +

    !_ bold line

    -   1648 +   1649

    -

    +

    bold line

    -   1649 +   1650

    -

    +

    _1 indent paragraph one level

    -   1650 +   1651

    -

    +

    indent paragraph one level

    -   1651 +   1652

    -

    +

    _2 indent paragraph two steps

    -   1652 +   1653

    -

    +

    indent paragraph two steps

    -   1653 +   1654

    -

    +

    _* bullet paragraph

    -   1654 +   1655

    -
  • +
  • bullet paragraph

    • -   1655 +   1656

    -

    +

    # number paragraph (see headers for numbering document headings)

    -   1656 +   1657

    -

    +

    1. number paragraph (see headers for numbering document headings)

    -   1657 +   1658

    -

    +

    _# number paragraph level 2 (see headers for numbering document headings)

    -   1658 +   1659

    -

    +

    a. number paragraph level 2 (see headers for numbering document headings)

    -   1659 +   1660

    -
    +
    40.7 Tables

    -   1660 +   1661

    -

    +

    Table markup sample

    -   1661 +   1662

    -

    +

    table{~h c3; 26; 32; 32;
    @@ -23539,14 +23557,14 @@ table{~h c3; 26; 32; 32;

    -   1662 +   1663

    -

    +

    This is a table, column1
    this would become row one of column two
    column three of row one is here
    @@ -23554,14 +23572,14 @@ This is a table, column1
    this would become row one of column two
    colum

    -   1663 +   1664

    -

    +

    column one row 2
    column two of row two
    column three of row two, and so on
    @@ -23569,14 +23587,14 @@ column one row 2
    column two of row two
    column three of row two, and so

    -   1664 +   1665

    -

    +

    column one row three
    and so on
    here
    @@ -23584,14 +23602,14 @@ column one row three
    and so on
    here

    -   1665 +   1666

    -

    +

    }table
    @@ -23599,27 +23617,27 @@ column one row three
    and so on
    here

    -   1666 +   1667

    -

    +

    Alternative form of table markup

    -   1667 +   1668

    -

    +

      {t\~h}
           |Mon|Tue|Wed|Thu|Fri|Sat|Sun
    @@ -23634,28 +23652,28 @@ column one row three
    and so on
    here

    -   1668 +   1669

    -
    +
    40.8 Grouped Text

    -   1669 +   1670

    -

    +

        5.times { puts 'Ruby' } @@ -23663,27 +23681,27 @@ column one row three
    and so on
    here

    -   1670 +   1671

    -

    +

    code{

    -   1671 +   1672

    -

    +

        5.times { puts 'Ruby' } @@ -23691,27 +23709,27 @@ column one row three
    and so on
    here

    -   1672 +   1673

    -

    +

    }code

    -   1673 +   1674

    -

    +

    A Limerick
    @@ -23719,14 +23737,14 @@ A Limerick

    -   1674 +   1675

    -

    +

    There was a young lady from Clyde,
    who ate a green apple and died,
    but the apple fermented inside the lamented,
    and made cider inside her inside.
    @@ -23734,14 +23752,14 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    -   1675 +   1676

    -

    +

    poem{
    @@ -23749,14 +23767,14 @@ poem{

    -   1676 +   1677

    -

    +

    There was a young lady from Clyde,
    who ate a green apple and died,
    but the apple fermented inside the lamented,
    and made cider inside her inside.
    @@ -23764,14 +23782,14 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    -   1677 +   1678

    -

    +

    }\poem
    @@ -23779,98 +23797,85 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    -   1678 +   1679

    -
    +
    40.9 Composite Document

    -   1679 +   1680

    -

    +

    To import another document, the master document or importing document should be named filename.r3 (r for require)

    -   1680 +   1681

    -

    +

    << { filename.sst }

    -   1681 +   1682

    -

    +

    << { filename.ssi }

    -   1682 +   1683

    -

    +

    41. Change Appearance

    -   1683 +   1684

    - -
    -
    +
    41.1 Skins
    		-

    -   1684 -

    -
    - - -
    -

    - "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 SiSU output. -

    -

      1685 @@ -23881,7 +23886,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - There are a few examples provided, on untarring the source tarball: + "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 SiSU output.

    		@@ -23893,8 +23898,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - conf/sisu/skin/doc/ +

    + There are a few examples provided, on untarring the source tarball:

    		@@ -23907,7 +23912,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - data/sisu-examples/sample/document_samples_sisu_markup/_sisu/skin/doc + conf/sisu/skin/doc/

    		@@ -23919,8 +23924,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - and on installation under: +

    + data/sisu-examples/sample/document_samples_sisu_markup/_sisu/skin/doc

    		@@ -23932,8 +23937,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - /etc/sisu/skin/doc/ +

    + and on installation under:

    		@@ -23946,7 +23951,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/sisu-examples/sample/document_samples_sisu_markup/_sisu/skin/doc + /etc/sisu/skin/doc/

    		@@ -23958,8 +23963,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - The following paths are searched: +

    + /usr/share/sisu-examples/sample/document_samples_sisu_markup/_sisu/skin/doc

    		@@ -23971,8 +23976,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - ./_sisu/skin +

    + The following paths are searched:

    		@@ -23985,7 +23990,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - ~/.sisu/skin + ./_sisu/skin

    		@@ -23998,7 +24003,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /etc/sisu/skin + ~/.sisu/skin

    		@@ -24010,8 +24015,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - Skins under the searched paths in a per document directory, a per directory directory, or a site directory, named: +

    + /etc/sisu/skin

    		@@ -24024,7 +24029,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - doc [may be specified individually in each document] + Skins under the searched paths in a per document directory, a per directory directory, or a site directory, named:

    		@@ -24037,7 +24042,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - dir [used if identifier part of name matches markup directory name] + doc [may be specified individually in each document]

    		@@ -24050,7 +24055,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - site + dir [used if identifier part of name matches markup directory name]

    		@@ -24063,7 +24068,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - It is usual to place all skins in the document directory, with symbolic links as required from dir or site directories. + site

    		@@ -24075,10 +24080,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 41.2 CSS -
    +

    + It is usual to place all skins in the document directory, with symbolic links as required from dir or site directories. +

    @@ -24089,9 +24093,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - 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: -

    +
    + + 41.2 CSS +

    @@ -24103,7 +24108,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - _./_sisu/css + 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:

    		@@ -24116,7 +24121,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - ~/.sisu/css + _./_sisu/css

    		@@ -24129,7 +24134,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - and + ~/.sisu/css

    		@@ -24142,7 +24147,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /etc/sisu/css + and

    		@@ -24155,7 +24160,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - The contents of the first directory found in the search path are copied to the corresponding sisu output directory with the commnd: + /etc/sisu/css

    		@@ -24168,7 +24173,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu -CC + The contents of the first directory found in the search path are copied to the corresponding sisu output directory with the commnd:

    		@@ -24181,7 +24186,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - The SiSU standard css files for SiSU output are: + sisu -CC

    		@@ -24194,7 +24199,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - dom.css html.css html_tables.css index.css sax.css xhtml.css + The SiSU standard css files for SiSU output are:

    		@@ -24207,7 +24212,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - A document may specify its own/bespoke css file using the css header. + dom.css html.css html_tables.css index.css sax.css xhtml.css

    		@@ -24220,7 +24225,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - \@css: + A document may specify its own/bespoke css file using the css header.

    		@@ -24233,7 +24238,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - [expand] + \@css:

    		@@ -24245,10 +24250,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - - Extracts from the README -

    +

    + [expand] +

    @@ -24259,10 +24263,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - - 42. README -

    +

    + + Extracts from the README +

    @@ -24273,9 +24277,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - SiSU 0.55 2007w27/6 2007-07-07 -

    +

    + + 42. README +

    @@ -24287,7 +24292,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Homepage: <http://www.jus.uio.no/sisu> + SiSU 0.55 2007w27/6 2007-07-07

    		@@ -24300,7 +24305,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Description + Homepage: <http://www.jus.uio.no/sisu>

    		@@ -24313,7 +24318,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - SiSU is lightweight markup based document creation and publishing framework that is controlled from the command line. Prepare documents for SiSU using your text editor of choice, then use SiSU to generate various output document formats. + Description

    		@@ -24326,7 +24331,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - With minimal preparation of a plain-text (UTF-8) file using its native markup-syntax, 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. + SiSU is lightweight markup based document creation and publishing framework that is controlled from the command line. Prepare documents for SiSU using your text editor of choice, then use SiSU to generate various output document formats.

    		@@ -24339,7 +24344,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Outputs share a common citation numbering system, and any semantic meta-data provided about the document. + With minimal preparation of a plain-text (UTF-8) file using its native markup-syntax, 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.

    		@@ -24352,7 +24357,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - SiSU also provides concordance files, document content certificates and manifests of generated output. + Outputs share a common citation numbering system, and any semantic meta-data provided about the document.

    		@@ -24365,7 +24370,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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. 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). + SiSU also provides concordance files, document content certificates and manifests of generated output.

    		@@ -24378,7 +24383,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - A vim syntax highlighting file and an ftplugin with folds for sisu markup is provided. Vim 7 includes syntax highlighting for SiSU. + 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. 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).

    		@@ -24391,7 +24396,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man pages, and interactive help are provided. + A vim syntax highlighting file and an ftplugin with folds for sisu markup is provided. Vim 7 includes syntax highlighting for SiSU.

    		@@ -24404,7 +24409,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Dependencies for various features are taken care of in sisu related packages. The package sisu-complete installs the whole of SiSU. + man pages, and interactive help are provided.

    		@@ -24417,7 +24422,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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. + Dependencies for various features are taken care of in sisu related packages. The package sisu-complete installs the whole of SiSU.

    		@@ -24430,7 +24435,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Homepage: <http://www.jus.uio.no/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.

    		@@ -24443,7 +24448,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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. + Homepage: <http://www.jus.uio.no/sisu>

    		@@ -24456,7 +24461,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - SiSU can be used for Internet, Intranet, local filesystem or cd publishing. + 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.

    		@@ -24469,7 +24474,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - SiSU can be used directly off the filesystem, or from a database. + SiSU can be used for Internet, Intranet, local filesystem or cd publishing.

    		@@ -24482,7 +24487,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - SiSU's scalability, is be dependent on your hardware, and filesystem (in my case Reiserfs), and/or database Postgresql. + SiSU can be used directly off the filesystem, or from a database.

    		@@ -24495,7 +24500,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Amongst it's characteristics are: + SiSU's scalability, is be dependent on your hardware, and filesystem (in my case Reiserfs), and/or database Postgresql.

    		@@ -24507,9 +24512,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - simple mnemonoic markup style, -
    • +

    + Amongst it's characteristics are: +

    @@ -24521,7 +24526,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
  • - 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, + simple mnemonoic markup style,
    		• @@ -24534,7 +24539,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
  • - 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. + 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,
    		• @@ -24547,7 +24552,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
  • - it is command line driven, and can be set up on a remote server + 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.
    		• @@ -24560,7 +24565,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
  • - Documents are marked up in SiSU syntax in your favourite editor. 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. + it is command line driven, and can be set up on a remote server
    		• @@ -24572,9 +24577,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - Input files should be UTF-8 -

    +
  • + Documents are marked up in SiSU syntax in your favourite editor. 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. +

    • @@ -24586,7 +24591,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Once set up it is simple to use. + Input files should be UTF-8

    		@@ -24598,939 +24603,952 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but + +
    -
    +

    + Once set up it is simple to use. +

    +
    		 +

    +   1741 +

    +
    + + +
    +
    42.1 Online Information, places to look

    -   1741 +   1742

    -

    +

    <http://www.jus.uio.no/sisu>

    -   1742 +   1743

    -

    +

    Download Sources:

    -   1743 +   1744

    -

    +

    <http://www.jus.uio.no/sisu/SiSU/download.html#current>

    -   1744 +   1745

    -

    +

    <http://www.jus.uio.no/sisu/SiSU/download.html#debian>

    -   1745 +   1746

    -
    +
    42.2 Installation

    -   1746 +   1747

    -

    +

    NB. Platform is Unix / Linux.

    -   1747 +   1748

    -
    +
    42.2.1 Debian

    -   1748 +   1749

    -

    +

    If you use Debian use the Debian packages, check the information at:

    -   1749 +   1750

    -

    +

    <http://www.jus.uio.no/sisu/SiSU/download.html#debian>

    -   1750 +   1751

    -

    +

    (A) SiSU is available directly off the Debian archives for Sid and testing. It should necessary only to run as root:

    -   1751 +   1752

    -

    +

    aptitude update

    -   1752 +   1753

    -

    +

    aptitude install sisu-complete

    -   1753 +   1754

    -

    +

    (B) If there are newer versions of SiSU upstream of the Debian archives, they will be available by adding the following to your /etc/apt/sources.list

    -   1754 +   1755

    -

    +

    deb <http://www.jus.uio.no/sisu/archive> unstable main non-free

    -   1755 +   1756

    -

    +

    deb-src <http://www.jus.uio.no/sisu/archive> unstable main non-free

    -   1756 +   1757

    -

    +

    [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]

    -   1757 +   1758

    -

    +

    Then as root run:

    -   1758 +   1759

    -

    +

    aptitude update

    -   1759 +   1760

    -

    +

    aptitude install sisu-complete

    -   1760 +   1761

    -
    +
    42.2.2 RPM

    -   1761 +   1762

    -

    +

    RPMs are provided though untested, they are prepared by running alien against the source package, and against the debs.

    -   1762 +   1763

    -

    +

    They may be downloaded from:

    -   1763 +   1764

    -

    +

    <http://www.jus.uio.no/sisu/SiSU/download.html#rpm>

    -   1764 +   1765

    -
    +
    42.2.3 Source package .tgz

    -   1765 +   1766

    -

    +

    Otherwise to install SiSU from source, check information at:

    -   1766 +   1767

    -

    +

    <http://www.jus.uio.no/sisu/SiSU/download.html#current>

    -   1767 +   1768

    -

    +

    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,

    -   1768 +   1769

    -

    +

    Ruby is the essential dependency for the basic operation of SiSU

    -   1769 +   1770

    -

    +

    1. Download the latest source (information available) from:

    -   1770 +   1771

    -

    +

    <http://www.jus.uio.no/sisu/SiSU/download.html#current>

    -   1771 +   1772

    -

    +

    2. Unpack the source

    -   1772 +   1773

    -

    +

    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.

    -   1773 +   1774

    -
    +
    42.2.4 to use setup.rb

    -   1774 +   1775

    -

    +

    this is a three step process, in the root directory of the unpacked SiSU as root type:

    -   1775 +   1776

    -

    +

    ruby setup.rb config

    -   1776 +   1777

    -

    +

    ruby setup.rb setup

    -   1777 +   1778

    -

    +

    as root:

    -   1778 +   1779

    -

    +

    ruby setup.rb install

    -   1779 +   1780

    -

    +

    further information:

    -   1780 +   1781

    -

    +

    <http://i.loveruby.net/en/projects/setup/>

    -   1781 +   1782

    -

    +

    <http://i.loveruby.net/en/projects/setup/doc/usage.html>

    -   1782 +   1783

    -
    +
    42.2.5 to use install (prapared with "Rake")

    -   1783 +   1784

    -

    +

    Rake must be installed on your system:

    -   1784 +   1785

    -

    +

    <http://rake.rubyforge.org/>

    -   1785 +   1786

    -

    +

    <http://rubyforge.org/frs/?group_id=50>

    -   1786 +   1787

    -

    +

    in the root directory of the unpacked SiSU as root type:

    -   1787 +   1788

    -

    +

    rake

    -   1788 +   1789

    -

    +

    or

    -   1789 +   1790

    -

    +

    rake base

    -   1790 +   1791

    -

    +

    This makes use of Rake (by Jim Weirich) and the provided Rakefile

    -   1791 +   1792

    -

    +

    For a list of alternative actions you may type:

    -   1792 +   1793

    -

    +

    rake help

    -   1793 +   1794

    -

    +

    rake -T

    -   1794 +   1795

    -
    +
    42.2.6 to use install (prapared with "Rant")

    -   1795 +   1796

    -

    +

    (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:)

    -   1796 +   1797

    -

    +

    in the root directory of the unpacked SiSU as root type:

    -   1797 +   1798

    -

    +

    ruby ./sisu-install

    -   1798 +   1799

    -

    +

    or

    -   1799 +   1800

    -

    +

    ruby ./sisu-install base

    -   1800 +   1801

    -

    +

    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.

    -   1801 +   1802

    -

    +

    further information:

    -   1802 +   1803

    -

    +

    <http://make.rubyforge.org/>

    -   1803 +   1804

    -

    +

    <http://rubyforge.org/frs/?group_id=615>

    -   1804 +   1805

    -

    +

    For a list of alternative actions you may type:

    -   1805 +   1806

    -

    +

    ruby ./sisu-install help

    -   1806 +   1807

    -

    +

    ruby ./sisu-install -T

    -   1807 +   1808

    -
    +
    42.3 Dependencies

    -   1808 +   1809

    -

    +

    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 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.

    -   1809 +   1810

    -

    +

    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 Debian control file (end edited), gives an idea of additional packages that SiSU can make use of if available, (the use/requirement of some of which are interdependent for specific actions by SiSU).

    -   1810 +   1811

    -

    +

    The following is from the debian/control file of sisu-0.58.2, which amongst other things provides the dependencies of sisu within Debian.

    -   1811 +   1812

    -

    +

      Package: sisu
      Architecture: all
    @@ -25562,14 +25580,14 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    -   1812 +   1813

    -

    +

      Source: sisu
      Section: text
    @@ -25579,10 +25597,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but   Standards-Version: 3.7.2

      Package: sisu
      Architecture: all
    -  Depends: ruby (>= 1.8.2), libwebrick-ruby, unzip, zip
    +  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-pdf, sisu-sqlite, sisu-postgresql, hyperestraier, keychain, librmagick-ruby, librexml-ruby, openssl, openssh-client | lsh-client, rsync, tidy, vim-addon-manager
    +  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
    @@ -25624,24 +25642,25 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    -   1813 +   1814

    -

    +

      Package: sisu-complete
      Architecture: all
    -  Depends: ruby (>= 1.8.2), sisu, sisu-pdf, sisu-postgresql, sisu-sqlite
    +  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 publishing framework.
    +   SiSU is a lightweight markup based document structuring, publishing and search
    +   framework for document collections.
       .
       See sisu for a description of the package.
       .
    @@ -25651,23 +25670,50 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    -   1814 +   1815

    + +
    -

    +

    + +  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>

    + +

    +    		 +

    +   1816 +

    +
    + + +
    +

      Package: sisu-pdf
      Architecture: all
      Depends: sisu, texlive-latex-base, texlive-fonts-recommended, texlive-latex-recommended, texlive-latex-extra
    -  #Suggests: evince, xpdf
    +  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 publishing framework.
    +   SiSU is a lightweight markup based document structuring, publishing and search
    +   framework for document collections.
       .
        Homepage: <http://www.jus.uio.no/sisu>

    @@ -25675,19 +25721,19 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    -   1815 +   1817

    -

    +

      Package: sisu-postgresql
      Architecture: all
      Depends: sisu, libdbd-pg-ruby, libdbi-ruby, libdbm-ruby, postgresql
    -  Recommends: libfcgi-ruby
    +  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
    @@ -25699,7 +25745,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but    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.
    +   SiSU is a lightweight markup based document structuring, publishing and search
    +   framework for document collections.
       .
        Homepage: <http://www.jus.uio.no/sisu>

    @@ -25707,19 +25754,19 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    -   1816 +   1818

    -

    +

      Package: sisu-sqlite
      Architecture: all
      Depends: sisu, sqlite, libdbd-sqlite-ruby, libdbi-ruby, libdbm-ruby
    -  Recommends: libfcgi-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.
    @@ -25730,7 +25777,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but    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.
    +   SiSU is a lightweight markup based document structuring, publishing and search
    +   framework for document collections.
       .
        Homepage: <http://www.jus.uio.no/sisu>

    @@ -25738,44 +25786,18 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    -   1817 +   1819

    - -
    -
    +
    42.4 Quick start
    		-

    -   1818 -

    -
    - - - - -
    -

    - 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). -

    -    		 -

    -   1819 -

    -
    - - -
    -

    - After installation of sisu-complete, move to the document samples directory -

    -

      1820 @@ -25785,8 +25807,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - cd /usr/share/doc/sisu/sisu_markup_samples/dfsg +

    + 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).

    		@@ -25799,7 +25821,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - and run + After installation of sisu-complete, move to the document samples directory

    		@@ -25812,7 +25834,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu -3 free_as_in_freedom.rms_and_free_software.sam_williams.sst + cd /usr/share/doc/sisu/sisu_markup_samples/dfsg

    		@@ -25825,7 +25847,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - or the same: + and run

    		@@ -25838,7 +25860,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu -NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst + sisu -3 free_as_in_freedom.rms_and_free_software.sam_williams.sst

    		@@ -25851,7 +25873,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - look at output results, see the "sisu_manifest" page created for the document + or the same:

    		@@ -25863,8 +25885,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - or to generate an online document move to a writable directory, as the file will be downloaded there and e.g. +

    + sisu -NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst

    		@@ -25877,7 +25899,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu -3 <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst> + look at output results, see the "sisu_manifest" page created for the document

    		@@ -25890,7 +25912,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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 + or to generate an online document move to a writable directory, as the file will be downloaded there and e.g.

    		@@ -25903,7 +25925,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - examine source document, vim has syntax support + sisu -3 <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst>

    		@@ -25916,7 +25938,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - gvim free_as_in_freedom.rms_and_free_software.sam_williams.sst + 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

    		@@ -25929,7 +25951,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - additional markup samples in + examine source document, vim has syntax support

    		@@ -25941,8 +25963,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://www.jus.uio.no/sisu/SiSU/2.html> +

    + gvim free_as_in_freedom.rms_and_free_software.sam_williams.sst

    		@@ -25955,7 +25977,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - For help + additional markup samples in

    		@@ -25968,7 +25990,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man sisu + <http://www.jus.uio.no/sisu/SiSU/2.html>

    		@@ -25981,7 +26003,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - or + For help

    		@@ -25994,7 +26016,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu --help + man sisu

    		@@ -26007,7 +26029,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - e.g. + or

    		@@ -26019,8 +26041,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - for the way sisu "sees/maps" your system +

    + sisu --help

    		@@ -26032,8 +26054,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - sisu --help env +

    + e.g.

    		@@ -26046,7 +26068,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - for list of commands and so on + for the way sisu "sees/maps" your system

    		@@ -26059,7 +26081,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu --help commands + sisu --help env

    		@@ -26071,10 +26093,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 42.5 Configuration files -
    +

    + for list of commands and so on +

    @@ -26085,8 +26106,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - The default configuration/setup is contained within the program and is altered by configuration settings in etc[sisu version]/sisurc.yml or in ~/.sisu/sisurc.yml +

    + sisu --help commands

    		@@ -26098,9 +26119,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - configuration file - a yaml file -
    • +
    + + 42.5 Configuration files +

    @@ -26111,8 +26133,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - /etc/sisu/[sisu version]/sisurc.yml +

    + The default configuration/setup is contained within the program and is altered by configuration settings in etc[sisu version]/sisurc.yml or in ~/.sisu/sisurc.yml

    		@@ -26124,9 +26146,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - ~/.sisu/sisurc.yml -

    +
  • + configuration file - a yaml file +

    • @@ -26137,9 +26159,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - directory structure - setting up of output and working directory. -
    • +

    + /etc/sisu/[sisu version]/sisurc.yml +

    @@ -26150,8 +26172,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - * skins - changing the appearance of a project, directory or individual documents within ~/.sisu/skin +

    + ~/.sisu/sisurc.yml

    		@@ -26163,9 +26185,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - ~/.sisu/skin/doc contains individual skins, with symbolic links from -

    +
  • + directory structure - setting up of output and working directory. +

    • @@ -26176,8 +26198,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - ~/.sisu/skin/dir if the contents of a directory are to take a particular document skin. +

    + * skins - changing the appearance of a project, directory or individual documents within ~/.sisu/skin

    		@@ -26189,9 +26211,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - additional software - eg. Tex and LaTeX (tetex, tetex-base, tetex-extra on Debian), Postgresql, [sqlite], trang, tidy, makeinfo, ... none of which are required for basic html or XML processing. -
    • +

    + ~/.sisu/skin/doc contains individual skins, with symbolic links from +

    @@ -26202,9 +26224,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - if you use Vim as editor there is a syntax highlighter and fold resource config file for SiSU. I hope more syntax highlighters follow. -
    • +

    + ~/.sisu/skin/dir if the contents of a directory are to take a particular document skin. +

    @@ -26215,9 +26237,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - There are post installation steps (which are really part of the overall installation) -

    +
  • + additional software - eg. Tex and LaTeX (tetex, tetex-base, tetex-extra on Debian), Postgresql, [sqlite], trang, tidy, makeinfo, ... none of which are required for basic html or XML processing. +

    • @@ -26228,9 +26250,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - 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). -

    +
  • + if you use Vim as editor there is a syntax highlighter and fold resource config file for SiSU. I hope more syntax highlighters follow. +

    • @@ -26241,10 +26263,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 42.6 Use General Overview -
    +

    + There are post installation steps (which are really part of the overall installation) +

    @@ -26256,7 +26277,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Documents are marked up in SiSU syntax and kept in an ordinary text editable file, named with the suffix .sst, or .ssm + 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).

    		@@ -26268,9 +26289,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - Marked up SiSU documents are usually kept in a sub-directory of your choosing -

    +
    + + 42.6 Use General Overview +

    @@ -26282,7 +26304,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - use the interactive help and man pages + Documents are marked up in SiSU syntax and kept in an ordinary text editable file, named with the suffix .sst, or .ssm

    		@@ -26294,8 +26316,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - sisu --help +

    + Marked up SiSU documents are usually kept in a sub-directory of your choosing

    		@@ -26307,8 +26329,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - man sisu +

    + use the interactive help and man pages

    		@@ -26320,10 +26342,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 42.7 Help -
    +

    + sisu --help +

    @@ -26334,8 +26355,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - interactive help described below, or man page: +

    + man sisu

    		@@ -26347,9 +26368,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - man sisu -

    +
    + + 42.7 Help +

    @@ -26360,8 +26382,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - man 8 sisu +

    + interactive help described below, or man page:

    		@@ -26373,8 +26395,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - 'man sisu_markup-samples' [if the sisu-markup-samples package is also installed] +

    + man sisu

    		@@ -26386,8 +26408,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - Once installed an interactive help is available typing 'sisu' (without) any flags, and select an option: +

    + man 8 sisu

    		@@ -26399,8 +26421,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - sisu +

    + 'man sisu_markup-samples' [if the sisu-markup-samples package is also installed]

    		@@ -26413,7 +26435,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - alternatively, you could type e.g. + Once installed an interactive help is available typing 'sisu' (without) any flags, and select an option:

    		@@ -26426,7 +26448,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu --help commands + sisu

    		@@ -26438,8 +26460,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - sisu --help env +

    + alternatively, you could type e.g.

    		@@ -26452,7 +26474,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu --help headers + sisu --help commands

    		@@ -26465,7 +26487,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu --help markup + sisu --help env

    		@@ -26478,7 +26500,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu --help headings + sisu --help headers

    		@@ -26490,8 +26512,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - etc. +

    + sisu --help markup

    		@@ -26503,8 +26525,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - for questions about mappings, output paths etc. +

    + sisu --help headings

    		@@ -26516,8 +26538,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - sisu --help env +

    + etc.

    		@@ -26529,8 +26551,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - sisu --help path +

    + for questions about mappings, output paths etc.

    		@@ -26543,7 +26565,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu --help directory + sisu --help env

    		@@ -26555,10 +26577,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 42.8 Directory Structure -
    +

    + sisu --help path +

    @@ -26569,8 +26590,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - Once installed, type: +

    + sisu --help directory

    		@@ -26582,9 +26603,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - sisu --help env -

    +
    + + 42.8 Directory Structure +

    @@ -26596,7 +26618,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - or + Once installed, type:

    		@@ -26609,7 +26631,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu -V + sisu --help env

    		@@ -26621,10 +26643,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 42.9 Configuration File -
    +

    + or +

    @@ -26635,8 +26656,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - The defaults can be changed via 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) +

    + sisu -V

    		@@ -26649,8 +26670,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    - - 42.10 Markup + + 42.9 Configuration File
    		@@ -26663,7 +26684,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - See man pages. + The defaults can be changed via 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)

    		@@ -26675,9 +26696,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - man sisu -

    +
    + + 42.10 Markup +

    @@ -26688,8 +26710,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - man 8 sisu +

    + See man pages.

    		@@ -26701,8 +26723,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - Once installed there is some information on SiSU Markup in its help: +

    + man sisu

    		@@ -26715,7 +26737,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu --help markup + man 8 sisu

    		@@ -26728,7 +26750,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - and + Once installed there is some information on SiSU Markup in its help:

    		@@ -26741,7 +26763,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu --help headers + sisu --help markup

    		@@ -26754,7 +26776,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Sample marked up document are provided with the download tarball in the directory: + and

    		@@ -26767,7 +26789,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - ./data/doc/sisu/sisu_markup_samples/dfsg + sisu --help headers

    		@@ -26780,7 +26802,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - These are installed on the system usually at: + Sample marked up document are provided with the download tarball in the directory:

    		@@ -26793,7 +26815,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_markup_samples/dfsg + ./data/doc/sisu/sisu_markup_samples/dfsg

    		@@ -26806,7 +26828,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - More markup samples are available in the package sisu-markup-samples + These are installed on the system usually at:

    		@@ -26819,7 +26841,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/SiSU/download.html#sisu-markup-samples> + /usr/share/doc/sisu/sisu_markup_samples/dfsg

    		@@ -26832,7 +26854,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Many more are available online off: + More markup samples are available in the package sisu-markup-samples

    		@@ -26845,7 +26867,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/SiSU/2.html> + <http://www.jus.uio.no/sisu/SiSU/download.html#sisu-markup-samples>

    		@@ -26857,10 +26879,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 42.11 Additional Things -
    +

    + Many more are available online off: +

    @@ -26871,8 +26892,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - There is syntax support for some editors provided (together with a README file) in +

    + <http://www.jus.uio.no/sisu/SiSU/2.html>

    		@@ -26884,9 +26905,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - ./data/sisu/conf/syntax -

    +
    + + 42.11 Additional Things +

    @@ -26898,7 +26920,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - usually installed to: + There is syntax support for some editors provided (together with a README file) in

    		@@ -26911,7 +26933,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/sisu/conf/syntax + ./data/sisu/conf/syntax

    		@@ -26923,10 +26945,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 42.12 License -
    +

    + usually installed to: +

    @@ -26937,8 +26958,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - License: GPL 3 or later see the copyright file in +

    + /usr/share/sisu/conf/syntax

    		@@ -26950,9 +26971,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - ./data/doc/sisu -

    +
    + + 42.12 License +

    @@ -26964,7 +26986,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - usually installed to: + License: GPL 3 or later see the copyright file in

    		@@ -26977,7 +26999,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu + ./data/doc/sisu

    		@@ -26989,10 +27011,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 42.13 SiSU Standard -
    +

    + usually installed to: +

    @@ -27003,8 +27024,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - SiSU uses: +

    + /usr/share/doc/sisu

    		@@ -27016,9 +27037,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - Standard SiSU markup syntax, -
    • +
    + + 42.13 SiSU Standard +

    @@ -27029,9 +27051,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - Standard SiSU meta-markup syntax, and the -
    • +

    + SiSU uses: +

    @@ -27043,7 +27065,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
  • - Standard SiSU object citation numbering and system + Standard SiSU markup syntax,
    		• @@ -27055,9 +27077,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - © Ralph Amissah 1997, current 2006 All Rights Reserved. -

    +
  • + Standard SiSU meta-markup syntax, and the +

    • @@ -27069,7 +27091,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
  • - however note the License section + Standard SiSU object citation numbering and system
    		• @@ -27082,7 +27104,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - CHANGELOG + © Ralph Amissah 1997, current 2006 All Rights Reserved.

    		@@ -27094,9 +27116,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - ./CHANGELOG -

    +
  • + however note the License section +

    • @@ -27108,7 +27130,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - and see + CHANGELOG

    		@@ -27121,7 +27143,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/SiSU/changelog.html> + ./CHANGELOG

    		@@ -27133,8 +27155,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://www.jus.uio.no/sisu/SiSU/changelog_markup_samples.html> +

    + and see

    		@@ -27146,10 +27168,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - - Extracts from man 8 sisu -

    +

    + <http://www.jus.uio.no/sisu/SiSU/changelog.html> +

    @@ -27160,10 +27181,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - - 43. Post Installation Setup -

    +

    + <http://www.jus.uio.no/sisu/SiSU/changelog_markup_samples.html> +

    @@ -27174,10 +27194,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 43.1 Post Installation Setup - Quick start -
    +

    + + Extracts from man 8 sisu +

    @@ -27188,9 +27208,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - After installation of sisu-complete, move to the document samples directory, -

    +

    + + 43. Post Installation Setup +

    @@ -27201,9 +27222,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - cd /usr/share/doc/sisu/sisu_markup_samples/dfsg -

    +
    + + 43.1 Post Installation Setup - Quick start +

    @@ -27215,7 +27237,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - [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] + After installation of sisu-complete, move to the document samples directory,

    		@@ -27227,8 +27249,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - and in that directory, initialise the output directory with the command +

    + cd /usr/share/doc/sisu/sisu_markup_samples/dfsg

    		@@ -27240,8 +27262,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - sisu -CC +

    + [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]

    		@@ -27254,7 +27276,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - then run: + and in that directory, initialise the output directory with the command

    		@@ -27267,7 +27289,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu -1 free_as_in_freedom.rms_and_free_software.sam_williams.sst + sisu -CC

    		@@ -27280,7 +27302,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - or the same: + then run:

    		@@ -27293,7 +27315,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu -NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst + sisu -1 free_as_in_freedom.rms_and_free_software.sam_williams.sst

    		@@ -27306,7 +27328,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - look at output results, see the "sisu_manifest" page created for the document + or the same:

    		@@ -27318,8 +27340,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - for an overview of your current sisu setup, type: +

    + sisu -NhwpoabxXyv free_as_in_freedom.rms_and_free_software.sam_williams.sst

    		@@ -27331,8 +27353,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - sisu --help env +

    + look at output results, see the "sisu_manifest" page created for the document

    		@@ -27345,7 +27367,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - or + for an overview of your current sisu setup, type:

    		@@ -27358,7 +27380,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu -V + sisu --help env

    		@@ -27371,7 +27393,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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. + or

    		@@ -27384,7 +27406,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu -1 <http://www.jus.uio.no/sisu/gpl3.fsf/gpl3.fsf.sst> + sisu -V

    		@@ -27396,8 +27418,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - sisu -3 <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst> +

    + 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.

    		@@ -27409,8 +27431,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - examine source document, vim has syntax highlighting support +

    + sisu -1 <http://www.jus.uio.no/sisu/gpl3.fsf/gpl3.fsf.sst>

    		@@ -27422,8 +27444,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - gvim free_as_in_freedom.rms_and_free_software.sam_williams.sst +

    + sisu -3 <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/free_culture.lawrence_lessig.sst>

    		@@ -27436,7 +27458,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - additional markup samples in + examine source document, vim has syntax highlighting support

    		@@ -27448,8 +27470,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://www.jus.uio.no/sisu/SiSU/2.html> +

    + gvim free_as_in_freedom.rms_and_free_software.sam_williams.sst

    		@@ -27462,7 +27484,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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. + additional markup samples in

    		@@ -27475,7 +27497,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu -3 <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip> + <http://www.jus.uio.no/sisu/SiSU/2.html>

    		@@ -27488,7 +27510,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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: + 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.

    		@@ -27501,7 +27523,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu -3 --trust <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip> + sisu -3 <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip>

    		@@ -27514,7 +27536,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - For help + 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:

    		@@ -27527,7 +27549,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man sisu + sisu -3 --trust <http://www.jus.uio.no/sisu/free_culture.lawrence_lessig/sisupod.zip>

    		@@ -27539,8 +27561,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - sisu --help +

    + For help

    		@@ -27553,7 +27575,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu --help env for the way sisu "sees/maps" your system + man sisu

    		@@ -27566,7 +27588,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu --help commands for list of commands and so on + sisu --help

    		@@ -27578,10 +27600,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 43.2 Document markup directory -
    +

    + sisu --help env for the way sisu "sees/maps" your system +

    @@ -27592,8 +27613,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - 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: +

    + sisu --help commands for list of commands and so on

    		@@ -27605,9 +27626,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - mkdir ~/sisu_test -

    +
    + + 43.2 Document markup directory +

    @@ -27618,8 +27640,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - cd ~/sisu_test +

    + 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:

    		@@ -27632,7 +27654,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - cp -a /usr/share/doc/sisu/sisu_markup_samples/dfsg/* ~/sisu_test/. + mkdir ~/sisu_test

    		@@ -27644,8 +27666,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - Tip: the markup syntax examples may be of interest +

    + cd ~/sisu_test

    		@@ -27658,7 +27680,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sample/> + cp -a /usr/share/doc/sisu/sisu_markup_samples/dfsg/* ~/sisu_test/.

    		@@ -27671,7 +27693,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Tip: + Tip: the markup syntax examples may be of interest

    		@@ -27684,7 +27706,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu -U [sisu markup filename] + <http://www.jus.uio.no/sisu/sample/>

    		@@ -27697,7 +27719,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - should printout the different possible outputs and where sisu would place them. + Tip:

    		@@ -27709,8 +27731,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - Tip: if you want to toggle ansi color add +

    + sisu -U [sisu markup filename]

    		@@ -27722,8 +27744,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - c +

    + should printout the different possible outputs and where sisu would place them.

    		@@ -27736,7 +27758,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - to your flags. + Tip: if you want to toggle ansi color add

    		@@ -27748,10 +27770,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 43.2.1 Configuration files -
    +

    + c +

    @@ -27763,7 +27784,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - SiSU configuration file search path is: + to your flags.

    		@@ -27775,9 +27796,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - ./_sisu/sisurc.yaml -

    +
    + + 43.2.1 Configuration files +

    @@ -27788,8 +27810,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - ~/.sisu/sisurc.yaml +

    + SiSU configuration file search path is:

    		@@ -27802,7 +27824,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /etc/sisu/sisurc.yaml + ./_sisu/sisurc.yaml

    		@@ -27814,8 +27836,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - .\"%% Debian Installation Note +

    + ~/.sisu/sisurc.yaml

    		@@ -27827,10 +27849,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 43.2.2 Debian INSTALLATION Note -
    +

    + /etc/sisu/sisurc.yaml +

    @@ -27842,7 +27863,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - It is best you see + .\"%% Debian Installation Note

    		@@ -27854,9 +27875,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://www.jus.uio.no/sisu/SiSU/download.html#debian> -

    +
    + + 43.2.2 Debian INSTALLATION Note +

    @@ -27868,7 +27890,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - for up the most up to date information. + It is best you see

    		@@ -27880,8 +27902,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - notes taken from the Debian control file (end edited), gives an idea of additional packages that SiSU can make use of if available, (the use/requirement of some of which are interdependent for specific actions by SiSU): +

    + <http://www.jus.uio.no/sisu/SiSU/download.html#debian>

    		@@ -27894,7 +27916,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Package: sisu + for up the most up to date information.

    		@@ -27907,7 +27929,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - SiSU is a lightweight markup based, command line oriented, document structuring, publishing and search framework for document collections. + notes taken from the Debian control file (end edited), gives an idea of additional packages that SiSU can make use of if available, (the use/requirement of some of which are interdependent for specific actions by SiSU):

    		@@ -27920,7 +27942,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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. + Package: sisu

    		@@ -27933,7 +27955,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - SiSU also provides concordance files, document content certificates and manifests of generated output. + SiSU is a lightweight markup based, command line oriented, document structuring, publishing and search framework for document collections.

    		@@ -27946,7 +27968,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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. + 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.

    		@@ -27959,7 +27981,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man pages, and interactive help are provided. + SiSU also provides concordance files, document content certificates and manifests of generated output.

    		@@ -27972,7 +27994,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Dependencies for various features are taken care of in sisu related packages. The package sisu-complete installs the whole of SiSU. + 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.

    		@@ -27985,7 +28007,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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. + man pages, and interactive help are provided.

    		@@ -27998,7 +28020,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Homepage: <http://www.jus.uio.no/sisu> + Dependencies for various features are taken care of in sisu related packages. The package sisu-complete installs the whole of SiSU.

    		@@ -28010,10 +28032,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 43.2.3 Document Resource Configuration -
    +

    + 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. +

    @@ -28025,7 +28046,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu resource configuration information is obtained from sources (where they exist): + Homepage: <http://www.jus.uio.no/sisu>

    		@@ -28037,9 +28058,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - ~/.sisu/sisurc.yaml -

    +
    + + 43.2.3 Document Resource Configuration +

    @@ -28050,8 +28072,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - /etc/sisu/[sisu version]/sisurc.yaml +

    + sisu resource configuration information is obtained from sources (where they exist):

    		@@ -28064,7 +28086,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu program defaults + ~/.sisu/sisurc.yaml

    		@@ -28076,10 +28098,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 43.2.4 Skins -
    +

    + /etc/sisu/[sisu version]/sisurc.yaml +

    @@ -28090,8 +28111,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - Skins default document appearance may be modified using skins contained in sub-directories located at the following paths: +

    + sisu program defaults

    		@@ -28103,9 +28124,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - ./_sisu/skin -

    +
    + + 43.2.4 Skins +

    @@ -28116,8 +28138,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - ~/.sisu/skin +

    + Skins default document appearance may be modified using skins contained in sub-directories located at the following paths:

    		@@ -28130,7 +28152,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /etc/sisu/skin + ./_sisu/skin

    		@@ -28142,8 +28164,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - more specifically, the following locations (or their /etc/sisu equivalent) should be used: +

    + ~/.sisu/skin

    		@@ -28156,7 +28178,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - ~/.sisu/skin/doc + /etc/sisu/skin

    		@@ -28169,7 +28191,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - skins for individual documents; + more specifically, the following locations (or their /etc/sisu equivalent) should be used:

    		@@ -28182,7 +28204,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - ~/.sisu/skin/dir + ~/.sisu/skin/doc

    		@@ -28195,7 +28217,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - skins for directories of matching names; + skins for individual documents;

    		@@ -28208,7 +28230,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - ~/.sisu/skin/site + ~/.sisu/skin/dir

    		@@ -28221,7 +28243,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - site-wide skin modifying the site-wide appearance of documents. + skins for directories of matching names;

    		@@ -28233,8 +28255,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - Usually all skin files are placed in the document skin directory: +

    + ~/.sisu/skin/site

    		@@ -28246,8 +28268,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - ~/.sisu/skin/doc +

    + site-wide skin modifying the site-wide appearance of documents.

    		@@ -28260,7 +28282,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - with softlinks being made to the skins contained there from other skin directories as required. + Usually all skin files are placed in the document skin directory:

    		@@ -28272,10 +28294,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - - 44. FAQ - Frequently Asked/Answered Questions -

    +

    + ~/.sisu/skin/doc +

    @@ -28286,10 +28307,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 44.1 Why are urls produced with the -v (and -u) flag that point to a web server on port 8081? -
    +

    + with softlinks being made to the skins contained there from other skin directories as required. +

    @@ -28300,9 +28320,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - Try the following rune: -

    +

    + + 44. FAQ - Frequently Asked/Answered Questions +

    @@ -28313,9 +28334,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - sisu -W -
    • +
    + + 44.1 Why are urls produced with the -v (and -u) flag that point to a web server on port 8081? +

    @@ -28327,7 +28349,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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. + Try the following rune:

    		@@ -28339,10 +28361,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 44.2 I cannot find my output, where is it? -
    +
  • + sisu -W +

    • @@ -28354,7 +28375,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - The following should provide help on output paths: + 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.

    		@@ -28366,9 +28387,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - sisu --help env -
    • +
    + + 44.2 I cannot find my output, where is it? +

    @@ -28379,9 +28401,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - sisu -V [same as the previous command] -
    • +

    + The following should provide help on output paths: +

    @@ -28393,7 +28415,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
  • - sisu --help directory + sisu --help env
    		• @@ -28406,7 +28428,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
  • - sisu --help path + sisu -V [same as the previous command]
    		• @@ -28419,7 +28441,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
  • - sisu -U [filename] + sisu --help directory
    		• @@ -28432,7 +28454,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
  • - man sisu + sisu --help path
    		• @@ -28444,10 +28466,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 44.3 I do not get any pdf output, why? -
    +
  • + sisu -U [filename] +

    • @@ -28458,9 +28479,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - SiSU produces LaTeX and pdflatex is run against that to generate pdf files. -

    +
  • + man sisu +

    • @@ -28471,9 +28492,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - If you use Debian the following will install the required dependencies -

    +
    + + 44.3 I do not get any pdf output, why? +

    @@ -28484,9 +28506,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - aptitude install sisu-pdf -
    • +

    + SiSU produces LaTeX and pdflatex is run against that to generate pdf files. +

    @@ -28498,7 +28520,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - the following packages are required: tetex-bin, tetex-extra, latex-ucs + If you use Debian the following will install the required dependencies

    		@@ -28510,10 +28532,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 44.4 Where is the latex (or some other interim) output? -
    +
  • + aptitude install sisu-pdf +

    • @@ -28525,7 +28546,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Try adding -M (for maintenance) to your command flags, e.g.: + the following packages are required: tetex-bin, tetex-extra, latex-ucs

    		@@ -28537,9 +28558,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - sisu -HpMv [filename] -
    • +
    + + 44.4 Where is the latex (or some other interim) output? +

    @@ -28551,7 +28573,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - this should result in the interim processing output being retained, and information being provided on where to find it. + Try adding -M (for maintenance) to your command flags, e.g.:

    		@@ -28564,7 +28586,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
  • - sisu --help directory + sisu -HpMv [filename]
    		• @@ -28576,9 +28598,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - sisu --help path -
    • +

    + this should result in the interim processing output being retained, and information being provided on where to find it. +

    @@ -28589,9 +28611,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - should also provide some relevant information as to where it is placed. -

    +
  • + sisu --help directory +

    • @@ -28602,10 +28624,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 44.5 Why isn't SiSU markup XML -
    +
  • + sisu --help path +

    • @@ -28617,7 +28638,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - I worked with text and (though I find XML immensely valuable) disliked noise ... better to sidestep the question and say: + should also provide some relevant information as to where it is placed.

    		@@ -28629,9 +28650,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - SiSU currently "understands" three XML input representations - or more accurately, converts from three forms of XML to native 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 SiSU VERSION CONVERSION -

    +
    + + 44.5 Why isn't SiSU markup XML +

    @@ -28642,8 +28664,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - sisu --to-sax [filename/wildcard] +

    + I worked with text and (though I find XML immensely valuable) disliked noise ... better to sidestep the question and say:

    		@@ -28655,8 +28677,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - sisu --to-dom [filename/wildcard] +

    + SiSU currently "understands" three XML input representations - or more accurately, converts from three forms of XML to native 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 SiSU VERSION CONVERSION

    		@@ -28669,7 +28691,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu --to-node [filename/wildcard] + sisu --to-sax [filename/wildcard]

    		@@ -28681,8 +28703,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - 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 SiSU markup]. +

    + sisu --to-dom [filename/wildcard]

    		@@ -28695,7 +28717,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - sisu --from-xml2sst [filename/wildcard] + sisu --to-node [filename/wildcard]

    		@@ -28707,10 +28729,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 44.6 LaTeX claims to be a document preparation system for high-quality typesetting. Can the same be said about SiSU? -
    +

    + 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 SiSU markup]. +

    @@ -28721,8 +28742,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - SiSU is not really about type-setting. +

    + sisu --from-xml2sst [filename/wildcard]

    		@@ -28734,9 +28755,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - LaTeX is the ultimate computer instruction type-setting language for paper based publication. -

    +
    + + 44.6 LaTeX claims to be a document preparation system for high-quality typesetting. Can the same be said about SiSU? +

    @@ -28748,7 +28770,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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. + SiSU is not really about type-setting.

    		@@ -28761,7 +28783,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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. + LaTeX is the ultimate computer instruction type-setting language for paper based publication.

    		@@ -28774,7 +28796,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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 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. + 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.

    		@@ -28787,7 +28809,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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. + 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.

    		@@ -28800,7 +28822,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Where there are large document sets, it provides consistency in appearance in each output format for the documents. + 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 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.

    		@@ -28813,7 +28835,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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 SiSU tries to achieve this from minimal markup. + 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.

    		@@ -28825,10 +28847,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 44.7 How do I create GIN or GiST index in Postgresql for use in SiSU -
    +

    + Where there are large document sets, it provides consistency in appearance in each output format for the documents. +

    @@ -28840,7 +28861,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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: + 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 SiSU tries to achieve this from minimal markup.

    		@@ -28852,9 +28873,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - "I have tsearch2 slides which introduces tsearch2 <http://www.sai.msu.su/~megera/wiki/tsearch2slides> -

    +
    + + 44.7 How do I create GIN or GiST index in Postgresql for use in SiSU +

    @@ -28866,7 +28888,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - FTS in PostgreSQL is provided by tsearch2, which should works without any indices (GiST or GIN) ! Indices provide performance, not functionality. + 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:

    		@@ -28879,7 +28901,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - In your example I'd do ( simple way, just for demo): + "I have tsearch2 slides which introduces tsearch2 <http://www.sai.msu.su/~megera/wiki/tsearch2slides>

    		@@ -28892,7 +28914,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 0. compile, install tsearch2 and load tsearch2 into your database + FTS in PostgreSQL is provided by tsearch2, which should works without any indices (GiST or GIN) ! Indices provide performance, not functionality.

    		@@ -28904,8 +28926,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - cd contrib/tsearch2; make&&make&&install&&make installcheck; psql DB < tsearch2.sql +

    + In your example I'd do ( simple way, just for demo):

    		@@ -28918,7 +28940,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 1. Add column fts, which holds tsvector + 0. compile, install tsearch2 and load tsearch2 into your database

    		@@ -28931,7 +28953,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - alter table documents add column fts tsvector; + cd contrib/tsearch2; make&&make&&install&&make installcheck; psql DB < tsearch2.sql

    		@@ -28944,7 +28966,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 2. Fill fts column + 1. Add column fts, which holds tsvector

    		@@ -28957,7 +28979,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - update document set fts = to_tsvector(clean); + alter table documents add column fts tsvector;

    		@@ -28970,7 +28992,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 3. create index - just for performance ! + 2. Fill fts column

    		@@ -28983,7 +29005,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - create index fts_gin_idx on document using gin(fts); + update document set fts = to_tsvector(clean);

    		@@ -28996,7 +29018,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 4. Run vacuum + 3. create index - just for performance !

    		@@ -29009,7 +29031,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - vacuum analyze document; + create index fts_gin_idx on document using gin(fts);

    		@@ -29022,7 +29044,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - That's all. + 4. Run vacuum

    		@@ -29034,8 +29056,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - Now you can search: +

    + vacuum analyze document;

    		@@ -29048,7 +29070,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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; + That's all.

    		@@ -29060,10 +29082,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 44.8 Where is version 1.0? -
    +

    + Now you can search: +

    @@ -29075,7 +29096,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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. + 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;

    		@@ -29087,9 +29108,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - The feature set for html,  110  LaTeX/pdf and opendocument is in place. XML, and plaintext are in order. -

    +
    + + 44.8 Where is version 1.0? +

    @@ -29101,7 +29123,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - html and LaTeX/pdf may be regarded as reference copy outputs + 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.

    		@@ -29114,7 +29136,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - With regard to the populating of sql databases (postgresql and sqlite), there is a bit to be done. + The feature set for html,  110  LaTeX/pdf and opendocument is in place. XML, and plaintext are in order.

    		@@ -29127,7 +29149,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - We are still almost there. + html and LaTeX/pdf may be regarded as reference copy outputs

    		@@ -29139,10 +29161,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - - 45. Editor Files, Syntax Highlighting -

    +

    + With regard to the populating of sql databases (postgresql and sqlite), there is a bit to be done. +

    @@ -29154,7 +29175,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - The directory: + We are still almost there.

    		@@ -29166,9 +29187,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - ./data/sisu/conf/editor-syntax-etc/ -

    +

    + + 45. Editor Files, Syntax Highlighting +

    @@ -29179,8 +29201,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - /usr/share/sisu/conf/editor-syntax-etc +

    + The directory:

    		@@ -29192,8 +29214,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - contains rudimentary sisu syntax highlighting files for: +

    + ./data/sisu/conf/editor-syntax-etc/

    		@@ -29205,9 +29227,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - (g)vim <http://www.vim.org> -
    • +

    + /usr/share/sisu/conf/editor-syntax-etc +

    @@ -29218,8 +29240,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - package: sisu-vim +

    + contains rudimentary sisu syntax highlighting files for:

    		@@ -29231,9 +29253,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - status: largely done -

    +
  • + (g)vim <http://www.vim.org> +

    • @@ -29245,7 +29267,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - there is a vim syntax highlighting and folds component + package: sisu-vim

    		@@ -29257,9 +29279,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - gedit <http://www.gnome.org/projects/gedit> -
    • +

    + status: largely done +

    @@ -29270,9 +29292,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - gobby <http://gobby.0x539.de/> -
    • +

    + there is a vim syntax highlighting and folds component +

    @@ -29283,9 +29305,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - file: sisu.lang -

    +
  • + gedit <http://www.gnome.org/projects/gedit> +

    • @@ -29296,9 +29318,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - place in: -

    +
  • + gobby <http://gobby.0x539.de/> +

    • @@ -29310,7 +29332,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/gtksourceview-1.0/language-specs + file: sisu.lang

    		@@ -29323,7 +29345,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - or + place in:

    		@@ -29336,7 +29358,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - ~/.gnome2/gtksourceview-1.0/language-specs + /usr/share/gtksourceview-1.0/language-specs

    		@@ -29348,8 +29370,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - status: very basic syntax highlighting +

    + or

    		@@ -29362,7 +29384,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - comments: this editor features display line wrap and is used by Goby! + ~/.gnome2/gtksourceview-1.0/language-specs

    		@@ -29374,9 +29396,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - nano <http://www.nano-editor.org> -
    • +

    + status: very basic syntax highlighting +

    @@ -29388,7 +29410,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - file: nanorc + comments: this editor features display line wrap and is used by Goby!

    		@@ -29400,9 +29422,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - save as: -

    +
  • + nano <http://www.nano-editor.org> +

    • @@ -29414,7 +29436,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - ~/.nanorc + file: nanorc

    		@@ -29426,8 +29448,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - status: basic syntax highlighting +

    + save as:

    		@@ -29440,7 +29462,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - comments: assumes dark background; no display line-wrap; does line breaks + ~/.nanorc

    		@@ -29452,9 +29474,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - diakonos (an editor written in ruby) <http://purepistos.net/diakonos> -
    • +

    + status: basic syntax highlighting +

    @@ -29465,8 +29487,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - file: diakonos.conf +

    + comments: assumes dark background; no display line-wrap; does line breaks

    		@@ -29478,9 +29500,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - save as: -

    +
  • + diakonos (an editor written in ruby) <http://purepistos.net/diakonos> +

    • @@ -29491,8 +29513,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - ~/.diakonos/diakonos.conf +

    + file: diakonos.conf

    		@@ -29505,7 +29527,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - includes: + save as:

    		@@ -29518,7 +29540,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - status: basic syntax highlighting + ~/.diakonos/diakonos.conf

    		@@ -29531,7 +29553,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - comments: assumes dark background; no display line-wrap + includes:

    		@@ -29543,9 +29565,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - kate & kwrite <http://kate.kde.org> -
    • +

    + status: basic syntax highlighting +

    @@ -29556,8 +29578,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - file: sisu.xml +

    + comments: assumes dark background; no display line-wrap

    		@@ -29569,9 +29591,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - place in: -

    +
  • + kate & kwrite <http://kate.kde.org> +

    • @@ -29582,8 +29604,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - /usr/share/apps/katepart/syntax +

    + file: sisu.xml

    		@@ -29596,7 +29618,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - or + place in:

    		@@ -29609,7 +29631,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - ~/.kde/share/apps/katepart/syntax + /usr/share/apps/katepart/syntax

    		@@ -29622,7 +29644,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - [settings::configure kate::{highlighting,filetypes}] + or

    		@@ -29634,8 +29656,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - [tools::highlighting::{markup,scripts}::SiSU] +

    + ~/.kde/share/apps/katepart/syntax

    		@@ -29647,9 +29669,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - nedit <http://www.nedit.org> -
    • +

    + [settings::configure kate::{highlighting,filetypes}] +

    @@ -29661,7 +29683,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - file: sisu_nedit.pats + [tools::highlighting::{markup,scripts}::SiSU]

    		@@ -29673,9 +29695,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - nedit -import sisu_nedit.pats -

    +
  • + nedit <http://www.nedit.org> +

    • @@ -29687,7 +29709,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - status: a very clumsy first attempt [not really done] + file: sisu_nedit.pats

    		@@ -29700,7 +29722,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - comments: this editor features display line wrap + nedit -import sisu_nedit.pats

    		@@ -29712,9 +29734,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - emacs <http://www.gnu.org/software/emacs/emacs.html> -
    • +

    + status: a very clumsy first attempt [not really done] +

    @@ -29726,7 +29748,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - files: sisu-mode.el + comments: this editor features display line wrap

    		@@ -29738,9 +29760,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - to file ~/.emacs add the following 2 lines: -

    +
  • + emacs <http://www.gnu.org/software/emacs/emacs.html> +

    • @@ -29751,8 +29773,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - (add-to-list 'load-path "/usr/share/sisu-examples/config/syntax_hi") +

    + files: sisu-mode.el

    		@@ -29764,8 +29786,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - (require 'sisu-mode.el) +

    + to file ~/.emacs add the following 2 lines:

    		@@ -29777,8 +29799,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - [not done / not yet included] +

    + (add-to-list 'load-path "/usr/share/sisu-examples/config/syntax_hi")

    		@@ -29790,9 +29812,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
  • - vim & gvim <http://www.vim.org> -
    • +

    + (require 'sisu-mode.el) +

    @@ -29804,7 +29826,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - files: + [not done / not yet included]

    		@@ -29816,9 +29838,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - 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) -

    +
  • + vim & gvim <http://www.vim.org> +

    • @@ -29830,7 +29852,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - status: this includes: syntax highlighting; vim folds; some error checking + files:

    		@@ -29843,7 +29865,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - comments: this editor features display line wrap + 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)

    		@@ -29855,8 +29877,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - NOTE: +

    + status: this includes: syntax highlighting; vim folds; some error checking

    		@@ -29868,8 +29890,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - [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] +

    + comments: this editor features display line wrap

    		@@ -29881,10 +29903,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - - 46. Help Sources -

    +

    + NOTE: +

    @@ -29896,7 +29917,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - For a summary of alternative ways to get help on SiSU try one of the following: + [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]

    		@@ -29908,9 +29929,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - man page -

    +

    + + 46. Help Sources +

    @@ -29921,8 +29943,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - man sisu_help +

    + For a summary of alternative ways to get help on SiSU try one of the following:

    		@@ -29935,7 +29957,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man2html + man page

    		@@ -29948,7 +29970,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <file:///usr/share/doc/sisu/html/sisu_help.1.html> + man sisu_help

    		@@ -29960,8 +29982,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://www.jus.uio.no/sisu/man/sisu_help.1.html> +

    + man2html

    		@@ -29973,8 +29995,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - sisu generated output - links to html +

    + <file:///usr/share/doc/sisu/html/sisu_help.1.html>

    		@@ -29987,7 +30009,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html> + <http://www.jus.uio.no/sisu/man/sisu_help.1.html>

    		@@ -29999,8 +30021,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://sisudoc.org/sisu_manual/sisu_help/index.html> +

    + sisu generated output - links to html

    		@@ -30013,7 +30035,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html> + <file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html>

    		@@ -30025,8 +30047,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - help sources lists +

    + <http://sisudoc.org/sisu_manual/sisu_help/index.html>

    		@@ -30038,8 +30060,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - Alternative sources for this help sources page listed here: +

    + <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html>

    		@@ -30051,8 +30073,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - man sisu_help_sources +

    + help sources lists

    		@@ -30064,8 +30086,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html> +

    + Alternative sources for this help sources page listed here:

    		@@ -30078,7 +30100,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <file:///usr/share/doc/sisu/html/sisu_help_sources/index.html> + man sisu_help_sources

    		@@ -30091,7 +30113,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html> + <file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html>

    		@@ -30104,7 +30126,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html> + <file:///usr/share/doc/sisu/html/sisu_help_sources/index.html>

    		@@ -30116,10 +30138,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 46.1 man pages -
    +

    + <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html> +

    @@ -30130,10 +30151,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 46.1.1 man -
    +

    + <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html> +

    @@ -30144,9 +30164,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - man sisu -

    +
    + + 46.1 man pages +

    @@ -30157,9 +30178,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - man sisu_commands -

    +
    + + 46.1.1 man +

    @@ -30171,7 +30193,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man 7 sisu_complete + man sisu

    		@@ -30184,7 +30206,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man sisu_configuration + man sisu_commands

    		@@ -30197,7 +30219,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man 8 sisu_faq + man 7 sisu_complete

    		@@ -30210,7 +30232,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man sisu_filetypes + man sisu_configuration

    		@@ -30223,7 +30245,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man sisu_help + man 8 sisu_faq

    		@@ -30236,7 +30258,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man sisu_help_sources + man sisu_filetypes

    		@@ -30249,7 +30271,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man 8 sisu_howto + man sisu_help

    		@@ -30262,7 +30284,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man sisu_introduction + man sisu_help_sources

    		@@ -30275,7 +30297,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man sisu_markup + man 8 sisu_howto

    		@@ -30288,7 +30310,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man sisu_output_overview + man sisu_introduction

    		@@ -30301,7 +30323,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man 7 sisu_pdf + man sisu_markup

    		@@ -30314,7 +30336,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man 7 sisu_postgresql + man sisu_output_overview

    		@@ -30327,7 +30349,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man 8 sisu_quickstart + man 7 sisu_pdf

    		@@ -30340,7 +30362,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man 8 sisu_remote + man 7 sisu_postgresql

    		@@ -30353,7 +30375,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man 8 sisu_search + man 8 sisu_quickstart

    		@@ -30366,7 +30388,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man sisu_skin + man 8 sisu_remote

    		@@ -30379,7 +30401,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man 7 sisu_sqlite + man 8 sisu_search

    		@@ -30392,7 +30414,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man 8 sisu_syntax_highlighting + man sisu_skin

    		@@ -30405,7 +30427,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man 7 sisu_vim + man 7 sisu_sqlite

    		@@ -30418,7 +30440,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - man sisu_webrick + man 8 sisu_syntax_highlighting

    		@@ -30430,10 +30452,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 46.2 sisu generated output - links to html -
    +

    + man 7 sisu_vim +

    @@ -30444,8 +30465,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - Note SiSU documentation is prepared in 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  111  +

    + man sisu_webrick

    		@@ -30457,10 +30478,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 46.2.1 locally installed -
    +
    + + 46.2 sisu generated output - links to html +

    @@ -30472,7 +30493,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <file:///usr/share/doc/sisu/sisu_manual/sisu_manual/index.html> + Note SiSU documentation is prepared in 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  111 

    		@@ -30484,9 +30505,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html> -

    +
    + + 46.2.1 locally installed +

    @@ -30498,7 +30520,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html> + <file:///usr/share/doc/sisu/sisu_manual/sisu_manual/index.html>

    		@@ -30510,8 +30532,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - /usr/share/doc/sisu/sisu_manual/sisu/index.html +

    + <file:///usr/share/doc/sisu/sisu_manual/sisu_help/index.html>

    		@@ -30523,8 +30545,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - /usr/share/doc/sisu/sisu_manual/sisu_commands/index.html +

    + <file:///usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html>

    		@@ -30537,7 +30559,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_complete/index.html + /usr/share/doc/sisu/sisu_manual/sisu/index.html

    		@@ -30550,7 +30572,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_configuration/index.html + /usr/share/doc/sisu/sisu_manual/sisu_commands/index.html

    		@@ -30563,7 +30585,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_description/index.html + /usr/share/doc/sisu/sisu_manual/sisu_complete/index.html

    		@@ -30576,7 +30598,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_examples/index.html + /usr/share/doc/sisu/sisu_manual/sisu_configuration/index.html

    		@@ -30589,7 +30611,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_faq/index.html + /usr/share/doc/sisu/sisu_manual/sisu_description/index.html

    		@@ -30602,7 +30624,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_filetypes/index.html + /usr/share/doc/sisu/sisu_manual/sisu_examples/index.html

    		@@ -30615,7 +30637,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_help/index.html + /usr/share/doc/sisu/sisu_manual/sisu_faq/index.html

    		@@ -30628,7 +30650,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html + /usr/share/doc/sisu/sisu_manual/sisu_filetypes/index.html

    		@@ -30641,7 +30663,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_howto/index.html + /usr/share/doc/sisu/sisu_manual/sisu_help/index.html

    		@@ -30654,7 +30676,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_introduction/index.html + /usr/share/doc/sisu/sisu_manual/sisu_help_sources/index.html

    		@@ -30667,7 +30689,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_manual/index.html + /usr/share/doc/sisu/sisu_manual/sisu_howto/index.html

    		@@ -30680,7 +30702,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_markup/index.html + /usr/share/doc/sisu/sisu_manual/sisu_introduction/index.html

    		@@ -30693,7 +30715,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_output_overview/index.html + /usr/share/doc/sisu/sisu_manual/sisu_manual/index.html

    		@@ -30706,7 +30728,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_pdf/index.html + /usr/share/doc/sisu/sisu_manual/sisu_markup/index.html

    		@@ -30719,7 +30741,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_postgresql/index.html + /usr/share/doc/sisu/sisu_manual/sisu_output_overview/index.html

    		@@ -30732,7 +30754,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_quickstart/index.html + /usr/share/doc/sisu/sisu_manual/sisu_pdf/index.html

    		@@ -30745,7 +30767,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_remote/index.html + /usr/share/doc/sisu/sisu_manual/sisu_postgresql/index.html

    		@@ -30758,7 +30780,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_search/index.html + /usr/share/doc/sisu/sisu_manual/sisu_quickstart/index.html

    		@@ -30771,7 +30793,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_skin/index.html + /usr/share/doc/sisu/sisu_manual/sisu_remote/index.html

    		@@ -30784,7 +30806,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_sqlite/index.html + /usr/share/doc/sisu/sisu_manual/sisu_search/index.html

    		@@ -30797,7 +30819,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_syntax_highlighting/index.html + /usr/share/doc/sisu/sisu_manual/sisu_skin/index.html

    		@@ -30810,7 +30832,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_vim/index.html + /usr/share/doc/sisu/sisu_manual/sisu_sqlite/index.html

    		@@ -30823,7 +30845,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/sisu_manual/sisu_webrick/index.html + /usr/share/doc/sisu/sisu_manual/sisu_syntax_highlighting/index.html

    		@@ -30835,10 +30857,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 46.2.2 www.sisudoc.org -
    +

    + /usr/share/doc/sisu/sisu_manual/sisu_vim/index.html +

    @@ -30849,8 +30870,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://sisudoc.org/sisu_manual/sisu_manual/index.html> +

    + /usr/share/doc/sisu/sisu_manual/sisu_webrick/index.html

    		@@ -30862,9 +30883,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://sisudoc.org/sisu_manual/sisu/index.html> -

    +
    + + 46.2.2 www.sisudoc.org +

    @@ -30875,8 +30897,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://sisudoc.org/sisu_manual/sisu_commands/index.html> +

    + <http://sisudoc.org/sisu_manual/sisu_manual/index.html>

    		@@ -30889,7 +30911,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_complete/index.html> + <http://sisudoc.org/sisu_manual/sisu/index.html>

    		@@ -30902,7 +30924,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_configuration/index.html> + <http://sisudoc.org/sisu_manual/sisu_commands/index.html>

    		@@ -30915,7 +30937,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_description/index.html> + <http://sisudoc.org/sisu_manual/sisu_complete/index.html>

    		@@ -30928,7 +30950,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_examples/index.html> + <http://sisudoc.org/sisu_manual/sisu_configuration/index.html>

    		@@ -30941,7 +30963,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_faq/index.html> + <http://sisudoc.org/sisu_manual/sisu_description/index.html>

    		@@ -30954,7 +30976,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_filetypes/index.html> + <http://sisudoc.org/sisu_manual/sisu_examples/index.html>

    		@@ -30967,7 +30989,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_help/index.html> + <http://sisudoc.org/sisu_manual/sisu_faq/index.html>

    		@@ -30980,7 +31002,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html> + <http://sisudoc.org/sisu_manual/sisu_filetypes/index.html>

    		@@ -30993,7 +31015,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_howto/index.html> + <http://sisudoc.org/sisu_manual/sisu_help/index.html>

    		@@ -31006,7 +31028,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_introduction/index.html> + <http://sisudoc.org/sisu_manual/sisu_help_sources/index.html>

    		@@ -31019,7 +31041,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_manual/index.html> + <http://sisudoc.org/sisu_manual/sisu_howto/index.html>

    		@@ -31032,7 +31054,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_markup/index.html> + <http://sisudoc.org/sisu_manual/sisu_introduction/index.html>

    		@@ -31045,7 +31067,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_output_overview/index.html> + <http://sisudoc.org/sisu_manual/sisu_manual/index.html>

    		@@ -31058,7 +31080,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_pdf/index.html> + <http://sisudoc.org/sisu_manual/sisu_markup/index.html>

    		@@ -31071,7 +31093,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_postgresql/index.html> + <http://sisudoc.org/sisu_manual/sisu_output_overview/index.html>

    		@@ -31084,7 +31106,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_quickstart/index.html> + <http://sisudoc.org/sisu_manual/sisu_pdf/index.html>

    		@@ -31097,7 +31119,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_remote/index.html> + <http://sisudoc.org/sisu_manual/sisu_postgresql/index.html>

    		@@ -31110,7 +31132,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_search/index.html> + <http://sisudoc.org/sisu_manual/sisu_quickstart/index.html>

    		@@ -31123,7 +31145,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_skin/index.html> + <http://sisudoc.org/sisu_manual/sisu_remote/index.html>

    		@@ -31136,7 +31158,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_sqlite/index.html> + <http://sisudoc.org/sisu_manual/sisu_search/index.html>

    		@@ -31149,7 +31171,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_syntax_highlighting/index.html> + <http://sisudoc.org/sisu_manual/sisu_skin/index.html>

    		@@ -31162,7 +31184,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_vim/index.html> + <http://sisudoc.org/sisu_manual/sisu_sqlite/index.html>

    		@@ -31175,7 +31197,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/sisu_manual/sisu_webrick/index.html> + <http://sisudoc.org/sisu_manual/sisu_syntax_highlighting/index.html>

    		@@ -31187,10 +31209,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 46.2.3 www.jus.uio.no/sisu -
    +

    + <http://sisudoc.org/sisu_manual/sisu_vim/index.html> +

    @@ -31201,8 +31222,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html> +

    + <http://sisudoc.org/sisu_manual/sisu_webrick/index.html>

    		@@ -31214,9 +31235,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu/index.html> -

    +
    + + 46.2.3 www.jus.uio.no/sisu +

    @@ -31227,8 +31249,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/index.html> +

    + <http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html>

    		@@ -31241,7 +31263,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_complete/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu/index.html>

    		@@ -31254,7 +31276,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_commands/index.html>

    		@@ -31267,7 +31289,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_description/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_complete/index.html>

    		@@ -31280,7 +31302,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_examples/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_configuration/index.html>

    		@@ -31293,7 +31315,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_description/index.html>

    		@@ -31306,7 +31328,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_filetypes/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_examples/index.html>

    		@@ -31319,7 +31341,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_faq/index.html>

    		@@ -31332,7 +31354,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_filetypes/index.html>

    		@@ -31345,7 +31367,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_help/index.html>

    		@@ -31358,7 +31380,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_introduction/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_help_sources/index.html>

    		@@ -31371,7 +31393,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_howto/index.html>

    		@@ -31384,7 +31406,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_introduction/index.html>

    		@@ -31397,7 +31419,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_output_overview/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_manual/index.html>

    		@@ -31410,7 +31432,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_pdf/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_markup/index.html>

    		@@ -31423,7 +31445,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_output_overview/index.html>

    		@@ -31436,7 +31458,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_pdf/index.html>

    		@@ -31449,7 +31471,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/index.html>

    		@@ -31462,7 +31484,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_search/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_quickstart/index.html>

    		@@ -31475,7 +31497,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_remote/index.html>

    		@@ -31488,7 +31510,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_sqlite/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_search/index.html>

    		@@ -31501,7 +31523,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_skin/index.html>

    		@@ -31514,7 +31536,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_vim/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_sqlite/index.html>

    		@@ -31527,7 +31549,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/sisu_manual/sisu_webrick/index.html> + <http://www.jus.uio.no/sisu/sisu_manual/sisu_syntax_highlighting/index.html>

    		@@ -31539,10 +31561,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 46.2.4 man2html -
    +

    + <http://www.jus.uio.no/sisu/sisu_manual/sisu_vim/index.html> +

    @@ -31553,10 +31574,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 46.2.5 locally installed -
    +

    + <http://www.jus.uio.no/sisu/sisu_manual/sisu_webrick/index.html> +

    @@ -31567,9 +31587,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <file:///usr/share/doc/sisu/html/sisu_manual.1.html> -

    +
    + + 46.2.4 man2html +

    @@ -31580,9 +31601,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <file:///usr/share/doc/sisu/html/sisu_help.1.html> -

    +
    + + 46.2.5 locally installed +

    @@ -31594,7 +31616,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <file:///usr/share/doc/sisu/html/sisu_help_sources.1.html> + <file:///usr/share/doc/sisu/html/sisu_manual.1.html>

    		@@ -31606,8 +31628,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - /usr/share/doc/sisu/html/sisu.1.html +

    + <file:///usr/share/doc/sisu/html/sisu_help.1.html>

    		@@ -31619,8 +31641,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - /usr/share/doc/sisu/html/sisu_commands.1.html +

    + <file:///usr/share/doc/sisu/html/sisu_help_sources.1.html>

    		@@ -31633,7 +31655,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/html/sisu_complete.7.html + /usr/share/doc/sisu/html/sisu.1.html

    		@@ -31646,7 +31668,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/html/sisu_configuration.1.html + /usr/share/doc/sisu/html/sisu_commands.1.html

    		@@ -31659,7 +31681,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/html/sisu_faq.8.html + /usr/share/doc/sisu/html/sisu_complete.7.html

    		@@ -31672,7 +31694,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/html/sisu_help.1.html + /usr/share/doc/sisu/html/sisu_configuration.1.html

    		@@ -31685,7 +31707,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/html/sisu_help_sources.1.html + /usr/share/doc/sisu/html/sisu_faq.8.html

    		@@ -31698,7 +31720,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/html/sisu_howto.8.html + /usr/share/doc/sisu/html/sisu_help.1.html

    		@@ -31711,7 +31733,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/html/sisu_markup.1.html + /usr/share/doc/sisu/html/sisu_help_sources.1.html

    		@@ -31724,7 +31746,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/html/sisu_pdf.7.html + /usr/share/doc/sisu/html/sisu_howto.8.html

    		@@ -31737,7 +31759,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/html/sisu_postgresql.7.html + /usr/share/doc/sisu/html/sisu_markup.1.html

    		@@ -31750,7 +31772,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/html/sisu_quickstart.8.html + /usr/share/doc/sisu/html/sisu_pdf.7.html

    		@@ -31763,7 +31785,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/html/sisu_remote.8.html + /usr/share/doc/sisu/html/sisu_postgresql.7.html

    		@@ -31776,7 +31798,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/html/sisu_search.8.html + /usr/share/doc/sisu/html/sisu_quickstart.8.html

    		@@ -31789,7 +31811,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/html/sisu_skin.1.html + /usr/share/doc/sisu/html/sisu_remote.8.html

    		@@ -31802,7 +31824,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/html/sisu_sqlite.7.html + /usr/share/doc/sisu/html/sisu_search.8.html

    		@@ -31815,7 +31837,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/html/sisu_syntax_highlighting.8.html + /usr/share/doc/sisu/html/sisu_skin.1.html

    		@@ -31828,7 +31850,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/html/sisu_vim.7.html + /usr/share/doc/sisu/html/sisu_sqlite.7.html

    		@@ -31841,7 +31863,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - /usr/share/doc/sisu/html/sisu_webrick.1.html + /usr/share/doc/sisu/html/sisu_syntax_highlighting.8.html

    		@@ -31853,10 +31875,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 46.2.6 www.sisudoc.org -
    +

    + /usr/share/doc/sisu/html/sisu_vim.7.html +

    @@ -31867,8 +31888,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http:///sisudoc.org/man/sisu_manual.1.html> +

    + /usr/share/doc/sisu/html/sisu_webrick.1.html

    		@@ -31880,9 +31901,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http:///sisudoc.org/man/sisu_help.1.html> -

    +
    + + 46.2.6 www.sisudoc.org +

    @@ -31894,7 +31916,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http:///sisudoc.org/man/sisu_help_sources.1.html> + <http:///sisudoc.org/man/sisu_manual.1.html>

    		@@ -31906,8 +31928,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://sisudoc.org/man/sisu.1.html> +

    + <http:///sisudoc.org/man/sisu_help.1.html>

    		@@ -31919,8 +31941,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://sisudoc.org/man/sisu_commands.1.html> +

    + <http:///sisudoc.org/man/sisu_help_sources.1.html>

    		@@ -31933,7 +31955,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/man/sisu_complete.7.html> + <http://sisudoc.org/man/sisu.1.html>

    		@@ -31946,7 +31968,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/man/sisu_configuration.1.html> + <http://sisudoc.org/man/sisu_commands.1.html>

    		@@ -31959,7 +31981,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/man/sisu_faq.8.html> + <http://sisudoc.org/man/sisu_complete.7.html>

    		@@ -31972,7 +31994,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/man/sisu_help.1.html> + <http://sisudoc.org/man/sisu_configuration.1.html>

    		@@ -31985,7 +32007,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/man/sisu_help_sources.1.html> + <http://sisudoc.org/man/sisu_faq.8.html>

    		@@ -31998,7 +32020,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/man/sisu_howto.8.html> + <http://sisudoc.org/man/sisu_help.1.html>

    		@@ -32011,7 +32033,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/man/sisu_markup.1.html> + <http://sisudoc.org/man/sisu_help_sources.1.html>

    		@@ -32024,7 +32046,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/man/sisu_pdf.7.html> + <http://sisudoc.org/man/sisu_howto.8.html>

    		@@ -32037,7 +32059,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/man/sisu_postgresql.7.html> + <http://sisudoc.org/man/sisu_markup.1.html>

    		@@ -32050,7 +32072,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/man/sisu_quickstart.8.html> + <http://sisudoc.org/man/sisu_pdf.7.html>

    		@@ -32063,7 +32085,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/man/sisu_remote.8.html> + <http://sisudoc.org/man/sisu_postgresql.7.html>

    		@@ -32076,7 +32098,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/man/sisu_search.8.html> + <http://sisudoc.org/man/sisu_quickstart.8.html>

    		@@ -32089,7 +32111,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/man/sisu_skin.1.html> + <http://sisudoc.org/man/sisu_remote.8.html>

    		@@ -32102,7 +32124,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/man/sisu_sqlite.7.html> + <http://sisudoc.org/man/sisu_search.8.html>

    		@@ -32115,7 +32137,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/man/sisu_syntax_highlighting.8.html> + <http://sisudoc.org/man/sisu_skin.1.html>

    		@@ -32128,7 +32150,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/man/sisu_vim.7.html> + <http://sisudoc.org/man/sisu_sqlite.7.html>

    		@@ -32141,7 +32163,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://sisudoc.org/man/sisu_webrick.1.html> + <http://sisudoc.org/man/sisu_syntax_highlighting.8.html>

    		@@ -32153,10 +32175,9 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -
    - - 46.2.7 www.jus.uio.no/sisu -
    +

    + <http://sisudoc.org/man/sisu_vim.7.html> +

    @@ -32167,8 +32188,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://www.jus.uio.no/sisu/man/sisu_manual.1.html> +

    + <http://sisudoc.org/man/sisu_webrick.1.html>

    		@@ -32180,9 +32201,10 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://www.jus.uio.no/sisu/man/sisu_help.1.html> -

    +
    + + 46.2.7 www.jus.uio.no/sisu +

    @@ -32194,7 +32216,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html> + <http://www.jus.uio.no/sisu/man/sisu_manual.1.html>

    		@@ -32206,8 +32228,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://www.jus.uio.no/sisu/man/sisu.1.html> +

    + <http://www.jus.uio.no/sisu/man/sisu_help.1.html>

    		@@ -32219,8 +32241,8 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    -

    - <http://www.jus.uio.no/sisu/man/sisu_commands.1.html> +

    + <http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html>

    		@@ -32233,7 +32255,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_complete.7.html> + <http://www.jus.uio.no/sisu/man/sisu.1.html>

    		@@ -32246,7 +32268,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_configuration.1.html> + <http://www.jus.uio.no/sisu/man/sisu_commands.1.html>

    		@@ -32259,7 +32281,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_faq.8.html> + <http://www.jus.uio.no/sisu/man/sisu_complete.7.html>

    		@@ -32272,7 +32294,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_help.1.html> + <http://www.jus.uio.no/sisu/man/sisu_configuration.1.html>

    		@@ -32285,7 +32307,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html> + <http://www.jus.uio.no/sisu/man/sisu_faq.8.html>

    		@@ -32298,7 +32320,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_howto.8.html> + <http://www.jus.uio.no/sisu/man/sisu_help.1.html>

    		@@ -32311,7 +32333,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_markup.1.html> + <http://www.jus.uio.no/sisu/man/sisu_help_sources.1.html>

    		@@ -32324,7 +32346,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_pdf.7.html> + <http://www.jus.uio.no/sisu/man/sisu_howto.8.html>

    		@@ -32337,7 +32359,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_postgresql.7.html> + <http://www.jus.uio.no/sisu/man/sisu_markup.1.html>

    		@@ -32350,7 +32372,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_quickstart.8.html> + <http://www.jus.uio.no/sisu/man/sisu_pdf.7.html>

    		@@ -32363,7 +32385,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_remote.8.html> + <http://www.jus.uio.no/sisu/man/sisu_postgresql.7.html>

    		@@ -32376,7 +32398,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_search.8.html> + <http://www.jus.uio.no/sisu/man/sisu_quickstart.8.html>

    		@@ -32389,7 +32411,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_skin.1.html> + <http://www.jus.uio.no/sisu/man/sisu_remote.8.html>

    		@@ -32402,7 +32424,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_sqlite.7.html> + <http://www.jus.uio.no/sisu/man/sisu_search.8.html>

    		@@ -32415,7 +32437,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_syntax_highlighting.8.html> + <http://www.jus.uio.no/sisu/man/sisu_skin.1.html>

    		@@ -32428,7 +32450,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_vim.7.html> + <http://www.jus.uio.no/sisu/man/sisu_sqlite.7.html>

    		@@ -32441,7 +32463,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html> + <http://www.jus.uio.no/sisu/man/sisu_syntax_highlighting.8.html>

    		@@ -32451,6 +32473,32 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but
    + + + +
    +

    + <http://www.jus.uio.no/sisu/man/sisu_vim.7.html> +

    +    		 +

    +   2331 +

    +
    + + + + +
    +

    + <http://www.jus.uio.no/sisu/man/sisu_webrick.1.html> +

    +    		 +

    +   2332 +

    +
    +

    @@ -33897,7 +33945,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Sourcefile Digest, MD5(sisu_manual._sst)= 9d1ac7473022c522b8e3c3b221615da1 + Sourcefile Digest, MD5(sisu_manual._sst)= 978fcebd89bd099b135fc44be7e8073e

    @@ -33905,7 +33953,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - 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)= 20fc43cf3eb6590bc3399a1aef65c5a9 + 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)= 20fc43cf3eb6590bc3399a1aef65c5a9

    @@ -33921,7 +33969,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Document (metaverse) last generated: Mon Sep 24 15:31:26 +0100 2007 + Document (metaverse) last generated: Tue Sep 25 02:51:58 +0100 2007

    @@ -33929,7 +33977,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but

    - Generated by: SiSU 0.59.0 of 2007w38/0 (2007-09-23) + Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)

    @@ -34033,7 +34081,7 @@ There was a young lady from Clyde,
    who ate a green apple and died,
    but     SiSU - 0.59.0 2007-09-23 (2007w38/0) + 0.59.1 2007-09-25 (2007w39/2)
    SiSU -- cgit v1.2.3