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