+ + + +

+ +

+ + + + + + + + + + + + + + + + + +

+ + +

+ + +

+ + +

+ + +

+ + +

+ + + A-Z + + +

+ + +

+ +

+ + + + + + +

+ +

+ + + + +

+ +

+ SiSU - SiSU information Structuring Universe +

+ Manual [0.58] +

+ Ralph Amissah + +

+ copy @ + + SiSU + +

+ + +

+ +

+ 1 +

+ + +

+ +

+ 2 +

+ + +

+ +

+ 1205 +

+ + +

+ +

+ + +

+ + 34. Installation +

+ 1206 +

+ + 34.2 Other Unix / Linux + +

+ + 34.2.1 source tarball + +

+ + +

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

+ + + +

+ +

+ + + + + + + + + + + + + + + + + +

+ + +

+ + +

+ + +

+ + +

+ + +

+ + + A-Z + + +

+ + +

+ +

+ + + + + + +

+ +

+ + + + +

+ +

+ + + + + + + + +

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

+ + + + + +

+ SiSU - SiSU information Structuring Universe - Manual [0.58],
Ralph Amissah +

+ What is SiSU? +

+ Installation +

+ 34. Installation +

+ + 34. Installation +

+ + 34.1 Debian + +

+ + 34.2 Other Unix / Linux + +

+ + 34.2.1 source tarball + +

+ SiSU - SiSU information Structuring Universe - Manual [0.58], Ralph Amissah +

+ What is SiSU? +

+ Installation +

+ 34. Installation +

+ + 34. Installation +

+ + 34.1 Debian + +

+ + 34.2 Other Unix / Linux + +

+ + 34.2.1 source tarball + +

+ SiSU - SiSU information Structuring Universe - Manual [0.58],
Ralph Amissah +