SiSU - Manual,
Ralph Amissah

  1

What is SiSU?

  2

Installation

  1205

34. Installation

34. Installation

  1206

See the download pages   ⁸³  for information related to installation.

  1207

34.1 Debian

  1208

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

  1209

The package is divided into the following components:

  1210

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

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

  1212

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

  1213

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

  1214

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

  1215

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

  1216

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

  1217

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

  1218

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

  #/etc/apt/sources.list

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

  1220

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

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

  1222

  #Using aptitude:

    aptitude update

    aptitude install sisu-complete sisu-markup-samples

  1223

  Using apt-get

    apt-get update

    apt get install sisu-complete sisu-examples

  1224

34.2 Other Unix / Linux

  1225

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.   ⁸⁵  Information on dependencies configured for Debian is provided as this may be of assistance.

  1226

34.2.1 source tarball

  1227

installation with provided install script

  1228

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

  1229

ruby install

  1230

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

  1231

Further notes on install script.

  1232

The install script is prepared using Rant, and a Rantfile is provided,  ⁸⁷  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   ⁸⁸  installed. While in the package directory, type: rant help, or rant -T, or to install SiSU as root, type:

  1233

install is an install script prepared using Stefan Lang's Rant   ⁸⁹  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

ruby install -T

  1235

To install as root type:

  1236

ruby install

  1237

For a minimal install type:

  1238

ruby install base

  1239

installation with setup.rb

  1240

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

  1241

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

  1242

installation of rpm

  1243

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

  1244

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

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

 ^84. <http://packages.qa.debian.org/s/sisu.html>

 ^85. Notes on dependencies are provided in the section that follows

 ^86. This makes use of rant and the provided Rantfile. Note however, that additional external package dependencies, such as tetex-extra are not taken care of for you.

 ^87. a Rantfile has been configured to do post installation setup

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

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

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

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

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

 ^91. Minero Aoki

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

 ^92. Installation instructions

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

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

Output generated by SiSU 0.59.0 2007-09-23 (2007w38/0)
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!