hxebolax / TranslateAdvanced

Traductor Avanzado para NVDA es un complemento que permite traducir textos usando Google Translate, DeepL, LibreTranslate y Microsoft Translator. Ofrece traducción simultánea, historial y gestión de claves API. Fácil de configurar y usar, con teclas rápidas y opciones personalizables en el menú de NVDA.
GNU General Public License v2.0
4 stars 5 forks source link

Manual del Usuario: Traductor Avanzado para NVDA

Índice

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.

Volver al índice

1.1 - Requisitos

Volver al índice

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:

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.

Volver al índice

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:

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.

Volver al índice

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:

Google

4 Servicios de Google

DeepL

2 Servicios de DeepL

LibreTranslate

1 Servicio de LibreTranslate

Microsoft Translate

1 Servicio de Microsoft Translate

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.

Volver al índice

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.

En NVDA > Preferencias > Traductor Avanzado tenemos un menú que contiene lo siguiente:

Volver al índice

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:

Volver al índice

3 - Solución de Problemas

Problemas Comunes y Soluciones

Conexión a Internet

Errores de Certificados

Problemas de Rendimiento

Volver al índice

Cómo Consultar el Log de NVDA

  1. Abra NVDA.
  2. Vaya a NVDA > Herramientas > Ver registro.
  3. En la ventana del registro, busque cualquier error o mensaje relacionado con el Traductor Avanzado.

Volver al índice

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.

Volver al índice

Traductores

Volver al índice

5 - Registro de Versiones

En este apartado se añadira un registro de versiones, donde se iran poniendo las novedades de cada versión.

El manual esta basado en la primera versión por lo que no se actualizara sirviendo como base.

Las novedades se agregarán en esta sección.

Volver al índice

Versión 2024.06.06

Volver al índice

Versión 2024.06.16

Se ha añadido una opción para copiar automáticamente al portapapeles el texto traducido cuando se selecciona esta función, evitando la necesidad de mostrar un cuadro de diálogo adicional.

Dicha opción se añadió en el dialogo de configuración del complemento en General.

Si dicha opción se marca ya no mostrara cuando traduzcamos un texto seleccionado un dialogo si no que directamente lo copiara al portapapeles.

Ahora es posible traducir directamente el contenido que se encuentra en el portapapeles, proporcionando una manera rápida y eficiente de traducir textos copiados.

Si no se traduce nada nos dirá que hay en el portapapeles o si no hay nada en el portapapeles nos notificara con un mensaje.

Se ha incorporado una funcionalidad que permite traducir la última frase o texto verbalizado por el sintetizador de voz, mejorando la accesibilidad y usabilidad del complemento.

Si no se puede traducir lo ultimo verbalizado nos dirá lo ultimo que se verbalizo en el idioma origen.

La nueva versión incluye soporte para mostrar las traducciones en dispositivos de línea braille, facilitando el acceso a las traducciones.

Solo funcionara en aquellos equipos que tengan configurada una línea braille.

Esta función esta en fase de pruebas.

Se ha implementado un actualizador que permite mantener los idiomas del complemento siempre actualizados, asegurando la disponibilidad de los idiomas más recientes y precisos.

Ahora en el menú de NVDA > Preferencias > Traductor Avanzado

Tendremos un nuevo item llamado Actualizar idiomas del complemento (Sin actualizaciones).

Dicho item puede que nos informe si existen actualizaciones, por ejemplo:

Actualizar idiomas del complemento (3 actualizaciones disponibles)

Si lo pulsamos nos saldrá un dialogo con los nuevos idiomas, con las actualizaciones o con alguna de las dos si no hay en ambas.

Podremos instalar o omitir.

Si damos a instalar se descargarán los idiomas e instalarán y NVDA se reiniciará.

El item del menú se actualiza cada 30 minutos comprobando si hay actualizaciones o en cada reinicio.

El gasto de datos de esta comprobación es irrisorio por aquellos lugares que tengan problemas de datos es menos de 1kb lo que tiene que comprobar.

Este actualizador facilitara el poder compartir con los usuarios las actualizaciones de los idiomas para el complemento de manera rápida conforme van llegando y sin necesidad de sacar una nueva versión con los nuevos idiomas.

Cada nueva versión del complemento vendrá con todos los idiomas nuevos y actualizados que hayan llegado.

Se ha corregido un problema que causaba errores en la lectura continua, mejorando la estabilidad y el rendimiento del complemento durante el uso prolongado.

A todas las nuevas funciones como traducir el portapapeles, traducir lo ultimo verbalizado por el sintetizador o comprobar actualizaciones de idioma, se le pueden asignar gestos.

Recomiendo que si alguna opción no vamos a usarla no se le agregue gesto de entrada para poder tenerla en otros complementos. Agreguemos aquellas que nos puedan servir.

Conforme se vayan añadiendo utilidades se necesitarán más gestos y puede que una utilidad no sirva a uno y puede que a otro si por lo que asignemos solo los que vayamos a usar.

Volver al índice

Versión 2024.06.23

Este nuevo modulo no necesita de clave API y es utilizado para la traducción simultanea

Volver al índice