Transcriber's Installation
Author: C. Barras

### Binäre Installation der Version 1.4.1 für Windows NT

### Binäre Installation der Version 1.3b7 für Windows NT

### Binäre Installation für Unix

- Stellen Sie sicher, dass Tcl/Tk 8.0 oder höher auf Ihrem System installiert ist und beschaffen Sie das binäre Archiv für Ihr System (z.B. Linux, Solaris), welches zu Ihrer Version Tcl/Tk (8.0...8.3) passt.
- Wechseln Sie in das Verzeichnis, in dem der Transcriber installiert werden soll. z.B.:

    $ cd /usr/local

Wenn Sie sich entschieden haben nicht in ein Standard-Verzeichnis zu installieren, setzen Sie die Umgebungsvariablen (`PATH` und `LD_LIBRARY_PATH`) auf die richtigen Werte.
- Extrahieren Sie die Dateien aus dem Archiv:

    $ gunzip -c Transcriber-1.4-Linux.tar.gz | tar xf -

- Starten Sie das Werkzeug:

    $ trans

Sie werden gefragt, ob Sie eine Transkription sdatei oder ein Audiosignal öffnen oder eine neue Transkription starten wollen
- Schauen Sie in das Hilfe-Verzeichnis um einige Hinweise über die Benutzung des Transcribers zu bekommen oder benutzen Sie die Online-Hilfe mit Ihrem HTML-Browser. (Start mit `lib/transcriber1.4/doc/Index.html`)

### Installation von den Quellen

Der Transcriber beruht auf einer Vielzahl von Softwareprodukten oder Bibliotheken, die zunächst installiert werden müssen. Tcl/Tk 8.0 - 8.3, Snack 2.0, tcLex 1.2 und optional NIST/Sphere 2.6 . Schritt 1-4 sind für diese Module, Schritt 5-6 sind für den Inhalt der Transcriber Distribution..

1. Wenn Tcl/Tk version 8.0 oder höher nicht bereits auf Ihrem System installiert ist, holen Sie es vom Scriptics Server:

    http://dev.scriptics.com/software/tcltk/choose.html

oder von einem seiner Mirrorsites und entpacken Sie es:

    $ gunzip -c tcl8.3.2.tar.gz | tar xf -

Wählen Sie ein Installationsverzeichnis (z.B. /usr/local) und folgen Sie den Anweisungen der README-Datei
Für Tcl 8.2 unter Unix, wird es etwa so aussehen:

    $ cd tcl8.3.2/unix
    $ ./configure --enable-gcc --enable-shared --prefix=/usr/local
    $ make
    $ make install

Führen dieselben Anweisungen für Tk aus. Wenn Sie in ein anderes Verzeichnis installiert haben, setzen Sie die Umgebungsvariablen (`PATH` und `LD_LIBRARY_PATH`) auf die richtigen Werte.
2. Dieser Schritt ist nur erforderlich, wenn Sie das Sphere Audiodateiformat mit Snack verwenden wollen. Holen Sie das NIST/Shpere Archiv von:

    ftp://jaguar.ncsl.nist.gov/pub/sphere_2.6a.tar.Z

Entpacken Sie in ein Unterverzeichnis dieser Distribution

    $ zcat sphere_2.6a.tar.Z | tar xf -

Dann installieren Sie es:

    $ cd nist; sh src/scripts/install.sh

Sie werden nach der Zielplattform gefragt. Für Linux, wählen Sie 10 (custom) und ändern Sie folgende Werte (die anderen sollten OK sein):

- What is/are the Compiler Flags: -O -Wall -fPIC
- What is/are the Architecture: INTEL

NB - Für die letzte Linux Distribution (z.B. Redhat 5.x oder Debian 2.x) müssen Sie die folgende Zeile in der Datei auskommentieren
`nist/src/lib/sp/exit.c` : `extern char *sys_errlist[]; (Danke an` Dafydd Gibbon für diese Information) Für die anderen gibt es ein Patch in der Transcriber Source Distribution in `src/patch-sphere für dynamische Compilation der Sphere libs unter Linux.`
3. Holen Sie das Snack 2.0 modul von:

    http://www.speech.kth.se/snack/

entpacken es mit:

    $ gunzip -c snack2.0.1.tar.gz | tar xf -

Dann folgen Sie den Anweisungen der README-Datei und installieren Snack mit:

    $ cd snack2.0.1/unix
    $ ./configure --prefix=/usr/local
    $ make
    $ make install

NB:

- Wenn '`./configure`' nicht funktioniert, haben Sie Tcl/Tk wahrscheinlich in einem Nichtstandard-Verzeichnis installiert; geben Sie die Optionen `--with-tcl` and `--with-tk ein`.
- Für den Gebrauch mit Tcl/Tk Version 8.0, fügen Sie die Option `--disable-stubs` hinzu.
- Vergewissern Sie sich, dass Sie die aktuelle Ausgabe haben.
- Um das Sphere Format zu benutzen, konfigurieren Sie mit `--with-nist=...`
- Testen Sie die Snack Demos!

4. Holen Sie das tcLex 1.2 Modul von:

    http://www.multimania.com/fbonnet/Tcl/tcLex/

entpacken es mit:

    $ gunzip -c tcLex1.2a1.tar.gz | tar xf -

Dann folgen Sie den Anweisungen der README.txt und installieren tcLex mit:

    $ cd tcLex1.2a1/src
    $ chmod a+x configure install-sh
    $ ./configure --prefix=/usr/local
    $ make
    $ make install

NB - Sie müssen die kompletten Quellen von Tcl haben um diese Erweiterung zu erzeugen, da sie sich auf besondere Headerdateien bezieht, die nicht bei der Standard Tcl Installation vorhanden sind.
5. Entpacken Sie die Quellen aus dem Transcriber Archiv, compilieren und installieren mit:

    $ gunzip -c Transcriber-1.4.tar.gz | tar xf -
    $ cd Transcriber-1.4/src
    $ ./configure --with-snack=... --with-tcl=... --with-tk=... --prefix=...
    $ make
    $ make install

6. Als Option zum Befehl `./configure,` müssen Sie das Verzeichnis angeben, in welchem Snack extrahiert wurde
   (`--with-snack=...`), die Verzeichnisse in welchen Tcl und Tk installiert wurden (`--with-tcl=...--with-tk=...`), und das Verzeichnis, wo Sie den Transcriber installieren werden (`--prefix=...`). Für den Gebrauch von Tcl/Tk Version 8.0, fügen Sie die Option `--disable-stubs` hinzu`.`

NB - Wenn Sie nach der Installation die Verzeichnisstruktur ändern, müssen Sie das 'trans' Startscript editieren und den absoluten Pfadnamen angeben: TRANSPATH=... (der lib Pfad wo das Unterverzeichnis transcriber1.4 zu finden ist)

7. Testen Sie es !

    $ trans

Sie werden gefragt, ob Sie ein Audiosignal oder eine Transkription öffnen wollen; einige finden Sie im Unterverzeichnis 'demo'.

###

Verzeichnisstruktur:

- Struktur der Quellen-Distribution:

- Transcriber-1.4/

- README
- COPYING
- contrib/ . . . externe Archive

- html_library-0.3/

- src/ . . . Quellen für neue Tcl Befehle und Tk Widgets
- tcl/ . . . Tcl Skripte
- `convert/...` Tcl Skript Module für die Format Konvertierung
- img/ . . . Bitmap Images
- doc/ . . . Hilfedateien
- etc/ . . . Default Dateien
- demo/ . . . für Audio und Transkriptionsdateien

- Struktur der binären Distribution (als Ergebnis einer Standard-Installation):

- lib/ =>

- html_library-0.3/
- snack2.0/
- tcLex1.2/
- transcriber1.4/ =>

- libtrans.so
- pkgIndex.tcl
- tcl/
- img/
- etc/
- doc/

- bin/trans

###

Mögliche Probleme

- Die Wiedergabe funktioniert nicht, wenn das Signalformat und die Soundkarten-Möglichkeiten nicht zusammenpassen. (z.B. 16 Bit Signal an einer Soundkarte, die 8kHz 8 Bit mu-law unterstützt.