El complemento Anotador rápido es una maravillosa herramienta que permite
escribir en cualquier momento notas fácil y rápido y desde cualquier
aplicación que el usuario esté utilizando. Si el usuario está visualizando
un vídeo, por ejemplo, o participando en una reunión en Zoom, Teams o Google
Meet, puede abrir fácilmente el anotador y tomar una nota. Para crear una
nota rápida, se puede usar la combinación de teclado NVDA+alt+n. Aparecerá
una ventana en la esquina superior izquierda de la pantalla para que se
pueda escribir la nota en ella.

Cada nota que se crea puede contener, opcionalmente, el título de la ventana
activa y, por tanto, los contenidos de la nota pueden tener el contexto en
el que fue creada teniendo por título el de la ventana activa en la que se
encontraba el usuario. Se puede cambiar este comportamiento en las opciones
del complemento, donde el usuario puede decidir si se captura el título de
la ventana activa al crear una nueva nota.

El diálogo del anotador

  • El área de edición de notas: al abrir la interfaz del anotador, el foco
    se encontrará en esta zona de edición. También se permite escribir en
    Markdown (un lenguaje de marcado para producir con facilidad contenido
    HTML). Para más información sobre Markdown, visita la página de guía de
    Markdown
    .

  • Previsualizar nota: muestra la nota en una ventana HTML.

  • Copiar: copia la nota tal y como está al portapapeles.

  • Copiar código HTML: copia el código HTML que representa la nota. Una
    función útil para quien escribe en Markdown.

  • Una casilla de verificación que permite guardar la nota también como
    Microsoft Word, o actualizarla si existe.

  • Un botón para guardar y cerrar.

  • Un botón Descartar para descartar los cambios cuando se desee. Cuando
    existan cambios sin guardar, se mostrará un mensaje de aviso al usuario
    preguntando si desea salir y descartar los cambios.

La interfaz del gestor de notas

Apertura y cierre de esta interfaz

  • NVDA+alt+v lanzará la interfaz del gestor de notas.

  • La interfaz se cerrará al pulsar la tecla Escape o el botón Cerrar
    situado en la parte inferior de la ventana.

La lista de notas

Las notas se organizan en una lista tabulada que incluye:

  1. El título de la nota: si la nota no tiene el título de la ventana
    activa, se mostrará su primera línea como título de nota en esta lista.

  2. Fecha y hora de última modificación.

  3. Un texto de previsualización del contenido de la nota.

Opciones disponibles en la interfaz del gestor de notas

  • Ver nota: muestra la nota en una ventana HTML.

  • Editar nota: abre la nota en la interfaz del anotador para que pueda
    editarse.

  • Copiar nota: copia el contenido de la nota tal y como está al
    portapapeles.

  • Crear documento de Microsoft Word: crea un documento de Microsoft Word
    que representa la nota, en caso de que dicho documento no exista.

  • Abrir en Microsoft Word: abre el documento Microsoft Word adjunto a la
    nota, en caso de que lo tenga.

  • Copiar código HTML: copia el código HTML representado por esta
    nota. Función útil para quienes escriben en Markdown.

  • Eliminar nota: muestra un aviso antes de realizar la eliminación de la
    nota.

  • Nueva nota: se puede llegar a la interfaz del anotador desde aquí para
    crear una nota nueva.

  • Abrir opciones: también es posible abrir las opciones del complemento
    desde aquí.

  • Cerrar: cierra la ventana.

Opciones del complemento

Las opciones del complemento forman parte de la interfaz de opciones de
NVDA. Para llegar hasta ellas,el usuario debe abrir el menú pulsando el
atajo NVDA+n, elegir Preferencias > Opciones, y después flecha abajo
hasta llegar a la categoría Anotador rápido.

Utilizando la interfaz de las opciones, el usuario puede:

  • Carpeta predeterminada de documentos: elegir el directorio por defecto
    donde se guardarán los documentos del anotador rápido. El usuario puede
    pulsar el botón «Examinar» para cambiar la ruta de esta carpeta.

  • Preguntarme siempre dónde guardar el documento Microsoft Word
    correspondiente a la nota: una casilla de verificación (desmarcada por
    defecto) que muestra el diálogo para elegir la ubicación donde se
    guardará el documento en cada operación de guardado o actualización del
    documento Microsoft Word de la nota, si existe uno.

  • Abrir el documento Microsoft Word correspondiente a la nota después de
    guardar o actualizar: una casilla de verificación (desmarcada por
    defecto) que permite al usuario elegir si se abrirá el documento
    Microsoft Word después de una operación de guardado o actualización, en
    caso de que la nota disponga de dicho documento.

  • Capturar el título de la ventana activa al crear una nueva nota: una
    casilla de verificación (marcada por defecto) que permite que la nota
    contenga el título de la ventana activa que el usuario estaba utilizando
    cuando creó la nota. Este título también será el título del documento
    Microsoft Word de la nota, en caso de que haya uno.

  • Recordar tamaño y posición de la ventana del anotador: una casilla de
    verificación (desmarcada por defecto) para pedir al complemento que
    recuerde el tamaño y la posición del diálogo del anotador al crear o
    editar una nota. La próxima vez que el usuario abra el diálogo, la
    posición y el tamaño serán los mismos que la última vez que se usó. La
    posición por defecto de este diálogo es la esquina superior izquierda de
    la pantalla.

  • Alinear texto automáticamente cuando se editen notas (importante en
    idiomas de derecha a izquierda): una casilla de verificación (marcada
    por defecto) para controlar si el texto se alinea automáticamente al
    crear o editar notas en función del idioma en uso. Esto es
    mayoritariamente importante para idiomas con escritura de derecha a
    izquierda. Por ejemplo, si el idioma usado es árabe o hebreo, el texto
    se alineará a la derecha cuando esta opción esté activada, y el texto en
    inglés o francés se alineará a la izquierda.

Atajos de teclado

  • NVDA+alt+n: abre la interfaz del anotador.

  • NVDA+alt+v: abre la interfaz del gestor de notas.

Atajos de teclado de las distintas interfaces

Interfaz Orden Atajo de teclado
Anotador Llevar el foco al área de edición de notas Alt + n
Anotador Alinear texto a la derecha Control + r
Anotador Alinear texto a la izquierda Control + l
Anotador Previsualizar la nota en una ventana HTML Alt + r
Anotador Copiar Alt + p
Anotador Copiar código HTML Alt + h
Anotador Guardar nota como documento de Microsoft Word Alt + w
Anotador Actualizar el documento Microsoft Word correspondiente a la nota Alt + w
Anotador Guardar y cerrar Alt + s
Anotador Descartar Alt + d
Anotador Abrir gestor de notas Alt + m
Gestor de notas Ver nota Alt + v
Gestor de notas Editar nota Alt + e
Gestor de notas Copiar nota Alt + p
Gestor de notas Abrir en Microsoft Word (si existe un documento) Alt + o
Gestor de notas Crear un documento Word para una nota guardada Alt + w
Gestor de notas Copiar código HTML Alt + h
Gestor de notas Eliminar nota Alt + d
Gestor de notas Nueva nota Alt + n
Gestor de notas Abrir opciones Alt + s
Gestor de notas Cerrar la interfaz Alt + c
Interfaz de opciones Preguntarme cada vez dónde guardar el documento Microsoft Word correspondiente a la nota Alt + w
Interfaz de opciones Abrir el documento Microsoft Word correspondiente a la nota después de guardar o actualizar Alt + o
Interfaz de opciones Capturar el título de la ventana activa al crear una nueva nota Alt + c
Interfaz de opciones Recordar tamaño y posición de la ventana del anotador Alt + r
Interfaz de opciones Alinear el texto automáticamente al editar notas (importante para idiomas de derecha a izquierda) Alt + t

Reconocimientos

  • El complemento viene con Pandoc incorporado, una fantástica herramienta
    que permite convertir documentos entre distintos formatos. Sin esta
    herramienta, el complemento no podría ofrecer las funciones que
    ofrece. Para más información sobre Pandoc, visita la página de
    Pandoc
    .

  • El complemento también se apoya en un paquete Python de Markdown llamado
    markdown2. Para más información sobre este paquete, visita su página en
    GitHub
    .

  • ¡Un efusivo agradecimiento a NV Access, los autores de complementos y
    colaboradores! Algunas partes de este complemento se han inspirado en
    vuestro magnífico trabajo y esfuerzo, seguid con este brillante
    ecosistema y cooperación.

Este complemento de NVDA altera el anuncio de la sangría ignorando líneas en blanco cuando se decide anunciar cambios de sangría. Es mejor contrastarlo con el comportamiento normal mediante un ejemplo.

Plantéate el siguiente ejemplo:

def foo():
    x = 42

    return x

def bar():

El comportamiento actual de NVDA consiste en anunciar los cambios de sangría en cualquier línea donde la sangría haya cambiado, incluso si la línea está en blanco. Por tanto, el ejemplo se leería así:

def foo():
tab x = 42
sin sangría en blanco
tab return x
sin sangría en blanco
def bar():

La desventaja de este comportamiento es que en la mayoría de lenguajes de programación, como Python, una línea en blanco no tiene importancia semánticamente y y se emplea para separar visualmente líneas de código sin cambios al significado del mismo. Por tanto, al anunciar el cambio de sangría al entrar en una línea en blanco y anunciarlo otra vez al aterrizar en la siguiente línea, se produce ruido que dificulta concentrarnos en entender el código.

Este complemento pretende mejorar el comportamiento ignorando las líneas en blanco al procesar la sangría por voz, de tal modo que el ejemplo anterior se leería de la siguiente manera:

def foo():
tab x = 42
en blanco
return x

sin sangría def bar():

Registro de cambios

versión 0.1

  • Versión inicial

Código fuente

Repositorio del código fuente

Este complemento emite información sobre objetos en los que se han disparado
eventos. Entre las propiedades registradas en el nivel de registro de
depuración se incluyen el tipo de objeto, su nombre, rol, evento, módulo de
aplicación, e información específica de la API de accesibilidad como el
accName del objeto IAccessible y el Id de automatización en objetos UIA.

Notas:

  • Este complemento está pensado para desarrolladores y usuarios avanzados
    que necesitan rastrear eventos procedentes de aplicaciones y diversos
    controles.
  • Para usar el complemento, NVDA debe tener el registro en modo depuración
    (configurado desde Opciones generales / Nivel de registro, o reiniciado
    con el registro de depuración habilitado).
  • Podría ser posible que los complementos cargados antes que el reastreador
    de eventos no pasen el evento a otros complementos, incluido el rastreador
    de eventos. Si esto sucede, el rastreador de eventos no será capaz de
    registrar eventos.
  • Los eventos se manejan desde las extensiones globales, módulos de
    aplicación, interceptores de árbol y objetos de NVDA, en ese orden.

Eventos y su información

Se rastrean y registran los siguientes eventos:

  • Manipulación del foco: obtención de foco, pérdida de foco, foco
    introducido, primer plano
  • Cambios: nombre, valor, estado, descripción, región viva
  • Eventos UIA: controlador para, elemento seleccionado, estado del elemento,
    diseño invalidado, notificación, cambio de texto, globo de ayuda abierto,
    ventana abierta

Se registra la siguiente información de cada evento:

  • Nombre del evento
  • Objeto
  • Nombre del objeto
  • Rol del objeto
  • Estado o valor del objeto, dependiendo de los eventos
  • Módulo de aplicación
  • En objetos IAccessible: nombre acc, ID del hijo
  • En objetos UIA: Id de automatización, nombre de clase, propiedades de
    notificación si se registra información de eventos de notificación,
    cantidad de hijos para el evento de diseño invalidado

Versión 21.10

  • Se requiere NVDA 2021.2 o posterior a causa de cambios en NVDA que afectan
    a este complemento.
  • Se seguirá el evento UIA diseño invalidado.
  • La información de rol y estados de un objeto se parecerá a la información
    para desarrolladores que se encuentra en las versiones más recientes de
    NVDA.

Versión 21.07

  • Versión inicial.

Este complemento te ayuda a buscar texto mediante diversos motores de
búsqueda. Si no hay texto seleccionado y se pulsa el gesto del complemento,
se mostrará un cuadro de diálogo con un cuadro de edición para introducir la
consulta de búsqueda. Para buscar con Google pulsa intro, o tabula para
buscar con otros motores.

Y si quieres buscar el texto seleccionado, selecciona algo de texto y pulsa
una vez. Se mostrará un menú con varios motores a elegir. También se puede
pulsar dos veces el gesto para buscar directamente el texto seleccionado con
Google.

El gesto predeterminado del complemento es: NVDA+windows+s. Si el atajo no te funciona o hace conflicto con otro atajo, puedes añadir un gesto o cambiar el existente como siempre, yendo a: Menú NVDA > Preferencias > Gestos de entrada > Categoría Search With.

Modo de uso

  • Si quieres introducir una consulta de búsqueda, simplemente pulsa el gesto
    del complemento. Se mostrará un diálogo con un cuadro de edición para
    introducir el término de búsqueda.
  • ¿Quieres buscar con Google? Simplemente pulsa intro.
  • En cualquier otro caso, tabula al botón Otros motores, pulsa la barra
    espaciadora, y se mostrará un menú con diversos motores de búsqueda para
    elegir. Yahoo, Bing, DuckDuckGo, y YouTube. Este es el menú
    predeterminado, y puedes modificarlo desde el panel de opciones del
    complemento.
  • Otra forma de usar el complemento es seleccionando texto. Tras pulsar el
    gesto del complemento, o cualquier otro que hayas asignado, se mostrará un
    menú virtual con diversos motores de búsqueda, ya sea el predeterminado o
    el que te hayas ajustado a tus necesidades.
  • Elige uno y pulsa intro, el navegador predeterminado se abrirá mostrando
    los resultados de búsqueda. O, si quieres buscar con Google directamente,
    pulsa el gesto dos veces.
  • ¿Quieres modificar el menú de Search With? Sí, puedes hacerlo desde el
    panel de opciones, y ajustar el menú para que se adecúe a tus necesidades.
  • Desde allí, puedes añadir si lo deseas otros motores de búsqueda
    disponibles al menú de Search With. Y si quieres, también puedes eliminar,
    subir o bajar elementos, y devolver el menú a su estado por defecto.
  • Si quieres que estas modificaciones sean permanentes, tienes que guardar
    la configuración después.
  • ¿Quieres buscar en Google usando otras opciones de idioma?
  • Entonces, ve a la categoría Search With en los paneles de opciones. Desde
    su cuadro combinado, puedes hacer que Google busque:

    1. Utilizando el idioma y las opciones del navegador.
    2. Utilizando el idioma de NVDA.
    3. Utilizando el idioma de Windows.
  • Por último, tienes la posibilidad de elegir la consulta por defecto para
    el diálogo de Search With desde el cuadro combinado de opciones de
    consulta predeterminada en la configuración, puedes elegir

    • Dejar en blanco
    • Usar texto del portapapeles
    • Usar último texto verbalizado
  • Y si se elige portapapeles o último texto verbalizado, se mostrará el
    texto seleccionado en el cuadro de búsqueda, de modo que puedas
    reemplazarlo con facilidad.

Y esto es todo, espero que encuentres lo que buscas, ¡feliz búsqueda!

Cambios para 1.7

  • Se añade un cuadro combinado a las opciones del complemento para elegir
    una opción de consulta predeterminada en el diálogo de Search With.
  • Puedes elegir dejar en blanco, utilizar el texto del portapapeles o
    utilizar el último texto verbalizado.

Cambios para 1.2

  • Se añaden más sitios que pueden formar parte del menú, como Stackoverflow,
    Stackexchange, GoogleBooks y otros.
  • Se añade la opción de utilizar el último texto verbalizado como consulta
    de búsqueda predeterminada en el diálogo de Search With.

Cambios para 0.4

  • Se añade un diálogo para introducir una consulta de búsqueda si no hay
    texto seleccionado.
  • Se añade la posibilidad de modificar el menú de Search With desde el panel
    de opciones para ajustarlo a las necesidades del usuario.

Cambios para 0.3

  • Se añade un panel de opciones con más ajustes de idioma para la búsqueda
    en Google.

Cambios para 0.1

  • Versión inicial

Funcionalidad

El propósito del complemento es convertir los enlaces de Dropbox, Google
Drive u OneDrive (tanto personal como empresarial) en enlaces
directos. Además, genera un enlace directo a un chat de WhatsApp con el
número de teléfono elegido.

Modo de uso

  • Selecciona o copia un enlace compartido de Dropbox, Google Drive u
    OneDrive
  • Pulsa alt+NVDA+l para convertir el enlace. La URL resultante estará en tu
    portapapeles.
  • Con los números de teléfono se hace del mismo modo. Copia o selecciona el
    número con el que te gustaría chatear o compartir y pulsa el mismo atajo
    (alt+NVDA+l).
  • si quieres abrir en tu navegador el enlace resultante, pulsa
    alt+NVDA+shift+l.

¿Por qué el enlace directo?

Un enlace directo te permitirá obtener el bien conocido cuadro de diálogo de
guardar directamente si lo abres en tu navegador, sin pasar por la página de
descarga de la compañía de alojamiento y buscar el enlace de descarga
allí. Más aún, se puede usar el enlace directo para emitir un archivo o
visualizarlo en ciertos programas, como reproductores multimedia (si vienen
con soporte para URLs). Del mismo modo, si WhatsApp es común en tu país, en
vez de crear un contacto cada vez que necesites chatear con alguien, ya sea
soporte técnico o al cliente, puedes simplemente seleccionar o copiar el
número y comenzar a chatear al instante. Más aún, puedes compartir el enlace
de WhatsApp de tu propio número si la gente necesita contactar contigo con
frecuencia en caso de que trabajes por cuenta propia.

Notas

  • No se puede convertir un enlace a una carpeta; el enlace tiene que dirigir
    a un archivo.
  • Asegúrate de que el enlace que compartes es público (cualquiera que lo
    tenga puede acceder) para que se pueda convertir con éxito.
  • Puedes modificar los atajos desde el menú de NVDA > Preferencias > Gestos
    de entrada.
  • Si encuentras un formato de número de teléfono no detectado, escríbeme un
    correo con un ejemplo.
  • Ciertos tipos de archivos y tamaños en Google Drive te podrían conducir a
    una página que dice «Google Drive no puede analizar este archivo para
    buscar virus». En ese caso, debes hacer clic en el enlace Descargar de
    todas formas.

Reconocimientos

Va un inmenso agradecimiento a los siguientes amigos, sin los cuáles no
podría haberlo hecho posible:

  • Qais Alrefai por probar el complemento y proporcionarme diverso material
    para hacer pruebas, y también por sus observaciones e idea general para el
    complemento.
  • Marina Amir por traducir el complemento al francés, editar el idioma y
    hacer pruebas.
  • Riad Assoum por traducir el complemento al árabe.
  • todos los evaluadores.

Este complemento permite que el lector de pantalla NVDA pueda conectarse a Internet a través de uno o varios servidores proxy. Para ello, aplica diversos parches a la biblioteca estándar de Python o modifica ciertas variables de entorno, dependiendo de la configuración elegida. Podrás actualizar NVDA y sus complementos automáticamente desde tu entorno corporativo, e incluso realizar sesiones remotas, siempre que el servidor proxy de tu organización lo permita.

Características

  • Soporte para diversos tipos de servidor proxy: http, socks4 y socks5.
  • Capacidad de redirigir todo el tráfico a través del servidor proxy o sólo tráfico específico (http, https, ftp).
  • Capacidad de redirigir todo el tráfico a través de un servidor proxy, y después redirigir tráfico específico a través de otros servidores (proxies anidados).
  • Sensible a cambios de perfil y restablecimiento de configuración: si normalmente trabajas con una copia portátil de NVDA, puedes crear diversos perfiles para distintos entornos (casa, trabajo, oficina 1, oficina 2) y activarlos manualmente.

Modo de uso

El complemento añade una nueva categoría a las opciones de NVDA, llamada «Proxy». En esta categoría encontraremos cuatro grupos de opciones. El primero nos permite configurar un proxy general para todo el tráfico. Los otros tres permiten configurar servidores proxy sólo para protocolos específicos. Todos los grupos tienen los siguientes campos:

  • Servidor: nombre de host o dirección ip del servidor proxy. Déjalo vacío para deshabilitar ese proxy en particular.
  • Puerto: puerto del servidor.
  • Usuario: opcional. Nombre de usuario para autenticarse en el servidor.
  • Contraseña: opcional. Contraseña para autenticarse en el servidor. Ten en cuenta que la contraseña no es necesaria en servidores socks4.

Además de los campos anteriores, en el primer grupo de opciones podemos encontrar los siguientes:

  • Tipo de proxy SOCKS: podemos elegir entre socks4, socks5 y http.
  • Usar proxy para solicitudes DNS si es posible: si esta casilla está marcada, los nombres de host o dominio se enviarán directamente al servidor proxy y se resolverán allí. Si está desmarcada, los nombres se resolverán localmente y el servidor sólo recibirá la dirección ip de destino. Ten en cuenta que no todos los servidores socks4 soportan esta opción.

Normalmente, la mayoría de usuarios sólo tendrán que configurar el primer grupo de opciones. Si no conoces los detalles de tu servidor proxy, consulta con el administrador de red de tu organización.

Limitaciones

  • Soporte IPV6 muy limitado.
  • El tráfico UDP no se soporta en todos los tipos de servidores proxy.
  • Las bibliotecas DLL externas no respetarán las opciones configuradas en este complemento.
  • En servidores proxy http, sólo se soporta autenticación básica. La autenticación digest no está soportada.
  • Para poder redirigir todo el tráfico (incluyendo conexiones https) a través de un proxy http, el servidor debe soportar el método http CONNECT.
  • No se puede configurar un modo de «conexión directa». Si deshabilitas un proxy específico, se usará en su lugar el proxy por defecto del sistema.

Registro de cambios

Versión 1.0

  • Versión inicial.

El complemento WordNav para NVDA mejora la navegación por palabras integrada
y añade órdenes extra de navegación con diferentes definiciones de lo que es
una palabra.

La mayoría de editores de texto soportan las órdenes control+flechas
izquierda y derecha para navegar por palabras. Sin embargo, la definición de
palabra cambia de un programa a otro. Esto es especialmente cierto en los
editores de texto modernos basados en web, tales como Monaco. NVDA debería
saber la definición de palabra en un programa dado para verbalizar las
palabras correctamente. Si NVDA no conoce la definición exacta, las palabras
se saltan o se pronuncian varias veces. Por si fuera poco, algunos editores
basados en web sitúan el cursor al final de la palabra en lugar del
principio, dificultando la edición a personas con discapacidad visual. Para
combatir este problema, he creado órdenes de navegación por palabra
mejoradas, que toman la definición de palabra de Notepad++ y no se apoyan en
la definición de palabra de otros programas, y que en su lugar descomponen
las líneas en palabras dentro del propio NVDA. El gesto control+flecha
izquierda o flecha derecha ni siquiera se envía al programa, garantizando
por tanto la consistencia del habla.

Antes, el complemento Mejoras de
Tony
incluía un
prototipo de WordNav entre sus funciones. Desinstala o actualiza el
complemento Mejoras de Tony a la versión estable más
reciente

para evitar conflictos.

Actualmente, WordNav soporta cuatro definiciones de palabra, asignadas a
diferentes gestos:

  • Control izquierdo+flechas: definición de Notepad++, que trata los
    caracteres alfanuméricos como palabras, y también trata como palabras las
    marcas de puntuación adyacentes. Esta debería ser la definición de palabra
    más conveniente para la mayoría de usuarios.
  • Control derecho+flechas: definición de palabra Fine, que divide los
    identificadoresCamelCase y los
    identificadores_separados_por_subrayados en partes independientes,
    permitiendo que el cursor se desplace por identificadores largos.
  • Control izquierdo+Windows+flechas: definición de palabra Bulky, que
    trata casi todos los símbolos de puntuación adyacentes al texto como parte
    de una única palabra, por lo que trataría rutas como
    C:\directorio\subdirectorio\archivo.txt como una única palabra.
  • Control derecho+Windows+flechas: definición multipalabra, que agrupa
    varias palabras juntas. El número de palabras es configurable.

Se pueden personalizar todos estos gestos en el panel de opciones de
WordNav.

Notas

  • Por el momento, WordNav no modifica los gestos control+shift+flechas
    izquierda y derecha
    para seleccionar palabras, ya que la implementación
    de estas órdenes es considerablemente más complicada.
  • Si quieres utilizar la función de escritorios virtuales de Windows 10,
    recuerda desactivar los atajos de teclado control+windows+flechas desde el
    panel de opciones de WordNav, o bien en el diálogo Gestos de entrada de
    NVDA.
  • WordNav no tiene un funcionamiento fiable en VS Code. A causa de sus
    optimizaciones internas, VS Code presenta sólo unas pocas líneas del
    contenido del archivo a la vez que cambian dinámicamente, lo que
    interfiere a veces en el algoritmo de WordNav.

Console Toolkit es un complemento de NVDA que proporciona mejoras de
accesibilidad en la consola de Windows, también conocida como Símbolo del
sistema. También funciona bien en Windows PowerShell. Algunas de sus
características pueden funcionar en terminales alternativas, como Cygwin,
PuTTY y Windows Terminal. Sin embargo, el complemento sólo se ha probado
cuidadosamente en la consola predeterminada de Windows. Los usuarios de SSH
podrían encontrar especialmente útil este complemento.

Algunas de las características antes formaban parte del complemento Mejoras
de Tony
.

Descargas

Console
toolkit

Verbalización de la consola en tiempo real

Esta opción hace que NVDA verbalice las nuevas líneas inmediatamente en
cuanto aparecen en la salida de la consola, en vez de poner en cola los
mensajes de voz. Por ejemplo, si NVDA está ocupado verbalizando una línea
que apareció en pantalla hace un minuto y aparece una nueva línea, esta
opción cancelará la verbalización de la línea anterior y comenzará a
verbalizar la nueva, proporcionando más retroalimentación en tiempo real de
lo que está sucediendo en la ventana de la consola.

Pitar cuando la consola se actualice

Emite un pitido grave cada vez que se actualiza el texto de la consola.

Reforzar control+v en las consolas

Esta opción permite que el atajo control+v funcione en sesiones SSH.

Experimental: edición del símbolo del sistema

Nota: esta función es experimental. Por favor, lee atentamente esta sección
y asegúrate de entender cómo funciona antes de informar de problemas.

Pulsa NVDA+e para identificar la orden actual de la ventana de la consola
y editarla en una ventana «Editar orden» accesible. Después de editar puedes
pulsar escape para actualizar la línea de órdenes actual, o intro para
actualizarla y ejecutarla de inmediato. Alternativamente, puedes pulsar
alt+f4 para cerrar la ventana de editar orden sin actualizar la línea de
órdenes.

Esta función se ha probado en el símbolo del sistema de Windows, cmd.exe,
así como en la shell Bash sobre conexiones SSH, WSL y Cygwin. También podría
funcionar en shells de Unix alternativas, aunque no se ha probado.

A continuación se explica cómo extrae el complemento la orden actual.

  1. Pulsa la tecla Fin y envía un carácter de control, un extraño carácter
    Unicode que probablemente no se use en ningún sitio.
  2. Después pulsa la tecla Inicio y envía otro carácter de control.
  3. Después espera a que los caracteres de control aparezcan en pantalla,
    algo que puede tardar un poco en conexiones SSH lentas.
  4. La orden es lo que se encuentra entre los dos caracteres.
  5. Cuando se habilita la opción «Utilizar UI Automation para acceder a la
    Consola de Windows cuando esté disponible» en las preferencias de NVDA,
    se envía un carácter de control adicional al principio de la cadena. Esto
    es necesario para interpretar correctamente órdenes de varias líneas: la
    implementación de UIA suprime los espacios en blanco al final de cada
    línea, por lo que para deducir si hay un espacio entre dos líneas, hay
    que rotarlas un carácter. Ten en cuenta, sin embargo, que puede que no se
    preserven todos los espacios entre palabras, este mecanismo sólo preserva
    la presencia de espacios.
  6. Antes de editar, el complemento se asegura de eliminar los caracteres de
    control situando el cursor al principio y al final y simulando
    pulsaciones de las teclas suprimir y retroceso.
  7. Presenta la orden en la ventana «Editar orden» para que el usuario la
    visualice o la edite.
  8. Después de que el usuario pulse intro, se borra la línea actual de la
    consola. Esto se logra mediante uno de estos cuatro métodos, la elección
    del método es configurable. Los métodos soportados son:

    • Control+c: funciona en cmd.exe y Bash, pero deja la orden
      anterior visible; no funciona en Emacs y a veces es poco fiable en
      conexiones SSH lentas
    • Escape: sólo funciona en cmd.exe«),
    • Control+a y control+k: funciona en Bash y Emacs, pero no
      funciona en cmd.exe
    • Retroceso (recomendado): funciona en todos los entornos, pero es
      lento y puede causar corrupción si la longitud de la línea ha cambiado
  9. Finalmente, el complemento simula pulsaciones de teclas para teclear la
    orden actualizada y, opcionalmente, simula una pulsación de la tecla
    intro.

Resolución de problemas:

  • Comprueba que las teclas ‘Inicio’, ‘Fin’, ‘Retroceso’ y ‘Suprimir’
    funcionan como se espera en tu consola.
  • Comprueba que tu consola soporta caracteres Unicode. Algunas conexiones
    SSH no soportan Unicode.
  • Comprueba que el método de eliminación seleccionado funciona en tu
    consola.

Experimental: captura de la salida de la orden

Nota: esta función es experimental. Por favor, lee atentamente esta sección
y asegúrate de entender cómo funciona antes de informar de problemas.

Mientras estés en la línea de órdenes o en la ventana «Editar orden», pulsa
control+intro para capturar la salida de la orden. Este complemento es
capaz de capturar una enorme salida que ocupe varias pantallas, aunque si
dicha salida se extiende a lo largo de más de 10 pantallas, el proceso de
captura durará un tiempo considerable. El complemento reproducirá un sonido
de campanada, que durará mientras se capture la salida de la orden en
ejecución o hasta que el tiempo de espera se agote. Alternativamente, pulsa
NVDA+e para interrumpir la captura.

Si la función «Utilizar UI Automation para acceder a la Consola de Windows
cuando esté disponible» está habilitada en las opciones de NVDA, puedes
cambiar a otras ventanas mientras la captura está en curso. Sin embargo, si
esta opción está desactivada, significa que NVDA está usando un código de
consola anticuado que sólo funciona cuando la consola tiene el foco, por lo
que cambiar a otra ventana hará que se pause la captura.

La captura de órdenes funciona redirigiendo la salida de la orden al
programa less. El sufijo por defecto que se anexa a las órdenes es:

|less -c 2>&1

Cámbialo sólo si sabes lo que estás haciendo. Este complemento sabe cómo
interactuar con la salida de la orden less para recuperar el resultado
página a página.

En Windows, es necesario instalar la herramienta less.exe por
separado. Puedes instalarla mediante Cygwin, o descargar un binario para
Windows en cualquier otro sitio.

Si usas tmux o screen en Linux, asegúrate de que no se muestra la línea
de estado en la parte inferior. En tmux, ejecuta

tmux set status off

para deshacerte de la línea de estado, o modifica tu archivo tmux.conf.

Resolución de problemas:

  • Después de un intento de captura fallido, pulsa flecha arriba en la
    consola para comprobar qué orden se ha ejecutado en realidad.
  • Vuelve a usar el sufijo de captura predeterminado, mencionado
    anteriormente.
  • Prueba los pasos de resolución de problemas de la sección «Edición del
    símbolo del sistema».

Este complemento comprueba el estado del sonido en Windows cuando NVDA se
inicia y, si determina que el sonido está silenciado, el complemento fuerza
su activación.

Al mismo tiempo, se comprueba por separado el volumen del proceso de NVDA.

El complemento también comprueba el estado del sintetizador de voz. Si hay
problemas durante su inicialización, se hacen intentos para iniciarlo, tal y
como se especifica en las opciones de NVDA.

Hay una posibilidad adicional que comprueba el dispositivo de sonido por el
que sale NVDA. Si este dispositivo es distinto del predeterminado, se
alterna automáticamente la salida al dispositivo predeterminado instalado en
el sistema.

Nota: siempre se reproduce el sonido de inicio del complemento, incluso si
el volumen está activado. Esto es porque el complemento conmuta la salida al
dispositivo de sonido principal cada vez que NVDA se inicia.

Esto sucede cuando el dispositivo de sonido de salida configurado en las
opciones de NVDA difiere del dispositivo de salida predeterminado o del
«Asignador de sonido Microsoft».

Esto se puede resolver de una de las siguientes formas:

  1. Después de reiniciar NVDA, guarda la configuración actual pulsando
    NVDA+ctrl+c. Se guardará el dispositivo de sonido predeterminado en los
    ajustes de NVDA y la conmutación no se producirá cada vez que NVDA se
    inicie.
  2. Si no quieres cambiar la configuración de NVDA, simplemente desactiva la
    función de alternar dispositivos de sonido en el panel de opciones de
    Unmute.

Diálogo de opciones del complemento

Para abrir el panel de opciones del complemento, sigue estos pasos:

  • Pulsa NVDA+n para abrir el menú NVDA.
  • Después ve a «Preferencias» -> «Opciones…» y busca en la lista de
    categorías «Unmute Windows Audio».

Eso es todo, ahora puedes usar el tabulador para desplazarte por las
opciones del complemento.

Las siguientes opciones están disponibles en el diálogo de opciones del
complemento:

  1. El primer deslizador del diálogo de opciones del complemento te permite
    especificar el nivel de volumen de Windows que se configurará cuando
    inicies NVDA si el sonido estaba silenciado o el volumen estaba muy bajo.

  2. El nivel de volumen mínimo de Windows para que se aplique el
    procedimiento de incremento de volumen. Este deslizador te permite
    ajustar el nivel de sensibilidad del complemento.

    Si el volumen cae por debajo del valor indicado aquí, este aumentará la próxima vez que inicies NVDA.

    De lo contrario, si el volumen es mayor que el valor que se indique aquí, el nivel no cambiará al reiniciar NVDA.

    Y, por supuesto, si el sonido estaba apagado, se encenderá al reiniciar el complemento.

  3. La siguiente casilla de verificación permite habilitar la
    reinicialización del controlador de sintetizador de voz.

    Este procedimiento sólo se iniciará si se detecta que el controlador del sintetizador de voz no se ha iniciado tras arrancar NVDA.

  4. En el siguiente campo puedes indicar el número de intentos de
    reinicialización del sintetizador. Los intentos se realizan cíclicamente
    en intervalos de un segundo. Un valor de 0 significa que se realizarán
    intentos indefinidamente hasta que el procedimiento se complete con
    éxito.

  5. La opción «Switch to the default output audio device» permite comprobar
    al iniciar el dispositivo de salida de sonido de NVDA. Si este
    dispositivo difiere del predeterminado, se alterna automáticamente la
    salida al dispositivo de sonido instalado en el sistema como principal.

  6. La siguiente casilla de verificación activa o desactiva la reproducción
    de un sonido de inicio cuando la operación tiene éxito.

Componentes de terceros

El complemento utiliza los siguientes componentes de terceros:

  • Para interactuar con la API Windows Audio Coremódulo
    PyCaw
    , distribuido bajo la licencia
    MIT.
  • Para obtener información sobre procesos en ejecución y usar en componente
    PyCaw – módulo psutil, distribuido
    bajo la licencia BSD-3.

Registro de cambios

Versión 1.5.5

  • se ha probado la compatibilidad del complemento con NVDA 2021.1;
  • se ha actualizado el módulo de terceros psutil;
  • se ha adaptado el complemento para soportar las versiones de Python 3.7 y
    3.8;
  • Añadidas anotaciones de MyPy al código fuente;
  • añadida función «Cambiar al dispositivo de salida predeterminado»;
  • los parámetros del complemento siempre se alojan en el perfil de
    configuración base.

Versión 1.4

  • añadido un método para aumentar el volumen del proceso NVDA por separado
    al iniciar;
  • cambiado el sonido de operación exitosa (gracias a Manolo);
  • todas las funciones manuales para controlar el volumen se han transferido
    al complemento de ajuste de volumen para NVDA.

Versión 1.3

  • añadida la capacidad de controlar de forma separada el volumen principal y
    de cada programa;
  • actualizada traducción al vietnamita (gracias a Dang Manh Cuong);
  • añadida la traducción al turco (gracias a Cagri Dogan);
  • Añadida la traducción al italiano (gracias a Christianlm);
  • añadida la traducción al chino simplificado (gracias a Cary Rowen);
  • Añadida traducción al polaco (gracias a Stefan Banita);
  • actualizada traducción al ucraniano;
  • actualizada la documentación.

Versión 1.2

  • ahora se usa la API Windows Audio Core en vez del administrador de
    sonido de Windows
    ;
  • se añade la reproducción de un sonido de inicio cuando el complemento
    activa con éxito el audio.

Versión 1.1

  • añadido diálogo de opciones del complemento;
  • actualizada traducción al ucraniano.

VERSIÓN 1.0.1

  • Realiza intentos repetidos para activar el controlador del sintetizador en
    caso de inicialización fallida;
  • Añadida traducción al vietnamita por Dang Manh Cuong;
  • Añadida traducción al ucraniano.

VERSIÓN 1.0. CARACTERÍSTICAS DE LA IMPLEMENTACIÓN

El complemento usa un módulo de terceros, Windows Sound Manager.

Alteración del código fuente del complemento

Puedes clonar este repositorio para alterar NVDA Unmute.

Dependencias de terceros

Se pueden instalar con Pip:

  • markdown
  • scons
  • python-gettext

Para empaquetar el complemento para su distribución

  1. Abre una línea de órdenes, navega a la raíz de este repositorio
  2. Ejecuta la orden scons. El complemento creado, si no hay errores, se
    sitúa en el directorio actual.

Bienvenido al complemento de diccionario rápido de NVDA, que te permitirá
obtener rápidamente el artículo de un diccionario con la traducción de una
palabra o frase en el idioma de tu elección pulsando una combinación de
teclas. Hay unos pocos atajos de teclado, pero son intuitivos y se han
elegido convenientemente para que los recuerdes rápidamente.

Los artículos del diccionario contienen información detallada de la palabra,
tal como voz, género, singular o plural, opciones de traducción, lista de
significados, sinónimos y ejemplos detallados. Dicha información será muy
útil para la gente que aprende idiomas extranjeros, o busca comunicarse
aprovechando toda la riqueza y diversidad de su propio idioma.

El complemento soporta diversos servicios de diccionarios en línea. Puedes
seleccionar el diccionario remoto deseado en el cuadro de diálogo
correspondiente o utilizando atajos de teclado. Cada servicio disponible
dispone de su propio panel de opciones.

También hay oportunidades avanzadas para trabajar con perfiles de los
sintetizadores de voz. Puedes asociar un perfil de síntesis de voz con un
idioma específico, tras lo cuál las traducciones a dicho idioma serán
pronunciadas por el sintetizador seleccionado.

A continuación se encuentran todas las funciones del complemento, así como los atajos de teclado para controlarlas. Por defecto, todas las funciones se activan con órdenes de doble capa. Sin embargo, se pueden asignar atajos más convenientes para todos los métodos. Se puede hacer desde el diálogo Gestos de entrada, en las preferencias de NVDA.

Recibir el artículo de un diccionario

Para obtener un artículo del diccionario, primero debes seleccionar la
palabra en la que estás interesado o bien copiarla al portapapeles. A
continuación, pulsa NVDA+y dos veces. Existe otra forma de obtener una
entrada del diccionario: al pulsar NVDA+y una vez se activa el modo de
control del complemento, después basta con pulsar la letra d.

Modo de control del complemento

Para acceder a todas las funciones del complemento, es necesario activar su
modo de control. Esto se puede hacer pulsando NVDA+y una vez. Se escuchará
un pitido corto y grave, y podrás utilizar las órdenes descritas más
abajo. Si pulsas una tecla que no pertenezca al complemento, escucharás una
señal auditiva que indicará una pulsación errónea y el modo de control del
complemento se desactivará automáticamente.

Lista de órdenes del complemento

Órdenes básicas del diccionario:

  • D – Anuncia una entrada de diccionario para la palabra o frase
    seleccionada (igual que NVDA+Y);
  • W – Muestra la entrada del diccionario en una ventana explorable
    independiente;
  • S – Intercambia los idiomas y obtiene la traducción del Diccionario
    Rápido;
  • A – Anuncia los idiomas actuales de origen y destino;
  • C – Copia la última entrada del diccionario al portapapeles;
  • E – Edita el texto antes de enviarlo;
  • U – Descarga y almacena la lista de idiomas disponibles del diccionario en
    línea;
  • teclas de función – Seleccionar servicio de diccionario en línea;
  • Q – Estadísticas de uso del servicio en línea;
  • F – Elegir servicio en línea.

Gestión de perfiles de síntesis de voz:

  • del 1 al 9 – Selección del perfil de síntesis de voz;
  • G – Anuncia el perfil seleccionado de síntesis de voz;
  • B – Vuelve al sintetizador de voz anterior;
  • R – Restaurar sintetizador de voz predeterminado;
  • Suprimir – Elimina el perfil de síntesis de voz seleccionado;
  • V – Guarda el perfil de síntesis de voz configurado;
  • P – Muestra una lista con todos los perfiles de síntesis de voz
    personalizados.

Pulsa O para abrir el diálogo de opciones del complemento.

Ayuda de órdenes del complemento

Puedes ver una lista con todas las órdenes utilizadas en el complemento de
la siguiente manera:

  • Mediante el menú NVDA – Pulsando NVDA+n, yendo al menú «Herramientas»,
    luego a «Quick Dictionary» y activando el elemento de menú «Help on add-on
    commands».
  • Pulsa la tecla H en el modo de control del complemento (NVDA+Y).

Ayuda del complemento

Para abrir la ayuda del complemento, pulsa NVDA+N, ve al submenú
«Herramientas», luego a «Quick Dictionary» y activa el elemento de menú
«Help».

Colaboraciones

Estamos muy agradecidos a todos los que han hecho el esfuerzo de
desarrollar, traducir y mantener este complemento:

  • Cagri Dogan – Traducción al turco;
  • Wafiqtaher – Traducción al árabe.

Se han usado varias buenas soluciones de otros desarrolladores en el
complemento Diccionario Rápido. Gracias a los autores de los siguientes
complementos:

  • Instant Translate – Alexy Sadovoy, Beqa Gozalishvili, Mesar Hameed,
    Alberto Buffolino y otros colaboradores de NVDA.
  • Para trabajar con los perfiles de sintetizadores de voz se usaron ideas
    del complemento SwitchSynth (gracias a Tyler Spivey).

Registro de cambios

Versión 2.1

  • añadido un diálogo para editar el texto antes de enviarlo al servicio
    remoto;
  • se ha separado la página de ayuda del complemento del archivo léame;
  • Añadida traducción al turco (gracias a Cagri Dogan).

Versión 2.0

  • añadida la posibilidad de conectar otros servicios en línea;
  • añadido el servicio Lexicala junto con su panel de opciones;
  • añadido un diálogo para elegir un servicio remoto de la lista de los que
    hay disponibles;
  • añadida una orden para obtener información sobre el servicio seleccionado;
  • añadido un diálogo para trabajar con perfiles de síntesis de voz;
  • implementado el procedimiento para pasar al sintetizador de voz anterior;
  • implementado un hilo paralelo para vigilar el estado del sintetizador;
  • a causa del incremento de funciones en el complemento, la ayuda de órdenes
    ahora se muestra en una ventana independiente;
  • actualizado el procedimiento para almacenar en caché las solicitudes a
    servicios en línea;
  • se ha añadido un submenú del complemento al menú NVDA;
  • actualizado léeme.

Versión 1.2

  • añadida la capacidad de alternar automáticamente entre sintetizadores de
    voz en los idiomas seleccionados;
  • añadida la capacidad de descargar la lista más reciente de idiomas
    disponibles del diccionario en línea;
  • Añadida la traducción al turco gracias a Cagri Dogan.

Versión 1.1

  • cambiados algunos atajos de teclado que hacían conflicto con otros
    complementos;
  • cambiada la descripción de las funciones principales del complemento;
  • actualizada la ayuda y las traducciones del complemento;
  • eliminados algunos atajos de teclado, dando al usuario la oportunidad de
    que los configure por sí mismo;
  • corregido un error en la traducción al ucraniano (gracias a Volodymyr
    Perig);
  • añadida traducción al ruso.

Versión 1.0: características de la implementación

  • las solicitudes al servidor remoto se ejecutan en un hilo separado para
    evitar que NVDA se bloquee;
  • señales mientras se espera una respuesta del servidor;
  • se guardan en caché las 100 últimas solicitudes para reducir la carga del
    servicio de diccionario remoto;
  • se pasa al modo de control del complemento;
  • posibilidad de usar un servidor alternativo;
  • diálogo de opciones del complemento.