3.4.1 Installationsanleitung

Aus SUE

Original-Installationsanleitung im SVN

Inhaltsverzeichnis 1 Automatisierte Installation 2 SUEbuntu 3 Installation für Experten 3.1 Accessibility 3.2 Braille-Ausgabe 3.3 Sprachausgabe 3.3.1 Pulseaudio 3.3.2 Installation von eSpeak 1.42.04 3.3.3 eSpeak-Stimmen 3.3.4 mbrola 3.3.5 Installation von Speech-Dispatcher 3.3.5.1 Konfiguration des Speech-Dispatchers 3.4 Installation von SUE 3.4.1 Installation aus dem SVN 3.4.1.1 Vorbereitung 3.4.1.2 Neuinstallation 3.4.1.3 Aktualisierung 3.4.2 Installation des *.tar.gz Archives 3.4.3 SUE-Quellcode-Dokumentation mit epydoc 4 Weitere Informationen

SUE wird auf Ubuntu 9.04 (Jaunty Jackalope) entwickelt. Alle von SUE benötigten Pakete werden bereits mit Jaunty ausgeliefert:

• brltty 4.0
• pyatspi
• python 2.6

Automatisierte Installation

Für eine möglichst einfache Installation stehen Scripte zur Verfügung, die alle notwendigen Installationsschritte ausführen. Folgende Scripte stehen zur Auswahl:

install_9.04.sh - Script für die SUE Installation zusammen mit eSpeak (nur für Ubuntu 9.04)

install_espeak_voices.sh - Installations-Script für eSpeak inklusive der deutschen Stimmen

install_mbrola.sh - Installations-Script für MBrola Stimmen

SUE läuft inzwischen auch mit Ubuntu 10.04. Für die schnelle Installation stellen wir folgendes Script zur Verfügung:

install_10.04.sh - Script für die SUE Installation zusammen mit eSpeak auf Ubuntu 10.04

Bei unserem letzten Test hatte Ubuntu 10.04 ein Problem mit den MBrola Stimmen. Diese liefen leider nicht.

Die Scripte sollten im Home-Verzeichnis (Perönlicher Ordner) gespeichert werden. Mit Alt+Strg+F1 wird eine Konsole aufgerufen, auf die sich der Nutzer erst einmal mit Benutzername und Passwort anmelden muss. Im nächsten Schritt müssen die Scripte als ausführbar markiert werden:

 chmod +x install_*

Nun werden die Scripte nacheinander ausgeführt. Den Anweisungen der Scripte sollte gefolgt werden.

Installation unter Ubuntu 9.04:

 ./install_9.04.sh
 sudo reboot
 ./install_espeak_voices.sh
 ./install_mbrola.sh
 sudo reboot

Nach dem erfolgreichen Durchlaufen der Scripte sollte der Rechner einmal neu gestartet werden, damit alle Einstellungen aktiviert werden.

Installation unter Ubuntu 10.04:

 ./install_10.04.sh

Mit Alt+Strg+F7 gelangt man zurück auf die grafische Oberfläche. Einmal Ab- und wieder Anmelden und schon ist es geschafft.

Eine erfolgreiche Installation ist nach dem Anmelden am System durch eine Begrüßung durch den Screenreader SUE zu erkennen.

SUEbuntu

Auf der Sourceforge-Plattform liegt ein ISO-Abbild von Ubuntu 9.04 mit integrierter und optimal eingestellter SUE-Version bereit. Für die Nutzung von SUEbuntu sind folgende Schritte notwendig:

Schritt 1 - Downloaden:

 wget http://sourceforge.net/projects/sue/files/sue/SUEbuntu/suebuntu-904.iso/download

Schritt 2 - Auf CD brennen:

 cdrecord dev=/dev/cdrom suebuntu-904.iso

Schritt 3 - CD starten:

SUEbuntu-CD einlegen und den Computer von der CD aus starten

Installation für Experten

Accessibility

Bei einer Ubuntu-Installation ohne Braille-Unterstützung muss die Accessibility eingeschaltet werden. Die Ausführung des folgenden Befehls aktiviert die Accessibility:

 sudo gconftool-2 --direct --config-source xml:readwrite:/etc/gconf/gconf.xml.defaults --type bool --set /desktop/gnome/interface/accessibility true

Braille-Ausgabe

Um die Braille-Ausgabe nutzen zu können, muss BrlTTY laufen.

Sprachausgabe

Seit Revision 894 ist die Sprachausgabe von SUE auf den Speech-Dispatcher umgestellt. Somit müssen einige Nachinstallationen für Ubuntu 9.04 oder vorherige Versionen durchgeführt werden. Ab Ubuntu 9.10 ist der Speech-Dispatcher integriert und wird direkt unterstützt. Zur Vereinfachung der Installation unter 9.04 steht unter https://sourceforge.net/projects/sue/files/sue/InstallScripts/install_9.04.sh ein Script bereit, das ausgeführt werden kann.

Pulseaudio

Bei einer Ubuntu-Installation mit Braille-Unterstützung muss die Datei ".pulse_a11y_nostart" umbenannt bzw. gelöscht werden, um Pulseaudio verwenden zu können. Dies wird mit den folgenden Befehlen erreicht:

 cd ${HOME}
 rm .pulse_a11y_nostart

Nach einem Neustart wird Pulseaudio unterstützt. Nun kann als vorgegebene Mixerspur Pulseaudio ausgewählt werden. Dafür muss über das Menü (Alt+F1) System / Einstellungen / Audio aktiviert werden. Es öffnet sich der Dialog "Audio-Einstellungen". Hier müssen folgende Einstellungen vorgenommen werden:

 Audiowiedergabe: Automatisch erkennen
 Audioaufnahme: PulseAudio-Soundserver
 Vorgegebene Mixerspur: Gerät: ... (PulseAudio Mixer)

Eine weitere Einstellung ist im Oberen Kantenpanel (Strg+Alt+Tab) zu tätigen. Im Fenster des Lautstärkereglers, das sich im Oberen Kantenpanel befindet, ist ein Druckknopf "Lautstärkeregler", über den der Dialog "Lautstärkeregler" geöffnet wird. Hier muss als Gerät der Pulseaudio-Mixer ausgewählt werden.

Installation von eSpeak 1.42.04

eSpeak wird standardmäßig mit Portaudio-Unterstützung ausgeliefert, vorteilhafter ist jedoch die Nutzung von Pulseaudio. Mit Pulseaudio können verschiedene Anwendungen die Soundausgabe verwenden ohne spezielle Einstellungen vornehmen zu müssen. Um eSpeak mit Pulseaudio-Unterstützung zu installieren, muss eine Einstellung im Quellcode von eSpeak vorgenommen werden. Folgende Schritte beschreiben die Umstellung auf Pulseaudio und die Installation des veränderten Quellcodes.

Schritt 1 - Vorbereitung:

Für die Installation von eSpeak müssen zusätzliche Pakete installiert werden:

 cd ${HOME}
 sudo apt-get -y install g++ libstdc++6-4.3-dev libpulse-dev

Schritt 2 - Download und Entpacken:

Am besten ist es, wenn die aktuellste ESpeak-Version verwendet wird. Mit den folgenden Befehlen wird die momentan aktuellste eSpeak-Version 1.42.04 aus dem Internet geholt und entpackt:

 wget http://kent.dl.sourceforge.net/sourceforge/espeak/espeak-1.42.04-source.zip
 unzip espeak-1.42.04-source.zip

Schritt 3 - Umstellung auf Pulseaudio:

Nun werden die Einstellungen vorgenommen, um eSpeak mit Pulseaudio verwenden zu können. Führe folgende Befehle aus:

 cd espeak-1.42.04-source/src
 cat Makefile |\
   sed 's/AUDIO = portaudio/#AUDIO = portaudio/' |\
   sed 's/#AUDIO = pulseaudio/AUDIO = pulseaudio/' >\
   makefile
 mv makefile Makefile

Schritt 4 - Installation:

 make && sudo make install
 sudo apt-get -y build-dep espeak

eSpeak ist nun für Pulseaudio bereit.

eSpeak-Stimmen

Wer möchte, kann sich zusätzlich unsere deutschen eSpeak-Stimmen installieren. Diese finden sich im Download-Bereich auf SourceForge.net und enthalten eine eigene Installationsanleitung. Alternativ bieten wir ein entsprechendes Installations-Script für eSpeak inklusive der deutschen Stimmen an.

mbrola

Wer möchte, kann sich auch mbrola installieren und SUE mit den mbrola-Stimmen testen. Hierfür steht ein Installationsscript für mbrola bereit.

Installation von Speech-Dispatcher

Schritt 1 - Vorbereitung:

Für die Installation von Speech-Dispatcher werden zusätzliche Pakete benötigt. Mit folgenden Befehlen können diese Pakete nachinstalliert werden:

 cd ${HOME}
 sudo apt-get -y install git-core
 sudo apt-get -y install python-speechd libdotconf1.0 libdotconf-dev texinfo libtool

Schritt 2 - Download:

Um den aktuellen Entwicklungsstand vom Speech-Dispatcher zu erhalten, muss folgender Befehl ausgeführt werden:

 git clone git://git.freebsoft.org/git/speechd

Schritt 3 - Installationsvorarbeiten:

Der Speech-Dispatcher erzeugt bei der Installation einige Probleme. Um dem entgegenzuwirken, werden hier einige Verzeichnisse angelegt:

 mkdir -p ${HOME}/.config/autostart
 sudo mkdir -p /usr/local/share/speech-dispatcher/conf/desktop

Schritt 4 - Installation:

Sind alle Vorarbeiten durchgeführt, kann die Installation mit folgenden Befehlen ausgeführt werden:

 cd speechd
 ./build.sh
 ./configure
 make all && sudo make install

Konfiguration des Speech-Dispatchers

Damit der Speech-Dispatcher einwandfrei läuft, müssen einige Konfigurationen durchgeführt werden.

Schritt 1 - Konfigurationsvorarbeiten:

Für die Verwendung des Speech-Dispatchers als normaler Anwender müssen Verzeichnisse und Konfigurationsdateien in das Home-Verzeichnis kopiert werden:

 mkdir -p ${HOME}/.speech-dispatcher/conf/modules
 cp -R /usr/share/speech-dispatcher/conf/* ${HOME}/.speech-dispatcher/conf/
 mv ${HOME}/.speech-dispatcher/conf/speechd.conf ${HOME}/.speech-dispatcher/conf/speechd.conf.old

Schritt 2 - Konfigurationsdatei erstellen:

Nun kann die Konfigurationsdatei für den Speech-Dispatcher angelegt werden:

 cat > ${HOME}/.speech-dispatcher/conf/speechd.conf << "EOF"
 Port                   6561
 LogLevel               3
 LogDir                 "default"
 DefaultVolume          100
 DefaultVoiceType       "MALE1"
 DefaultLanguage        de
 AudioOutputMethod      pulse
 AddModule              "espeak"    "sd_espeak"     "espeak.conf"
 DefaultModule          espeak
 LanguageDefaultModule  "de"  	     "espeak"
 LanguageDefaultModule  "en"        "espeak"
 EOF

Schritt 3 - Automatisch starten:

Damit der Speech-Dispatcher beim Hochfahren automatisch startet, wird eine Datei "speech-dispatcher.desktop" im Verzeichnis ~/.config/autostart/ angelegt. In dieser Datei werden Informationen wie Name und Ausführungsbefehl hinterlegt. Zum Anlegen der Datei führe folgenden Befehl aus:

 cat > ${HOME}/.config/autostart/speech-dispatcher.desktop << "EOF"
 [Desktop Entry]
 Type=Application
 Name=speech dispatcher
 Exec=speech-dispatcher -d -C X
 Icon=system-run
 Comment=
 Name[de_DE]=speech dispatcher
 Comment[de_DE]=
 X-GNOME-Autostart-enabled=true
 EOF

Der Befehl zum Ausführen muss in der Startdatei aktualisiert werden, da wir den vollständigen Pfad vom Home-Verzeichnis benötigen.

 cat ${HOME}/.config/autostart/speech-dispatcher.desktop |\
   sed "s@Exec=speech-dispatcher -d -C X@Exec=speech-dispatcher -d -C $HOME/.speech-dispatcher/conf@" > tmpfile
 mv tmpfile ${HOME}/.config/autostart/speech-dispatcher.desktop

Installation von SUE

Für die Installation von SUE verwenden wir die GNU-Autotools. Dafür müssen folgende Pakete installiert werden:

 sudo apt-get install gnome-common python-dev libglib2.0-dev

Installation aus dem SVN

Vorbereitung

Zum Herunterladen von SUE aus dem SVN wird das Paket subversion benötigt. Sollte dieses nicht installiert sein, kann das Paket mit folgendem Befehl nachinstalliert werden:

 sudo apt-get install subversion

Neuinstallation

Die Installation besteht aus den nachfolgenden Schritten:

Schritt 1 - SUE aus dem SVN herunterladen:

SUE kann entweder als aktueller Branch oder direkt aus dem Trunk heruntergeladen werden. Im Trunk findet sich die Version, an der aktuell entwickelt wird. Dies ist also immer die aktuellste Version, die aber mitunter Fehler enthält. Branches sind stabilere aber meist etwas ältere Versionen. Je nach Wunsch wird also einer der folgenden Befehle im Home-Verzeichnis ausgeführt. Der jeweilige Befehl lädt die entsprechenden Quellcode-Dateien aus dem SVN-Branch bzw. -Trunk in einen Ordner mit Namen 'sue' in das aktuelle Verzeichnis herunter. Dazu wird kein Passwort benötigt.

Einen (stabilen) Branch herunterladen:

 svn co https://sue.svn.sourceforge.net/svnroot/sue/tags/SUE_0_6_0 sue

SUE aus dem Trunk herunterladen:

 svn co https://sue.svn.sourceforge.net/svnroot/sue/trunk sue

Schritt 2 - Die GNU-Autotools anwenden:

Wenn alle Pakete installiert sind, können die GNU-Autotools verwendet werden. Dazu in den in Schritt 1 per SVN-Befehl angelegten Ordner 'sue' wechseln und folgende Befehle ausführen:

 cd sue
 ./autogen.sh
 make
 sudo make install

Schritt 3 - SUE ausführen:

Nach erfolgreicher Installation kann SUE über das Terminal oder den Dialog "Anwendung ausführen" (Alt+F2) mit dem folgenden Befehl gestartet werden:

 sue

Alternativ kann SUE auch über die Desktop-Menüleiste (Alt+F1) ausgeführt werden. Der Menüeintrag befindet sich unter

 Anwendungen / Barrierefreiheit / SUE - Screenreader

Durch das Drücken von (Alt+Shift+Q) wird SUE beendet.

Aktualisierung

Um mit einer aktuelleren als der lokal installierten SUE-Version zu arbeiten, empfiehlt sich ein regelmäßiges Aktualisieren.

• Ins SUE-Homevereichnis wechseln
• Aktualisierungen der Quellecode-Dateien aus dem SVN herunterladen

   svn update

• Die GNU-Autotools anwenden (Siehe Schritt 2 der Neuinstallation)
• SUE ausführen (Siehe Schritt 3 der Neuinstallation)

Installation des *.tar.gz Archives

Auf der Sourceforge-Plattform stellen wir einen Download von SUE als tar-Archiv bereit (http://sourceforge.net/project/showfiles.php?group_id=232157). Um auf diesem Wege SUE zu installieren, sind folgende Schritte notwendig:

Schritt 1 - Entpacken des Archives:

 tar -xvzf sue-0.4.0.tar.gz

Schritt 2 - Die GNU-Autotools anwenden:

Wenn alle Pakete installiert sind, können die GNU-Autotools verwendet werden. Dazu in den in Schritt 1 per SVN-Befehl angelegten Ordner 'sue' wechseln und folgende Befehle ausführen:

 cd sue-0.4.0
 ./configure
 make
 sudo make install

Schritt 3 - SUE ausführen:

Nach erfolgreicher Aktualisierung kann SUE wie gewohnt über das Terminal, den Dialog "Anwendung ausführen" (Alt+F2) oder über die Desktop-Menüleiste gestartet werden.

SUE-Quellcode-Dokumentation mit epydoc

Bei Interesse kann die SUE-Quellcode-Dokumentation im Epydoc-Format zu erstellt werden. Dazu müssen folgende Schritte ausgeführt werden:

  sudo apt-get install python-epydoc
  cd sue/docs
  epydoc --config=epydoc.conf

Danach kann die Dokumentation mit einem Webbrowser angeschaut werden (Startdatei: sue/docs/html/index.html).

Weitere Informationen

Weitere Informationen sind in der Dokumentation unter http://sue.sourceforge.net und im Wiki zu finden. Außerdem empfehlen wir unsere Mailingliste für weitere Fragen.