Este complemento reúne diversas funciones para depuración y pruebas en NVDA.
Este complemento usa órdenes de capa para las nuevas órdenes que añada. El
punto de entrada de estas órdenes es NVDA+x; por lo que todas las órdenes
deberían ejecutarse con NVDA+x seguido de otra letra sola o un gesto. Se
pueden listar todas las órdenes de capa disponibles pulsando NVDA+x, h.
Se pueden definir gestos directos con las órdenes que más uses en el diálogo Gestos de entrada.
La orden NVDA+X, Q abre un diálogo para indicar algunas opciones extra
antes de reiniciar NVDA. Las opciones que pueden especificarse corresponden
a las opciones de línea de órdenes que se pueden usar con nvda.exe,
como -c para la ruta de configuración, --disable-addons para
deshabilitar los complementos, etc.
Pulsar NVDA+X, Epermite anunciar el último error registrado sin necesidad
de abrir el registro. Una segunda pulsación elimina el último error
memorizado.
La opción "Reproducir un sonido para los errores registrados" se introdujo en NVDA 2021.3 y permite especificar si NVDA reproducirá un sonido de error en caso de que se registre un error.
Este complemento proporciona una orden adicional (NVDA+x, shift+e) para
conmutar este ajuste. Puedes elegir:
En versiones de NVDA anteriores a la 2021.3, este complemento proporciona el backport de esta característica y la posibilidad de controlarla con la orden de teclado. La casilla de verificación del panel de opciones avanzadas, sin embargo, no se incluye.
Esta función permite anunciar algunas propiedades del objeto actual en el navegador de objetos sin abrir el visualizador del registro.
Para enumerar las propiedades de un objeto, mueve el navegador de objetos hacia él y usa las siguientes órdenes:
NVDA+X, flecha arriba: Selecciona la propiedad anterior y la anuncia
para el navegador de objetos.NVDA+X, flecha abajo: Selecciona la siguiente propiedad y la anuncia
para el navegador de objetos.NVDA+X, N: Indica la propiedad seleccionada actualmente para el
navegador de objetosNVDA+X, shift+N: Muestra la propiedad seleccionada actualmente para el
navegador de objetos en un mensaje explorableLa lista de propiedades soportadas es la siguiente: nombre, rol, estado, valor, nombre de clase de la ventana, id de control de la ventana, manejador de la ventana, ubicación, clase Python, orden de resolución de métodos de la clase Python.
Al usar órdenes de navegación por objetos, también puedes elegir que se
anuncie la propiedad seleccionada actualmente en lugar del anuncio habitual
de objetos de NVDA. Una orden de conmutación, NVDA+X, Control+N, permite
alternar entre esta forma personalizada de anunciar los objetos y el anuncio
habitual de NVDA.
Por ejemplo, puedes seleccionar la propiedad "Nombre de clase de la ventana" y habilitar el anuncio de objetos personalizado. Al moverte al siguiente objeto o al anterior con el navegador de objetos, escucharás el nombre de clase de ventana del objeto en lugar del anuncio habitual.
La orden de abrir scripts permite abrir el código de un script conociendo su gesto.
Para usarla, pulsa NVDA+x, c y luego el gesto del script cuyo código
quieras ver. Por ejemplo, para ver el código del script que indica el título
de la ventana en primer plano, pulsa NVDA+x, c y luego NVDA+t.
Para que esta característica funcione, necesitas configurar el comando de tu editor favorito en las opciones del complemento. Si no estás ejecutando NVDA desde el código fuente, la ubicación del código fuente de NVDA también debería estar configurada.
El modo de descripción extendida de scripts permite indicar información de scripts sin descripción en el modo ayuda de entrada.
Cuando el modo de descripción extendida de scripts está activado, el modo de
ayuda de entrada (NVDA+1) se modifica de la siguiente manera. Si un script
no tiene descripción, se anuncian su nombre y su clase. Si un script tiene
descripción, esta se anuncia como siempre. El gesto para activar o
desactivar esta función es NVDA+X, D.
Ejecutar un gesto asociado a un script sin descripción en el modo ayuda de entrada también crea una entrada para este script en el diálogo de administración de gestos. Esta entrada se ubica en una categoría dedicada llamada "Scripts sin descripción (¡Modifica bajo tu responsabilidad!)". Esto permite añadir, eliminar o cambiar fácilmente los gestos nativos de NVDA para estos scripts. Ten en cuenta, sin embargo, que el script puede no tener una descripción intencionadamente para que el usuario no pueda modificarlo. El script puede estar pensado para coincidir con un atajo de una aplicación concreta. Por ejemplo, el script script_toggleItalic en NVDAObjects.window.winword.WordDocument está asignado a control+k, y no debería modificarse, ya que el gesto se pasa a la aplicación para ejecutar realmente ese atajo de teclado.
Control+shift+k también conmuta la cursiva en Word, incluso si NVDA no lo anuncia de forma nativa. Para que el resultado de pulsar control+shift+k se anuncie como control+k, deberías seguir los siguientes pasos:
NVDA+X, D.NVDA+X,
D.Fallo conocido: Un script añadido para una clase concreta es visible incluso si el administrador de gestos se abre en otro contexto.
Al trabajar o hacer pruebas, puedes querer marcar un momento concreto en el registro, de tal manera que puedas regresar a él después al leer el registro.
Para añadir un mensaje de marcador al registro, pulsa NVDA+X, K.
Se registrará un mensaje como el siguiente en el nivel info:
-- NDTT marker 0 --
Puedes añadir tantos marcadores como quieras en el registro. El número del
marcador se incrementará cada vez que sitúes un marcador en el registro;
sólo se restablecerá al reiniciar NVDA.
El modo lector del registro proporciona órdenes para facilitar la lectura y
el análisis del registro. En la ventana del visualizador del registro, el
lector del registro está habilitado por defecto, por lo que los comandos de
lectura del registro están disponibles de inmediato. En otras áreas de
lectura de texto, tales como un editor (por ejemplo, Notepad++) o una página
web (por ejemplo, una incidencia de GitHub), es necesario pulsar NVDA+X, L
para activar el modo de lectura del registro y usar sus órdenes. Cuando
acabes con las tareas de análisis y lectura del registro, puedes desactivar
de nuevo el modo lector del registro con NVDA+X, L.
Las órdenes disponibles en el modo de lectura del registro se describen a continuación.
Existen órdenes de navegación de una sola letra, similares a las usadas en modo exploración, que permiten moverse por distintos tipos de mensajes en el registro:
ERROR y CRITICAL)WARNING)INFO)DEBUGWARNING)IO)DEBUG)Pulsando la letra te moverás a la siguiente coincidencia de ese mensaje. Al combinar la letra con la tecla shift, te desplazarás a la coincidencia anterior.
A veces, puedes tener que mirar un registro tomado en un sistema con un idioma extranjero que no entiendes. Por ejemplo, el registro se tomó en un sistema / NVDA en chino, pero sólo entiendes francés. Si tienes instalado el complemento Instant Translate, puedes usarlo junto con las órdenes de navegación rápida por el registro para traducir los mensajes hablados.
Si quieres desactivar la traducción del habla, pulsa la T de nuevo.
En el registro, alguna línea puede hacer referencia al código fuente:
File "virtualBuffers\__init__.pyc", line 226, in _getStoryLengthINFO - config.ConfigManager._loadConfig (22:45:26.145) - MainThread (16580):Input help: gesture kb(desktop):NVDA+t, bound to script title on globalCommands.GlobalCommands Puedes querer que se abra el archivo que contiene el código para comprender el contexto de la traza o el mensaje registrado. Pulsa la C para abrir el archivo.
Para que esta característica funcione, necesitas configurar el comando de tu editor favorito en las opciones del complemento. Si no estás ejecutando NVDA desde el código fuente, la ubicación del código fuente de NVDA también debería estar configurada.
NVDA ya proporciona una copia de seguridad del registro de la sesión
anterior de NVDA; el archivo se llama nvda-old.log. A veces, sin embargo,
puedes querer acceder a registros más antiguos, por ejemplo porque tuviste
que reiniciar NVDA otra vez antes de mirar nvda-old.log. Este complemento
permite configurar si quieres hacer copia de seguridad de los registros
antiguos y cuántos se guardan; esto se hace en las opciones del
complemento.
Un diálogo del gestor de registros permite visualizar los registros respaldados. Se puede abrir yendo al menú NVDA -> Herramientas -> Gestor de registros. En este diálogo, se puede ver la lista con los registros respaldados y realizar diversas acciones en el registro seleccionado:
intro)suprimir)control+c)También puedes seleccionar varios registros para realizar acciones en todos ellos.
Para poder abrir un registro, primero deberías tener configurado el comando para abrir un archivo en tu editor favorito.
openCodeFileEn la consola, puedes llamar a la siguiente función para ver el código fuente que define la variable myVar:
openCodeFile(myVar)
Para que esta característica funcione, necesitas configurar el comando de tu editor favorito en las opciones del complemento. Si no estás ejecutando NVDA desde el código fuente, la ubicación del código fuente de NVDA también debería estar configurada.
Se puede llamar a la función openCodeFile en objetos definidos en el
código de NVDA o en objetos definidos por los complementos. No se puede
llamar en objetos cuyo código fuente no está disponible, tales como los
incorporados en Python.
Si todavía no has importado el objeto en la consola, también puedes pasar su
nombre como parámetro a la función openCodeFile.
A continuación hay ejemplos de llamadas al código de NVDA:
speech.speech.speak:
openCodeFile(speech.speech.speak)openCodeFile("speech.speech.speak") TextInfo:
openCodeFile(textInfos.TextInfo) copyToClipboard de la clase TextInfo:
openCodeFile(textInfos.TextInfo.copyToClipboard) openCodeFile(focus) api.py que define el módulo api:
openCodeFile(api)Puedes definir un script personalizado, que se ejecutará en el espacio de nombres de la consola Python al abrirla por primera vez, o si se recarga el complemento (NVDA+control+f3) después de haber abierto ya la consola.
Por ejemplo, el script te permite ejecutar importaciones y definir alias que podrás usar directamente en la consola, como se muestra a continuación:
# Various import that I want in the console.
import globalVars as gv
import core
import ui
# Aliases
ocf = openCodeFile
El script de la consola Python debería encontrarse en la siguiente ubicación: RutaConfiguraciónNVDA\ndtt\consoleStartup.py
Por ejemplo:
C:\Users\myUserName\AppData\Roaming\nvda\ndtt\consoleStartup.py
A veces, puedes querer saber qué parte del código es responsable de
verbalizar algo. Para ello, puedes habilitar el registro de traza de pila de
la función de voz pulsando NVDA+X, S. Cada vez que NVDA hable, se grabará
una traza de pila en el registro.
Nota: puedes modificar directamente el archivo del script para parchear otra función. Consulta las instrucciones en el propio archivo para más detalles.
Muchos evaluadores usan NVDA en otro idioma distinto al inglés. Pero al indicar resultados de pruebas en GitHub, la descripción de las opciones modificadas o los mensajes anunciados por NVDA deberían estar escritos en inglés. Es bastante frustrante y lleva tiempo hacer que NVDA se reinicie en inglés para comprobar la formulación exacta de las opciones o los mensajes.
Para evitarlo, el complemento proporciona una orden de traducción inversa
(NVDA+X, R) que permite traducir de forma inversa la interfaz de NVDA con
sus mensajes, etiquetas de controles de la interfaz, etc. Esta orden usa la
traducción de Gettext de NVDA para intentar traducir de forma inversa el
último mensaje hablado. Más concretamente, se traduce inversamente la
primera cadena de la última secuencia de voz.
Por ejemplo, en el NVDA francés, si pulsas flecha abajo hasta el menú Herramientas, llamado "Outils", NVDA dirá "Outils sous-Menu o", que significa "Herramientas submenú h". Si pulsas la orden de traducción inversa justo después, NVDA traducirá inversamente "Outils" a "Tools".
Mirando posteriormente en el registro, podemos encontrar las siguientes
líneas:
IO - speech.speech.speak (23:38:24.450) - MainThread (2044):
Speaking ['Outils', 'sous-Menu', CharacterModeCommand(True), 'o', CharacterModeCommand(False), CancellableSpeech (still valid)]
Esto confirma que "Outils" fue la primera cadena en la secuencia de voz.
En caso de que la traducción inversa conduzca a dos o más resultados posibles, se abre un menú de contexto enumerando todas las posibilidades.
El resultado de la traducción inversa también se copia al portapapeles si la opción correspondiente está habilitada, que es el valor predeterminado.
Algunas características de este complemento pueden requerir una configuración concreta. Un panel de opciones permite habilitarlas o controlar cómo funcionan. Para ver y modificar estas opciones, ve al menú NVDA -> Preferencias y selecciona la categoría Caja de herramientas de desarrollo y pruebas de NVDA.
Se puede acceder también a este diálogo de opciones desde el diálogo del gestor de registros.
Estas opciones son globales y sólo se pueden configurar cuando está activado el perfil predeterminado.
Algunas funciones permiten visualizar contenido en tu editor favorito. Esto incluye los comandos para ver el archivo de código fuente desde un registro o desde un objeto en la consola o desde un gesto pulsado, así como el botón abrir del gestor de registros.
Para usarlas, primero debes configurar el comando que se ejecutará para abrir el archivo en tu editor favorito.
Dicho comando debería seguir el formato:
"C:
uta\a\mi\editor\editor.exe" "{path}":{line}
Por supuesto, deberías modificar esta línea en función del nombre real y ubicación del editor, y la sintaxis usada por él para abrir archivos.
{path} se sustituirá por por la ruta completa del archivo a abrir, y {line} por el número de línea donde quieres que se encuentre el cursor.
Por ejemplo, para Notepad++, el comando a escribir en la consola sería:
"C:\Program Files\Notepad++\notepad++.exe" "{path}" -n{line}
Al usar un comando para ver el archivo de código fuente desde un registro o desde un objeto en la consola o desde un gesto pulsado, el archivo debe pertenecer al propio NVDA.
Si no ejecutas NVDA desde el código fuente, tu copia de NVDA sólo contiene archivos compilados.
Por tanto, puedes configurar aquí una ubicación específica donde se encontrará el archivo de código fuente correspondiente, por ejemplo, el lugar donde has clonado los archivos de código fuente de NVDA, de tal forma que se pueda abrir un archivo de código fuente.
La ruta podría ser como:
C:\EjemploRuta\GIT\nvda\source
Por supuesto, reemplaza la ruta del código fuente de NVDA con la correcta.
Asegúrate, no obstante, de que la versión de tu archivo fuente (por ejemplo, commit de Git) es la misma que la de la instancia de NVDA en ejecución.
El cuadro combinado de copia de seguridad de registros antiguos permite activar o desactivar la característica. Si está activada, se puede indicar debajo en "limitar la cantidad de copias de seguridad" la cantidad máxima de copias de seguridad que quieres conservar. Estas opciones sólo tienen efecto la próxima vez que se inicia NVDA al hacer la copia de seguridad.
Esta opción permite elegir si la orden de traducción inversa también copia su resultado al portapapeles.
NVDA+x.
Se han modificado las órdenes actuales en consecuencia. NVDA+x, r) para traducir de forma inversa el último
mensaje hablado.NVDA+x, c) para abrir el código fuente del script
asociado con el siguiente gesto pulsado.intropara abrir el registro, control+c para copiar el archivo de
registro y suprimir para eliminar un archivo de registro.openCodeFile puede recibir como parámetro el
objeto o una cadena que contenga su nombre.openCodeFile y la orden para abrir el archivo de código fuente
correspondiente a una línea del registro.openCodeFile para ver el código fuente de un objeto.[[!tag dev stable]]