- Autor: Héctor J. Benítez Corredera
- Versión actual: 2024.09.07 estable
- Compatibilidad con NVDA: de 2024.1 en adelante
- Descargar versión estable
- Ver código fuente en GitHub
Índice
- 1 – Introducción
- 1.1 – Requisitos
- 1.2 – Limitaciones y advertencias
- 1.3 – Información del autor
- 2 – Descripción y configuración
- 2.1 – Descripción de servicios
- 2.2 – Configuración
- 3 – Solución de Problemas
- Problemas Comunes y Soluciones
- Cómo Consultar el Log de NVDA
- 4 – Agradecimientos
- 5 – Registro de Versiones
- Versión 1.0
1 – Introducción
El Traductor Avanzado para NVDA es un complemento que permite traducir textos utilizando diversos servicios de traducción en línea, como Google Translate, DeepL, LibreTranslate y Microsoft Translator. Este complemento ofrece funcionalidades avanzadas como traducción simultánea, historial de traducciones, traducción de lo seleccionado, soporte para múltiples lenguajes y más.
1.1 – Requisitos
- NVDA (NonVisual Desktop Access) 2024.1 o superior
- Conexión a Internet
1.2 – Limitaciones y advertencias
El complemento envía información a Internet a cada servicio correspondiente para realizar la traducción simultánea. Es importante tener en cuenta que la información que se está traduciendo puede incluir datos confidenciales y sensibles. El uso del complemento es responsabilidad exclusiva del usuario, quien debe evaluar la naturaleza de la información que se envía. El desarrollador del complemento no asume ninguna responsabilidad por los datos enviados a los servicios que el complemento utiliza.
Como desarrollador, declino toda responsabilidad por cualquier eventualidad que pueda surgir del uso del complemento. La responsabilidad completa recae en el usuario.
Además, el complemento requiere una conexión a Internet para su funcionamiento. La velocidad de respuesta del complemento depende de varios factores, tales como:
– La calidad de nuestra conexión a Internet.
– El posible retraso (lag) de los servicios de traducción utilizados.
– Factores relacionados con la infraestructura de red del usuario.
Es recomendable que los usuarios sean conscientes de estos aspectos y realicen las pruebas necesarias para asegurar que el complemento cumple con sus expectativas y requisitos de seguridad.
1.3 – Información del autor
Información Técnica y Medidas de Seguridad del Complemento para NVDA
He trabajado arduamente para hacer el complemento lo más robusto posible, contemplando y manejando cualquier error potencial. Todos los errores son capturados y registrados en el log de NVDA, lo que facilita el seguimiento y la rápida resolución de inconvenientes.
Problemas con Certificados de Windows
Recientemente, he observado que los ordenadores recién instalados con Windows pueden presentar problemas con los certificados, lo cual puede ser frustrante. Por esta razón, he incorporado una comprobación al inicio del complemento. Si se detecta un fallo relacionado con los certificados, el complemento se encargará de regenerarlos automáticamente, asegurando un funcionamiento correcto tanto de Windows como del propio complemento.
Medidas de Seguridad
El complemento incluye varias medidas de seguridad:
– No se permite su ejecución en pantallas seguras.
– No se inicia si no se detecta una conexión a Internet.
En ocasiones, NVDA puede iniciarse más rápido que la conexión a la red Wi-Fi. En tales casos, será necesario reiniciar NVDA una vez establecida la conexión para poder utilizar el complemento correctamente.
Gestión de Claves API
El complemento genera un archivo JSON que almacena las claves API necesarias para aquellos servicios que las requieren. Este archivo, llamado apis.json
, se aloja en la carpeta de usuario de Windows.
Consideraciones sobre el Archivo de Claves
Se ha decidido almacenar este archivo fuera del entorno del complemento para evitar que, al contener información sensible, pueda ser compartido inadvertidamente con una copia portátil de NVDA o en otras situaciones. Si el usuario decide dejar de utilizar el complemento, deberá eliminar manualmente este archivo.
Estas medidas aseguran una mejor gestión y seguridad del complemento, facilitando su uso y mantenimiento.
2 – Descripción y configuración
2.1 – Descripción de servicios
En su primera versión, el complemento ofrece 7 servicios de traducción:
4 Servicios de Google
- 2 Servicios de raspado web: Cada servicio realiza la misma función, pero de manera diferente, asegurando que siempre haya una alternativa disponible en caso de fallo de uno de ellos.
- 2 Servicios a través de API: Estos servicios también son ilimitados y gratuitos, pero el abuso de los mismos puede resultar en un baneo temporal de la IP durante unas horas, después de las cuales el servicio se reestablecerá.
- Todos estos servicios de Google no requieren claves API y son ilimitados y gratuitos.
DeepL
2 Servicios de DeepL
- API Free: Esta opción requiere obtener una clave API Free desde la página de DeepL, la cual ofrece 500,000 caracteres al mes.
- API Pro: Esta opción también requiere una clave API obtenida desde la página web de DeepL. Su uso está condicionado al saldo y al plan contratado en la cuenta de DeepL del usuario.
- Las condiciones de uso de la API de DeepL se encuentran en su página web, y el complemento está limitado por dichas condiciones.
LibreTranslate
1 Servicio de LibreTranslate
- Este servicio mejora constantemente gracias a su aprendizaje neuronal continuo. Aunque actualmente no alcanza la calidad de Google, es perfectamente utilizable.
- Basado en la tecnología de Argos Translate.
- Para usar este servicio se requiere una clave API, la cual se puede obtener realizando una donación a la comunidad NVDA.es.
- Tras donar, se puede solicitar la clave API utilizando el formulario de la siguiente página, indicando en el asunto «solicitud de clave API» y proporcionando la referencia de PayPal, transferencia, etc.
- Además, es posible configurar otros servicios de LibreTranslate añadiendo la clave API y modificando la URL del servicio en la sección de configuración del complemento.
Microsoft Translate
1 Servicio de Microsoft Translate
- Este servicio tiene la limitación de que el uso continuo puede resultar en un baneo temporal de la IP durante unos minutos.
- Este baneo ocurre únicamente con un uso muy intensivo y en traducciones de textos largos.
- El servicio funciona muy bien, pero se recomienda no usarlo de manera continua para evitar interrupciones.
Estas opciones permiten a los usuarios elegir entre varios servicios de traducción, asegurando la disponibilidad y la flexibilidad del complemento según las necesidades y preferencias individuales.
Conforme el complemento reciba actualizaciones, pueden añadirse o eliminarse servicios. Se informará de los cambios en la sección de actualizaciones.
2.2 – Configuración
Configuración del Complemento
En esta sección, se detalla cómo configurar cada uno de los servicios disponibles en el complemento, incluyendo cómo agregar claves API, modificar URL de servicios y otros ajustes necesarios para personalizar el uso del complemento según las necesidades del usuario.
Menú del complemento
En NVDA > Preferencias > Traductor Avanzado tenemos un menú que contiene lo siguiente:
- Configuración de Traductor Avanzado
Si pulsamos esta opción se abrirá la ventana de configuración del complemento. Dicha ventana tiene 2 áreas:
-
General
En esta pestaña se agregarán aquellas opciones de carácter general del complemento. Actualmente, solo tiene una casilla de verificación para activar o desactivar la caché del complemento.
El complemento puede guardar una caché de aquellas traducciones para cada aplicación, lo que facilitará la traducción y será más rápido en futuras traducciones. Además, ahora crea caché para cada idioma, pudiendo haber más de una aplicación que tenga caché para distintos idiomas.
-
Módulos de traducción
En esta pestaña podremos elegir el servicio que deseamos usar para traducir. En aquellos servicios que requieran de clave API, se mostrará también el gestor de claves API.
Podemos tener más de una clave API para un mismo servicio; por ejemplo, en LibreTranslate podemos tener distintas claves y URLs para conectarnos. Podremos añadir, editar, eliminar y poner por defecto la clave API que deseamos para el servicio actual.
El área de gestión de claves API cambia según el servicio que tengamos. Podemos poner un nombre identificativo a cada clave API para saber rápidamente a qué API nos referimos. Cuando tengamos más de una clave API para un servicio, el item que en la lista tenga un asterisco será el que esté por defecto. Esto se puede cambiar con el botón «Por defecto», pasando a ser la definida para dicho servicio la clave que tengamos enfocada en ese momento.
Si el servicio de traducción que elijamos no requiere clave API, el gestor no se mostrará.
Luego tenemos el botón «Aceptar» y «Cancelar». Todas las opciones tienen su tecla de atajo que nos informará NVDA.
-
Documentación del complemento
Si pulsamos «Documentación del complemento» se abrirá esta documentación.
- Invítame a un café si te gusta mi trabajo
Si pulsamos esta opción, se abrirá la página de PayPal donde hay un enlace que dice «Enviar». Si pulsamos dicho enlace, nos pedirá que iniciemos sesión en nuestra cuenta y nos dejará en la página de donaciones.
Solo diré que me he tomado muchos cafés haciendo este complemento.
Teclas rápidas del complemento
En NVDA > Preferencias > Gestos de entrada… > Traductor Avanzado tenemos las siguientes teclas que podremos configurar.
Las teclas por defecto vienen sin asignar para que sea el usuario quien elija su mejor distribución. Son las siguientes:
- Abre la configuración del complemento
Este acceso nos abrirá rápidamente la configuración del complemento.
- Activa o desactiva la caché de traducción
Este acceso activará o desactivará la caché sin necesidad de entrar a la configuración.
- Activa o desactiva la traducción simultánea Online
Este acceso activa o desactiva la traducción. Es el acceso principal que nos empezará a traducir conforme nos movamos con las flechas de cursor. Si todo está correcto, oiremos la traducción; en caso de oír el texto original, tendremos que mirar el log de NVDA y ver qué ha sucedido.
- Cambiar el módulo de traducción
Este acceso nos abrirá una ventana con todos los servicios de traducción disponibles. Podremos movernos con las flechas y seleccionar con «Intro». El servicio que seleccionemos será el que tengamos por defecto.
- Cambiar idioma de destino
Este acceso nos abrirá una ventana con los idiomas de destino disponibles en el servicio que tengamos seleccionado. Cada servicio tiene unos idiomas y, por ejemplo, si estamos traduciendo un texto que está en ruso y queremos oírlo en inglés, en este diálogo tendremos que seleccionar inglés. Nos movemos por el diálogo con flechas de cursor y «Intro» para seleccionar el idioma que deseamos.
Los nombres de los idiomas se obtienen en nuestro lenguaje desde NVDA, admitiendo aquellos que NVDA soporta. Por eso, en la lista pueden aparecer nombres de idiomas que están en inglés, ya que NVDA no los tiene traducidos. Se agrega al lado de cada nombre de idioma el código ISO del idioma.
- Cambiar idioma de origen
Lo mismo que el anterior, pero este diálogo solo es válido para el traductor de Microsoft. El servicio de Microsoft no permite poner el idioma de origen como auto para que detecte qué idioma se le envía, por lo que tendremos que elegirlo nosotros.
El resto de los servicios no podrá usar este diálogo ya que su opción por defecto de origen es detectar qué idioma se está enviando.
- Copiar el último texto traducido al portapapeles
Este acceso nos copiará al portapapeles el último texto que haya sido traducido.
- Eliminar la caché de traducción para la aplicación enfocada actualmente
Si pulsamos este acceso una vez, nos dará información; si lo pulsamos dos veces rápidamente, borrará la caché para la aplicación que en ese momento tenga el foco y nos informará del resultado.
- Eliminar todas las traducciones en caché para todas las aplicaciones
Este acceso, pulsado una vez, nos dará información; pulsado dos veces rápidamente, borrará toda la caché del complemento ofreciendo también información.
- Muestra el historial de traducción
Mostrará un diálogo con las últimas 500 traducciones en una lista. Podremos buscar y revisar en cuadros de solo lectura el texto origen y el texto traducido. Este diálogo nos permitirá buscar en todo el historial, copiar al portapapeles tanto el texto origen como el texto traducido o ambos.
También permite alternar entre texto origen y texto traducido y trabajar con cualquiera de las dos maneras. Además, podremos borrar todo el historial para empezar desde cero.
Advierto que el historial se borra cada vez que NVDA se reinicia.
- Traduce el texto seleccionado
Esta acción traducirá el texto que tengamos seleccionado y enfocado. Si es un texto grande, nos abrirá un diálogo con el porcentaje de la traducción. Dicho diálogo puede ser cancelado, lo que también cancelará la traducción.
Una vez la traducción se complete, el texto será mostrado en un diálogo para que podamos explorarlo.
Esta opción usa el servicio de Google Translate y no puede ser cambiado dicho servicio, siendo elegido internamente ya que es el que mejor resultados da para textos largos.
3 – Solución de Problemas
Problemas Comunes y Soluciones
Conexión a Internet
– Verifique que su conexión a Internet esté activa y funcionando correctamente.
– Reinicie su enrutador o módem si es necesario.
Errores de Certificados
– Si experimenta errores de certificados, asegúrese de que la fecha y hora de su sistema estén correctas.
– Verifique que los certificados necesarios estén instalados y actualizados.
Problemas de Rendimiento
– Asegúrese de que su equipo cumple con los requisitos mínimos del sistema.
– Cierre otras aplicaciones que puedan estar consumiendo muchos recursos.
Cómo Consultar el Log de NVDA
- Abra NVDA.
- Vaya a
NVDA > Herramientas > Ver registro
. - En la ventana del registro, busque cualquier error o mensaje relacionado con el Traductor Avanzado.
4 – Agradecimientos
Agradecer a todos los programadores de NVDA por su excelente trabajo.
Y no quiero dejar de decir que el principio de este complemento es el complemento de Yannick PLASSIARD (TRANSLATE), del cual e aprendido y e usado alguna función.
También a Alexy Sadovoy aka Lex, ruslan, beqa, Mesar Hameed, Alberto Buffolino, and other NVDA contributors también por el complemento (Instant Translate) del cual se obtuvo uno de los métodos para Google y fue modificado para implementarlo en Traductor Avanzado.
Este complemento es el trabajo de varios años sacando versiones no oficiales y el estudio de usar traducciones sin conexión.
El aprendizaje es el resultado de este complemento teniendo en claro que a futuro traerá novedades sorprendentes.
5 – Registro de Versiones
Versión 2024.06.06
- Lanzamiento inicial del complemento.
- Soporte para 7 servicios de traducción.
- Funcionalidades básicas de traducción simultánea y gestión de claves API.