SiSU - Manual,
Ralph Amissah

  1

What is SiSU?

  2

Installation

  1206

34. Installation

34. Installation

  1207

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

  1208

34.1 Debian

  1209

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

  1210

The package is divided into the following components:

  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

  1212

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

  1213

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

  1214

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

  1215

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

  1216

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

  1217

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

  1218

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.

  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:

  1220

  #/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

  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.

  1222

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

  1223

  #Using aptitude:

    aptitude update

    aptitude install sisu-complete sisu-markup-samples

  1224

  Using apt-get

    apt-get update

    apt get install sisu-complete sisu-examples

  1225

34.2 Other Unix / Linux

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

  1227

34.2.1 source tarball

  1228

installation with provided install script

  1229

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

  1230

ruby install

  1231

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

  1232

Further notes on install script.

  1233

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:

  1234

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:

  1235

ruby install -T

  1236

To install as root type:

  1237

ruby install

  1238

For a minimal install type:

  1239

ruby install base

  1240

installation with setup.rb

  1241

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:

  1242

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

  1243

installation of rpm

  1244

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

  1245

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