Installationsanleitung fuer TeX mit SiSiSi-Silbentrennung unter UNIX
    ====================================================================


Die vorliegende Anleitung beschreibt das Installieren der beiden Varianten

                   SiTeX (einfache Silbentrennung)
            und   iSiTeX (interaktive Variante)

der `sicheren sinnentsprechenden Silbentrennung' (SiSiSi) fuer TeX3.14 oder
TeX3.141 unter UNIX. (Wenn Sie LaTeX statt TeX benutzen, dann koennen Sie die
Installation genauso durchfuehren). Die notwendigen Files finden Sie
ueber anonymes FTP auf eiunix.tuwien.ac.at im Verzeichnis /pub/sisisi, im
Unterverzeichnis COMMON (soweit sie alle Varianten betreffen) bzw. in einem
der speziellen Unterverzeichnisse.


1) Besorgen Sie sich den Sourcecode von TeX und installieren Sie TeX.
---------------------------------------------------------------------

Sie brauchen den Sourcecode einer der beiden Varianten von TeX, da Sie mit
SiTeX bzw. iSiTeX einen ganz neuen Algorithmus fuer die Silbentrennung
installieren muessen.

Zusaetzlich muessen Sie TeX ohne Silbentrennung schon nach den Anweisungen
des README-Files von TeX installiert haben.


2) Legen Sie ein SiSiSi-Verzeichnis an und kopieren Sie die SiSiSi-Files.
-------------------------------------------------------------------------

Legen Sie ein eigenes Verzeichnis fuer SiSiSi an. Kopieren Sie alle Files aus
einem der oben erwaehnten vier speziellen Unterverzeichnisse dort hinein.

Das COMMON Verzeichnis enthaelt spezielle Worttabellen fuer SiSiSi
(def_umlaut.tex und sihyphen.tex). Ausserdem enthaelt es zwei weitere, von
der Variante (3.14 bzw. 3.141) abhaengige Unterverzeichnisse, die spezielle
Style- bzw. Format-Files enthalten (sigerman.sty, siplain.tex und
silplain.tex), ausserdem die Changefiles, die verwendet wurden um diese Files
aus den Originalfiles (german.sty, plain.tex und lplain.tex) zu erzeugen.
Kopieren Sie die Files aus COMMON und aus dem entsprechenden Unterverzeichnis
in Ihr TEXINPUTS-Verzeichnis, z.B. /usr/local/lib/tex/inputs, oder was immer
Sie beim Installieren von TeX als TEXINPUTS Pfad konfiguriert haben.


3) Erzeugen Sie SiTeX.
----------------------

In Ihrem neuen SiSiSi-Verzeichnis muessen Sie erst das File `install'
editieren. Sie muessen die Variablen TEXSRC und SISISIDIR auf den (absoluten)
Pfadnamen der Verzeichnisse setzen, in denen sich Ihre TeX-Sourcen bzw. die
SiSiSi-Sourcen befinden (TEXSRC bezieht sich auf das oberste Verzeichnis der
TeX-Sourcen, das, in dem sich das Top-Level Makefile befindet).

Der Installation von [i]SiTeX3.141 liegt TeX3.141 in der auf
quepasa.cs.tu-berlin.de vorhandenen Version zugrunde. Fuer die Version von
Karl Berry auf ftp.cs.umb.edu gibt es spezielle Files, install.other und
tex.ch.other, die Sie aber vor der Verwendung in install und tex.ch umbenennen
muessen.

Danach starten Sie in dem SiSiSi-Verzeichnis das Installationsskript mit
`./install' oder `sh install'. Dieses Skript kopiert zunaechst alle
notwendigen Files in die richtigen Verzeichnisse und startet dann ein `make',
wobei nur TeX erzeugt wird, nicht etwa auch MetaFont oder die anderen
Programme, die bei TeX dabei sind.

Dabei werden die speziellen Programme virtex und initex mit Silbentrennung
erzeugt, und ebenso sitex.fmt und silatex.fmt, bzw. isitex.fmt und
isilatex.fmt bei der interaktiven Variante, in demselben Verzeichnis.

Da SiTeX einen auf die deutsche Sprache zugeschnittenen Silbentrennalgorithmus
verwendet, kann es nicht sinnvoll fuer fremdsprachige Texte verwendet werden.

Sie sollten also jetzt nicht einfach so weitermachen, wie im README File von
TeX beschrieben wird, da Sie sonst das bestehende TeX mit der
Original-Silbentrennung ueberschreiben und damit keine englischsprachigen
Dokumente mehr formatieren koennen.

Kopieren Sie statt dessen ganz einfach per Hand (d.h. per cp-Befehl :-) das
neu entstandene virtex und initex unter neuem Namen in ein Verzeichnis in
Ihrem Suchpfad (z.B. nach /usr/local/bin), also etwa als sivirtex und siinitex
(bzw. isivirtex und isiinitex).
Ausserdem muessen Sie [i]sitex.fmt und [i]silatex.fmt (die Sie beide in TEXDIR
finden) in Ihr TEXFORMATS Verzeichnis kopieren, und einen Link namens
[i]siplain.fmt auf [i]sitex.fmt herstellen. Ebenso muessen Sie noch Links auf
[i]sivirtex erzeugen (im selben Verzeichnis wie [i]sivirtex), naemlich
[i]sitex und [i]silatex. Zu guter letzt kopieren Sie das File hf3 in eines der
TEXINPUTS Verzeichnisse (z.B. /usr/local/lib/tex/inputs), und das File
[i]sitex.pool in das TEXPOOL Verzeichnis. Diese Files finden Sie ebenfalls in
TEXDIR.


4) Die Benutzung.
-----------------

Sie sollten jetzt TeX mit und ohne SiSiSi verwenden koennen. Bei den
SiSiSi-Varianten vergessen Sie nicht, sigerman.sty anstelle von german.sty zu
verwenden, also \documentstyle[sigerman] anstelle von \documentstyle[german].
Die SISISI-Varianten geben sich in der Meldung nach dem Start durch ein
eingeschobenes `(+SISISI 1.0)' zu erkennen.

Das einfache SiTeX koennen Sie genauso wie das urspruengliche TeX benutzen.
Eine ausfuehrliche Beschreibung der zusaetzlichen Moeglichkeiten, die die
interaktive Variante bietet, finden Sie in dem Institutsbericht, der als
LaTeX-File im COMMON/INST_BER-Verzeichnis steht.


5) Aendern der Worttabelle.
---------------------------

Das Aendern der Worttabelle erfolgt wie im Institutsbericht beschrieben. Danach
muessen Sie das File `sihyphen.tex' auf Ihr UNIX-System in den TEXINPUTS-Pfad
kopieren und mit den folgenden Befehlen die Hashtabelle und die Format-Files
neu erzeugen:

     siinitex siplain \\dump
     siinitex silplain \\dump

Dabei entstehen die Files hf3, siplain.fmt und silplain.fmt. hf3 kommt in ein
TEXINPUTS-Verzeichnis, siplain.fmt und silplain.fmt kommen als sitex.fmt und
silatex.fmt in das TEXFORMATS-Verzeichnis.

Wenn Sie auch iSiTeX benutzen wollen, muessen Sie auch die iSiTeX Format-Files
neu erzeugen:

     isiinitex siplain \\dump
     isiinitex silplain \\dump

Das hf3 File ist identisch zu dem von SiTeX, siplain.fmt und silplain.fmt
sollten Sie aber als isitex.fmt und isilatex.fmt in das TEXFORMATS-Verzeichnis
stellen.

-------------------------------------------------------------------------------


Kommentare, Fehlermeldungen, Verbesserungsvorschlaege und Erfolgsmeldungen
erbeten an heinz@eiunix.tuwien.ac.at