CONTENIDOS: --------- I. BRAILLE II. VOZ III. ORCA EN UBUNTU 5.10 IV. ORCA EN FEDORA CORE 4 V. ORCA EN DISTRIBUCIÓN LINUX VI. ESCRIBIENDO SCRIPTS VII. PROBLEMAS CONOCIDOS VIII. FAQ IX. INFORMANDO ERRORES X. CONTRIBUYENDO APÉNDICE A: NOTAS DE EVOLUTION NOTA: Cuando se utiliza cvs, podrías ver avisos conteniendo el siguiente texto : failed to open .cvspass for reading" Si haces un "touch ~/.cvspass, puedes evitar estos avisos. I. BRAILLE: ----------- Orca utiliza BrlTTY para proporcionar acceso a las líneas braille. Una de las razones principales para esto es que lo ayuda a operar bien en un ambiente donde un usuario cambie entre un entorno gráfico y uno no gráfico. Orca ha sido probado con versiones 3.6.2 y 3.7.0 de BrlTTY. Puedes obtener BrlTTY desde http://www.mielke.cc/brltty/. Aquí están las órdenes principales que ejecutarás para compilar/instalar BrlTTY (podrías necesitar antes descargar compiladores y otras utilidades esenciales para tu plataforma): tar xzf brltty-3.7.tar.gz cd brltty-3.7 ./configure --prefix=/usr make sudo make install Sigue la documentación en http://www.mielke.cc/brltty/ para más información sobre compilación, instalación, y ejecución de BrlTTY. II. VOZ: ----------- Orca utiliza gnome-speech para proporcionar salida de voz. Gnome-speech es un módulo de GNOME separado que proporciona un servicio de arquitectura orientado a acceder a los motores de síntesis de voz como servicios del systema. Gnome-speech Proporciona el soporte para un número de motores de síntesis de voz, incluyendo algunos disponibles libremente como: festival y FreeTTS. FreeTTS puede ser obtenido desde http://freetts.sourceforge.net/, y requiere la plataforma Java. Festival viene por omisión con Fedora Core 4, y puede ser obtenido para Ubuntu 5.10 llevando a cabo la siguiente orden: sudo apt-get install festival El módulo gnome-speech contiene información sobre cómo establecer gnome-speech para los diferentes motores de síntesis. Para obtener el último código fuente para gnome-speech, se pueden realizar los siguientes pasos: cd $HOME cvs -z3 -d:pserver:anonymous@anoncvs.gnome.org:/cvs/gnome co gnome-speech NOTA: antes de ejecutar Orca, se debería asegurar de que gnome-speech está actualmente funcionando antes de suponer que hay un problema con Orca. Para testear gnome-speech, se puede ejecutar suaplicación "test-speech"; te proporcionará la capacidad para ver y escuchar los diferentes motores de síntesis que gnome-speech encuentre en tu sistema. III. ORCA EN UBUNTU 5.10: ------------------------- 1) Instalar desde CD. 2) Conseguir los paquetes Necesarios sudo apt-get install emacs21 sudo apt-get install build-essential cvs ssh \ autoconf automake1.4 automake1.7 automake1.9 \ docbook docbook-utils docbook-xsl \ docbook2x doxygen bison flex libpopt-dev jade \ libtool intltool pkg-config gtk-doc-tools \ x-dev x-window-system-dev \ libgnome2-dev libbonobo-activation-dev \ libbonoboui* libgnomeui-* libpanel-applet* \ libgnomecanvas2-dev \ python-dev python-gnome2-dev python-gtk2-dev 3) Chequear/compilar/instalar ATK, GAIL, LIBGAIL-GNOME, AT-SPI NOTA: Las instrucciones de abajo implican trabajar desde la última revisión del CVS de GNOME. Esto puede ser algo muy arriesgado de hacer ya que la última revisión del CVS de GNOME podría ser inestable y causar que tu sistema se volviera inestable. Si estás dispuesto a tomar el riesgo (podría requerirte reinstalar el sistema), entonces siéntete libre de hacer ésto. Si no te excita el tomar este riesgo entonces mejor podrías intentar coger los paquetes soportados vía: sudo apt-get install libatk* libgail* at-spi* libatspi* Las versiones conocidas que trabajan con Orca en Ubuntu son: atk 1.10.3 gail 1.8.5 libgail-gnome 1.1.1 at-spi 1.6.6 Aquí está cómo conseguir las últimas desde la última revisión del CVS de GNOME: cd $HOME cvs -z3 -d:pserver:anonymous@anoncvs.gnome.org:/cvs/gnome co atk cd atk ./autogen.sh --prefix=/usr make sudo make install cd $HOME cvs -z3 -d:pserver:anonymous@anoncvs.gnome.org:/cvs/gnome co gail cd gail ./autogen.sh --prefix=/usr make sudo make install cd $HOME cvs -z3 -d:pserver:anonymous@anoncvs.gnome.org:/cvs/gnome co libgail-gnome cd libgail-gnome ./autogen.sh --prefix=/usr make sudo make install cd $HOME cvs -z3 -d:pserver:anonymous@anoncvs.gnome.org:/cvs/gnome co at-spi cd at-spi ./autogen.sh --prefix=/usr make sudo make install 5) Ir a la sección: "ORCA EN DISTRIBUCIÓN LINUX" NOTAS: Algunos encuentran más fácil iniciar el sistema sin que se ejecute el entorno gráfico de escritorio X-Window. Para hacer esto en Ubuntu, puedes ejecutar la siguiente orden: sudo update-rc.d -f gdm remove Puedes entonces reiniciar tu sistema y aparecerá en modo texto. Cuando te identifiques, podrás arrancar el servidor del sistema X Window utilizando la orden "xinit". Si quieres que el escritorio gnome y Orca se ejecuten, deberías crear un fichero ~/.xinitrc que parezca similar al siguiente (nota que Orca se ejecuta en segundo plano y la sesión de gnome se ejecuta en primer plano): orca& gnome-session NOTA también que deberías ajustar la propiedad GTK_MODULES=:gail:atk-bridge: en la shell antes de arrancar xinit. Si no haces esto, algunas aplicaciones, tales como gaim, no utilizarán la infraestructura de accesibilidad y, por lo tanto, no serán accesibles vía Orca. IV. ORCA EN FEDORA CORE 4: ------------------------- 1) Haz una instalación "completa" de Fedora Core 4. [[[WDW - necesita determinar las dependencias exactas.]]] 2) Chequear/compilar/instalar el módulo "gnome-common" desde el cvs.gnome.org cd $HOME cvs -z3 -d:pserver:anonymous@anoncvs.gnome.org:/cvs/gnome co gnome-common cd gnome-common ./autogen.sh --prefix=/usr make sudo make install 3) Ir a la sección: "ORCA EN DISTRIBUCIÓN LINUX" NOTAS: Algunos encuentran más fácil iniciar el sistema sin que se ejecute el entorno gráfico de escritorio X-Window. Para hacer esto en Fedora, puedes modificar tu fichero /etc/inittab para decir a Fedora que inicie en el run level 3. Haz esto modificando la línea donde se ajusta la propiedad initdefault: id:3:initdefault Puedes entonces reiniciar tu sistema y aparecerá en modo texto. Cuando te identifiques, puedes arrancar el servidor del sistema X Window utilizando la orden "xinit". Si quieres que se ejecuten el escritorio gnome y Orca, deberías crear un fichero ~/.xinitrc que parezca similar al siguiente (nota que Orca se ejecuta en segundo plano y la sesión de gnome se ejecuta en primer plano): orca& gnome-session NOTA también que deberías ajustar la propiedad GTK_MODULES=:gail:atk-bridge: en la shell antes de arrancar xinit. Si no haces esto, algunas aplicaciones, tales como gaim, no utilizarán la infraestructura de accesibilidad y, por lo tanto, no serán accesibles vía Orca. V. ORCA EN DISTRIBUCIÓN LINUX: ------------------------------ 1) Ejecuta /usr/bin/test-speech para asegurarte de que funciona. Si no es así, Esto es un problema de gnome-speech. Revisa la sección "VOZ" Para más información sobre gnome-speech. 2) Chequear/compilar/instalar Orca cd $HOME cvs -z3 -d:pserver:anonymous@anoncvs.gnome.org:/cvs/gnome co orca cd orca ./autogen.sh --prefix=/usr make sudo make install 3) Ejecuta /usr/bin/orca-setup. 4) Cierra sesión y vuelve a abrirla para que la accesibilidad tenga efecto. 5) Ejecuta /usr/bin/orca VI. ESCRIBIENDO SCRIPTS: -------------------- Orca es un lector de pantalla programable, permitiéndote escribir tus propios scripts personales para proporcionar una interacción personalizada con cada aplicación individual. [[[WDW: puntos de la guía para escribir scripts (están en forma de fuente en el módulo Orca bajo docs/doc-set/script_guide.sgml y está actualmente bajo desarrollo).]]] [[[WDW: se trabaja en un modo para que la gente contribuya con sus scripts a la comunidad. Quizás a través de parches al módulo orca, quizás a través de un sitio web, quizás a través de una lista de correo, etc.]]] VII. PROBLEMAS CONOCIDOS: -------------------- 1) No funciona en una arquitectura de 64-bits. No estamos seguros sobre este punto, Pero podrías obtener el siguiente error: Traceback (most recent call last): File "/usr/bin/orca-setup", line 64, in ? import orca.speech as speech File "/usr/lib/python2.4/site-packages/orca/speech.py", line 29, in ? from core import ORBit, bonobo ImportError: No module named core Esto aparece con referencia a lo competente a los directorios /usr/lib y /usr/lib64 Un modo para comenzar a solucionar esto es mover el contenido de /usr/lib64/python2.4/site-packages/orca/* a /usr/lib/python2.4/site-packages/orca/* y después eliminar de /usr/lib64/python2.4/site-packages/orca. Esto funciona para parte del problema, pero gnome-speech tiene resultados similares. 2) test-speech fallará a menudo cuando intentes utilizar el motor de síntesis de voz festival. % /usr/bin/test-speech 1: OAFIID:GNOME_Speech_SynthesisDriver_Festival:proto0.3 Select a server: 1 Attempting to activate OAFIID:GNOME_Speech_SynthesisDriver_Festival:proto0.3. Server could not be initialized. Puedes solucionar esto asegurándote de que "localhost" sea listado antes "localhost.localdomain" en la línea 127.0.0.1 en /etc/hosts. O, puedes también seguir una ruta alternativa descrita en: http://mail.gnome.org/archives/gnome-accessibility-devel/2005-February/msg00017.html VIII. FAQ: ---------- P: Orca no está hablando, ¿cómo lo hago funcionar? R: Este es el resultado más probable con la configuración de gnome-speech. Aquí está un procedimiento de depuración que puede ayudarte a reducir algo lo que está fallando: 1) Mata todos los controladores de síntesis que estén corriendo en la máquina: kill -9 \ `ps -elf | grep synthesis-driver | grep -v grep | awk '{ print $4 }'` 2) En una ventana de terminal especializada distinta, corre el controlador de síntesis gnome-speech de tu elección. Por ejemplo: /usr/bin/festival-synthesis-driver 3) En otra ventana especializada de terminal separada, ejecuta la aplicación de gnome-speech "test-speech": /usr/bin/test-speech 4) Cuando test-speech esté ejecutándose, debería mostrarte un listado de los controladores de síntesis disponibles , y el que arrancaste en el paso #2 debería ser listado arriba. Si no es así, hay con mayor probabilidad un problema en la declaración de Bonobo o tu controlador de síntesis no arrancó. Verifica la salida en la ventana de terminal desde el paso #2 y mira si tiene algunos mensajes. Si es así, esos serán útiles cuando contactes con las gentes de gnome-speech para que te ayuden. De otra manera, si todo está correcto, deberías ver algo parecido a lo siguiente: [wwalker@fedora orca]$ /usr/bin/test-speech 1: OAFIID:GNOME_Speech_SynthesisDriver_FreeTTS:proto0.3 2: OAFIID:GNOME_Speech_SynthesisDriver_Festival:proto0.3 3: OAFIID:GNOME_Speech_SynthesisDriver_Dectalk:proto0.3 Select a server: 5) Si todo está correcto hasta aquí, desde test-speech, selecciona el controlador de síntesis que arrancaste en el paso #2. deberías ver ahora algo parecido a lo siguiente: Attempting to activate OAFIID:GNOME_Speech_SynthesisDriver_Festival:proto0.3. Driver name: Festival GNOME Speech Driver Driver version: 0.3 Synthesizer name: Festival Speech Synthesis System Synthesizer Version: 1.95 Enter desired gender ('m' or 'f'): Selecciona 'm' y luego 'all': Enter desired gender ('m' or 'f'): m Enter desired locale, or 'all' to display all voices: all 1. kal_diphone (language english) 2. ked_diphone (language english) En este punto, gnome-speech debería haber hablado algo. Si no fue así, chequea la salida en la ventana de terminal utilizada en el paso #2. podrá darte alguna información interesante. Por ejemplo, quizás necesites modificar el fichero /etc/hosts como se describió en la sección "PROBLEMAS CONOCIDOS" de este documento. P: ¿Cómo activo el soporte para la plataforma Java si a mí no me funciona. R: El java-access-bridge proporciona el soporte necesario para interactuar con aplicaciones Java, incluyendo las aplicaciones y los controladores del gnome-speech tales como el controlador de gnome-speech para FreeTTS. Más información sobre el java-access-bridge puede ser encontrada aquí: http://cvs.gnome.org/viewcvs/*checkout*/java-access-bridge/INSTALL P: La voz desaparece. ¿que está ocurriendo? R: Ahí podría ser un conflicto de dispositivo entre tu sistema de síntesis de voz y los sonidos emitidos por tu OS de base. Desafortunadamente, no estamos seguros de cómo conseguir que ambos funcionen bien correctamente ahora (hay rumores que podría haber algunas correcciones a la arquitectura de sonido de Linux, ALSA, para corregir esto). Por ahora, necesitarás deshabilitar los sonidos del sistema. IX. INFORMANDO ERRORES: ------------------- Informa de los errores en http://bugzilla.gnome.org bajo el módulo "orca". Nota que Orca no es parte del escritorio GNOME 2 todavía. Así, cuando vengas a seleccionar el módulo, necesitarás hacer clic sobre la casilla de verificación que dice "Click here to also show applications not part of the GNOME2 Desktop." Orca será listado entonces como el módulo "orca". X. CONTRIBUYENDO: ---------------- [[[WDW: trabajar sobre esto. Por ahora, la gente es animada a contribuir informando errores, RFEs, y parchear el módulo de orca mediante el sitio http://bugzilla.gnome.org.]]] TODO: Necesita incluir lo siguiente en alguna parte: * Instrucciones específicas de uso para aplicaciones de producción usadas en el escritorio APÉNDICE A: Notas de Evolution: ---------------------------- Estamos trabajando con el equipo de Evolution para mejorar su implementación de AT-SPI, y están siendo fantásticos en su sensibilidad. Mientras tanto esto significa que la accesibilidad de Evolution está consiguiendo mejorarse más, significa también que necesitas coger el último material del CVS de GNOME en orden a que funcione bien con Orca. En particular, necesitas los siguientes módulos: eel, evolution-data-server, evolution. Acontinuación hay unas notas para compilar estos en Ubuntu: Evolution-data-server requiere: sudo apt-get install libsoup2.2-8 libsoup2.2-dev sudo apt-get install firefox-dev ./autogen.sh --prefix=/usr --with-nspr-includes=/usr/include/mozilla-firefox --with-nspr-libs=/usr/lib/mozilla-firefox Evolution requiere: sudo apt-get install libgtkhtml3.8-dev ./autogen.sh --prefix=/usr Eel requiere: sudo apt-get install libgnome-menu-dev libgnome-desktop-dev ./autogen.sh --prefix=/usr