version v22.12.1

updated english and spanish readme. See the log for more changes in this version.

addon/doc/es/README.md

@@ -1,11 +1,20 @@
 # Controlador de IBMTTS, complemento para NVDA #
+
   Este complemento implementa la compatibilidad de NVDA con el sintetizador IBMTTS.
   No podemos distribuir las librerías de IBMTTS. Esto es únicamente el controlador.
   Si deseas contribuir a mejorar este controlador ¡siéntete libre de enviarnos tus pull requests a través de GitHub!
 
+Aunque este driver es compatible con librerías de Eloquence debido a que Eloquence posee la misma api que IBMTTS, no se recomienda usar Eloquence con este controlador debido a problemas de licencias. Antes de usar cualquier librería de síntesis con este controlador, se recomienda obtener los derechos de uso primero.
+
+Este controlador fue desarrollado con la documentación disponible para IBMTTS, disponible públicamente en la web. Ver la sección referencias para más detalles.
+
 ## Descarga.
 La última versión está disponible para [descargar en este enlace](https://davidacm.github.io/getlatest/gh/davidacm/NVDA-IBMTTS-Driver)
 
+## ¿Qué es el sintetizador IBMTTS?
+
+ViaVoice TTS es un motor de texto a voz desarrollado por IBM, que sintetiza la representación textual del lenguaje humano en voz.
+
 ## Características:
 * Soporte para las configuraciones de voz,variante, velocidad, tono, entonación y volumen.
 * Soporte de  parámetros  extra como  tamaño de la cabeza, carraspeo, respiración. ¡Cree su propia voz!
@@ -33,6 +42,7 @@ La última versión está disponible para [descargar en este enlace](https://dav
   A partir de la versión 21.03A1, el controlador también funciona con las librerías aún más nuevas de IBM, en lugar de solo los SpeechWorks. Se incluye un conjunto de correcciones independientes para esas librerías, y se tienen en cuenta los idiomas adicionales y otras diferencias. Solo se soportan las voces formantes en la actualidad. Gracias a @mohamed00 por este trabajo. Tenga en cuenta que cuando se utiliza las librerías de IBM, debes deshabilitar la opción Enviar siempre la configuración de voz actual.
 
 ## Instalación.
+
   Simplemente instálelo como cualquier otro complemento de NVDA. Después abre el diálogo de configuraciones de NVDA, y en la categoría IBMTTS establezca la ruta de los archivos de IBMTTS.
   En esta categoría también puedes copiar los archivos externos de IBMTTS dentro del complemento para usarlo localmente, útil para versiones portables de NVDA.
 
@@ -59,9 +69,20 @@ Nota: asegúrate de que has utilizado la última plantilla de cadenas de traducc
 Este es un método alternativo. Si quieres, siempre puedes usar la forma habitual. Haz un fork de este repo, actualiza la traducción para el idioma destino, y envía un PR. Pero esta forma sólo añadirá más complejidad para usted.
 
 ## Empaquetar el complemento para su distribución.
-  Abra una línea de comandos, cambie al directorio raíz del complemento y ejecute el comando scons. El complemento creado, si no hay errores, será puesto en la carpeta raíz del complemento.
+
+1. Instale python, actualmente se usa python 3.7, pero puedes usar una versión más reciente si lo deseas.
+2. Instala Gettext, puedes descargar una distribución para windows en [este enlace.](https://mlocati.github.io/articles/gettext-iconv-windows.html) Si estás usando Windows 64 bits, te recomiendo [esta versión.](https://github.com/mlocati/gettext-iconv-windows/releases/download/v0.21-v1.16/gettext0.21-iconv1.16-shared-64.exe)
+3. (paso opcional pero recomendado) crea un entorno virtual de python para administrar los complementos de NVDA. En la consola, use "python -m venv PAT_TO_FOLDER". Donde PAT_TO_FOLDER es la ruta deseada para el entorno virtual.
+4. Si realizaste el paso 2, Ve a PAT_TO_FOLDER y dentro de la carpeta de scripts, ejecuta "activate". El nombre del entorno debe mostrarse en el indicador de la consola.
+5. Clone este repositorio en la ruta deseada: git clone "https://github.com/davidacm/NVDA-IBMTTS-Driver.git".
+6. En la misma instancia de la consola, vaya a la carpeta de este repositorio.
+7. Instale los requisitos: "pip install -r requirements.txt".
+8. Ejecuta el comando scons. El complemento creado, si no hubo errores, se coloca en el directorio raíz de este repositorio.
+
+Una vez que cierras la consola, el entorno virtual se desactiva.
 
 ### Empaquetar las librerías como un complemento independiente.
+
 No se recomienda incluir las librerías con este controlador. Es porque si el usuario actualiza el driver desde el
 [repo oficial](https://github.com/davidacm/NVDA-IBMTTS-Driver),
 la versión antigua será eliminada incluyendo las librerías. Una solución para esto, es instalar las librerías en un complemento separado.

changelog.md

@@ -1,12 +1,8 @@
-# v22.12
+# v22.12.1
 
-* updated spanish strings and documentation.
-* updated the template of locale strings (for translators).
-* fixed a spanish crashing pattern.
-* changed the Chinese character encoding from GB2312 to CP936 (GBK). This enables IBMTTS implementations that support it to read more characters, including Traditional Chinese ones. This should be backwards compatible with GB2312, but versions that only support that encoding won't be able to read the extra characters. Fixes #57.
-* Updated readme with new information on the best DLL to use for IBMTTS. Added a new section to explain how to report new issues.
-* Removed access to the 22 kHz option that previously appeared if using IBMTTS, due to some reasons related with the IBMTTS libraries.
-* Updated IBMTTS anticrash to catch more cases.
-* Updated german interface and documentation.
-* Updated voice names to use the proper set. This also means that voices 3, 5, and 6 are finally named properly after many years.
-* Renamed Enable abbreviation dictionary setting to Enable abbreviation expansion for clarity.
+* fixed soundcard detection issues when another tts is used in other NVDA profile. This was happening because register and unregister the profile switch handler was being done exactly in the same moment as the profile changing. So, a delay of 1S was added to register or unregister that function.
+* Changed the Chinese encoding again, from CP936 to GB18030. This can represent more characters.
+* Added a \b to the Spanish IBM crashing expression to prevent false positives on things like 20ª.
+* Updated the english readme with specific steps to package the driver and a small note about Eloquence.
+* Updated the spanish documentation.
+* updated portuguese locale strings and documentation.

readme.md

@@ -4,6 +4,10 @@
   We can not distribute the IBMTTS libraries. So it is just the driver.  
   If you want to improve this driver, feel free to send your pull requests!  
 
+Although this driver is compatible with Eloquence libraries (since Eloquence has the same api as IBMTTS) it's not recommended to use Eloquence with this driver due to licensing issues. Before using any synthesis libraries with this driver, it's recommended to get the license usage rights first.
+
+This driver was developed with the documentation available for IBMTTS, publicly available on the web. See references section for more details.
+
 ## Download.
 The latest release is available to [download in this link](https://davidacm.github.io/getlatest/gh/davidacm/NVDA-IBMTTS-Driver)
 
@@ -65,9 +69,20 @@ Note: make sure you have used the latest translation strings template.
 This is an alternative method. If you want, you always can go by the usual way. Fork this repo, update the translation for your language, and send me a PR. But this way just will add more complexity for you.
 
 ## Packaging it for distribution.
-  Open a command line, change to the Add-on root folder  and run the scons command. The created add-on, if there were no errors, is placed in the root directory.
+
+1. Install python, currently python 3.7 is used, but You can use a newer version.
+2. Install gettext, you can download a distribution for windows in [this link.](https://mlocati.github.io/articles/gettext-iconv-windows.html) If you're using windows 64 bits, I recommend [this version.](https://github.com/mlocati/gettext-iconv-windows/releases/download/v0.21-v1.16/gettext0.21-iconv1.16-shared-64.exe)
+3. (optional but recommended step) create a python virtual environment to be used to manage NVDA add-ons. In the console, use "python -m venv PAT_TO_FOLDER". Where PAT_TO_FOLDER is the path of your desired path for the virtual environment.
+4. If you did step 2, go to the PAT_TO_FOLDER and inside scripts folder, execute "activate". The name of the environment should be shown in the console pront.
+5. Clone this repo in your desired path: "git clone https://github.com/davidacm/NVDA-IBMTTS-Driver.git".
+6. In the same console instance, go to the folder of this repo.
+7. Install the requirements: "pip install -r requirements.txt".
+8. Run the scons command. The created add-on, if there were no errors, is placed in the root directory of this repo.
+
+Once you close the console, the virtual environment is deactivated.
 
 ### Packagin libraries as an independent add-on.
+
 Is not recommended to include the libraries with this driver. It's because if the user updates the driver from the
 [official repo](https://github.com/davidacm/NVDA-IBMTTS-Driver),
 the old version will be deleted including the libraries. One solution for this, is to install the libraries in a separate add-on.