Console Toolkit

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

Install from add-on store.

Jump to the first visible line

Console toolkit overrides `shift+numpad7 command in UIA consoles: instead of reading the first line in the entire buffer it now reads the first visible line at the top of the window. Press shift+numpad7 twice to revert to the old behavior and read the first line of the buffer.

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.

Here is how add-on extracts current command. 1. It presses End key and then sends a control character, that is a rare Unicodecharacter not likely to be used anywhere. 2. Then it presses home key and sends another control character. 3. Then it waits for control characters to appear on the screen, which might take some time on slow SSH connections. 4. Command is what appears between two control characters. 5. When "Use UI Automation to access the Windows Console when available" option is enabled in NVDA settings, it sends one more control character in the beginning of the string. This is needed to parse multiline commands correctly: UIA implementation trims whitespaces in the end of each line, so in order to deduce whether there is a space between two lines, we need to shift them by one character. Please note, however, that this way we don't preserve the number of spaces between words, we only guarantee to preserve the presence of spaces. 6. Before editing add-on makes sure to remove control characters by placing cursor in the beginning and end and simulating Delete and Backspace key presses. 7. It presents command in "Edit prompt" window for user to view or edit. 8. After user presses Enter or Escape,it first erases current line in the console. This is achieved via one of four methods, the choice of the method is configurable. Currently four methods are supported: - Control+C: works in both cmd.exe and bash, but leaves previous prompt visible on the screen; doesn't work in emacs; sometimes unreliable on slow SSH connections - Escape: works only in cmd.exe"), - Control+A Control+K: works in bash and emacs; doesn't work in cmd.exe - Backspace (recommended): works in all environments; however slower and may cause corruption if the length of the line has changed 9. Then add-on simulates keystrokes to type the updated command and optionally simulates Enter key press.

Troubleshooting: - Verify that 'Home', 'End', 'Delete' and 'Backspace' keys work as expected in your console. - Verify that your console supports Unicode characters. Some ssh connections don't support Unicode. - Verify that selected deleting method works in your console.

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.

Troubleshooting: - After a failed output capturing attempt, press UpArrow in the console to check what command has actually been executed. - Revert back to default capturing suffix, mentioned above. - Try troubleshooting steps from "command prompt editing" section.