El submódulo contenido en el directorio espeak es un sintetizador de voz multiplataforma de código abierto.

Contexto

La autoridad principal de requisitos de compilación debería ser <raíz del repositorio de NVDA>/include/espeak/Makefile.am.
También se pueden considerar los archivos *.vcxproj <raíz del repositorio de NVDA>/include/espeak/src/windows/,
pero no siempre se mantienen actualizados.

No usamos los archivos de Auto Make o de Visual Studio, mantenemos nuestro propio método de compilación de Espeak.
Será necesario hacer modificaciones en <raíz del repositorio de NVDA>/nvdaHelper/espeak
* sconscript para el proceso de compilación.
* config.h para configurar la versión de Espeak-NG que NVDA muestra en el archivo de registro.

Proceso de actualización

  1. Comienza en una rama master de NVDA limpia
    1. Descarga la rama más reciente de NVDA origin/master y crea una nueva rama.
    2. Ejecuta git clean para asegurarte de que el directorio de trabajo esté limpio.
  2. Asegúrate de que los submódulos están actualizados
    1. Sincroniza los submódulos con git submodule sync
    2. Actualiza los submódulos con git submodule update --init --recursive
  3. Cambia a la nueva revisión de Espeak-NG a probar.
    1. Cambia al directorio include/espeak/
    2. Ejecuta git fetch para obtener los cambios más recientes del repositorio de Espeak-NG
    3. Ejecuta git checkout origin/master o la revisión de Espeak-NG que quieras.
  4. Busca cambios en Makefile.am y actualiza nuestra compilación.
    1. Haz un diff de makefile.am con el commit de Espeak que se usaba antes.
    2. Algunos módulos se excluyen intencionadamente de la compilación.
      Si no estás seguro, no los incluyas y pregunta cuando envíes una solicitud de cambios.
    3. Modifica el archivo <raíz del repositorio de NVDA>/nvdaHelper/espeak/config.h según sea necesario.
  5. Actualiza nuestro registro de número de versión y compila.
    1. Vuelve a la raíz del repositorio de NVDA
    2. Actualiza la versión del paquete en <raíz del repositorio de NVDA>/nvdaHelper/espeak/config.h
      • Compara con la información del código fuente de Espeak: <raíz del repositorio de NVDA>/include/espeak/src/windows/config.h.
    3. Actualiza el readme.md de NVDA con la versión de Espeak y haz commit.
    4. Construye NVDA
  6. Ejecuta NVDA (configura Espeak-NG como sintetizador) y prueba.
  7. Asegúrate de que el archivo de registro contiene el nuevo número de versión de Espeak-NG

Resolución de problemas

Si Python falla mientras compila, comprueba el registro.
Si la última acción fue compilar un diccionario, intenta excluirlo.
Esto se puede hacer en <raíz del repositorio de NVDA>/nvdaHelper/espeak/sconscript.
Recuerda informar del fallo al proyecto Espeak-NG.

Si la compilación falla, toma nota del error, compara las diferencias del archivo makefile.am y refleja
cualquier cambio en nuestro archivo sconscript.

Problemas conocidos

Debido a problemas con el soporte de emojis (que causa errores fatales), se excluyen los archivos de diccionario de emojis
de la compilación. Se eliminan antes de compilar los diccionarios en el
archivo <raíz del repositorio de NVDA>/nvdaHelper/espeak/sconscript.