SiSU - Manual,
Ralph Amissah

  1

What is SiSU?

  2

Download

  1151

33. Download SiSU - Linux/Unix

33. Download SiSU - Linux/Unix

  1152

SiSU Current Version - Linux/Unix

  1153

Source (tarball tar.gz)

  1154

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

  1155

  1156

cgi generated sample search form

  1157

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

  1158

postgresql, character case sensitivity, control, on/off

  1159

tail decoration, gplv3 & sisu info

  1160

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

  1161

print XML rendition of document structure to screen -T

  1162

help on environment visited, sisu -V

  1163

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

  1164

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

  1165

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

  1166

  1167

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

  1168

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

  1169

Tulva, by Leena Krohn

  1170

Git (source control management)

  1171

Git repository currently at:

  1172

  1173

  1174

Debian

  1175

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

  1176

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

  1177

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

  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

  1179

Source

  1180

  1181

  1182

  1183

Debs

  1184

  1185

  1186

  1187

  1188

  1189

For changelogs see:

  1190

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

  1191

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

  1192

non-free

  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.

  1194

  1195

  1196

For changelogs see:

  1197

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

  1198

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

  1199

RPM

  1200

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

  1201

  1202

  1203

  1204

sudo rpm -i [package name]

  1205

 ^65. Breakage and Fixes Report

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

 ^66. <http://www.jus.uio.no/sisu/archive/pool/main/s/sisu/sisu_0.59.1.orig.tar.gz>

 ^67. <http://www.jus.uio.no/sisu/archive/pool/non-free/s/sisu-markup-samples/sisu-markup-samples_1.0.7.orig.tar.gz>

 ^68. Reproduced with the kind permission of author and artist Leena Krohn, <http://www.kaapeli.fi/krohn> Tulva is from the work Sphinx or Robot <http://www.jus.uio.no/sisu/sphinx_or_robot.leena_krohn.1996> other works available online include Tainaron <http://www.jus.uio.no/sisu/tainaron.leena_krohn.1998>, these two works can be found in the book sample section <http://www.jus.uio.no/sisu/SiSU/2.html#sample>

 ^69. <http://www.jus.uio.no/sisu/archive/pool/main/s/sisu/sisu_0.59.1.orig.tar.gz>

 ^70. <http://www.jus.uio.no/sisu/archive/pool/main/s/sisu/sisu_0.59.1-1.diff.gz>

 ^71. <http://www.jus.uio.no/sisu/archive/pool/main/s/sisu/sisu_0.59.1-1.dsc>

 ^72. <http://www.jus.uio.no/sisu/archive/pool/main/s/sisu/sisu_0.59.1-1_all.deb>

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

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

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

 ^73. <http://www.jus.uio.no/sisu/archive/pool/main/s/sisu/sisu-complete_0.59.1-1_all.deb>

a package that pulls in other packages to build the whole of sisu (excluding sisu-examples)

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

Recommends: sisu-examples

 ^74. <http://www.jus.uio.no/sisu/archive/pool/main/s/sisu/sisu-pdf_0.59.1-1_all.deb>

dependencies used by sisu to produce pdf from LaTeX generated

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

Suggests: evince, xpdf

 ^75. <http://www.jus.uio.no/sisu/archive/pool/main/s/sisu/sisu-postgresql_0.59.1-1_all.deb>

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

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

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

 ^76. <http://www.jus.uio.no/sisu/archive/pool/main/s/sisu/sisu-sqlite_0.59.1-1_all.deb>

dependencies used by sisu to populate sqlite database

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

Suggests: libdbd-sqlite

 ^77. <http://www.jus.uio.no/sisu/archive/pool/non-free/s/sisu-markup-samples/sisu-markup-samples_1.0.8-1_all.deb>

marked up documents and other examples related to sisu, a larger package containing a number of texts

Depends: sisu

 ^78. <http://www.jus.uio.no/sisu/archive/pool/non-free/s/sisu-markup-samples/sisu-markup-samples_1.0.8-1.dsc>

 ^79. <http://www.kitenet.net/programs/alien/>

 ^80. <http://www.jus.uio.no/sisu/pkg/rpm/sisu-0.59.1-2.noarch.rpm>

untested, created using: alien -r sisu_0.59.1-1_all.deb

 ^81. <http://www.jus.uio.no/sisu/pkg/rpm/sisu-doc-0.59.1-2.noarch.rpm>

untested, created using: alien -r sisu-doc_0.59.1-1_all.deb

 ^82. <http://www.jus.uio.no/sisu/pkg/rpm/sisu-markup-samples_1.0.6.orig-2.noarch.rpm>

untested, created using alien

Output generated by SiSU 0.59.1 2007-09-25 (2007w39/2)
SiSU Copyright ^© Ralph Amissah 1997, current 2007. All Rights Reserved.
SiSU is software for document structuring, publishing and search,
www.jus.uio.no/sisu and www.sisudoc.org
w3 since October 3 1993 ralph@amissah.com

SiSU using:
Standard SiSU markup syntax,
Standard SiSU meta-markup syntax, and the
Standard SiSU object citation numbering and system, (object/text positioning system)
Copyright ^© Ralph Amissah 1997, current 2007. All Rights Reserved.

SiSU is released under GPLv3 or later, <http://www.gnu.org/licenses/gpl.html>

SiSU, developed using Ruby on Debian/Gnu/Linux software infrastructure, with the usual GPL (or OSS) suspects.
Better - "performance, reliability, scalability, security & total cost of ownership" [not to mention flexibility & choice] use of and adherence to open standards (where practical and fair) and it is software libre.
Get With the Future Way Better!