Console Toolkit

Console Toolkit to dodatek NVDA, który zapewnia ulepszenia ułatwień dostępu dla konsoli systemu Windows, znany również jako wiersz polecenia. Działa również dobrze w programie Windows PowerShell. Niektóre funkcje mogą działać w alternatywnych terminalach, takich jak Cygwin, PuTTY i Windows Terminal, jednak dodatek został dokładnie przetestowany tylko z domyślną konsolą Windows. Użytkownicy SSH mogą uznać ten dodatek za szczególnie przydatny.

Niektóre funkcje były wcześniej częścią dodatku do ulepszeń Tony'ego.

Pliki

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.

Mowa konsoli w czasie rzeczywistym

Ta opcja sprawia, że NVDA wymawia nowe linie natychmiast, gdy pojawiają się na wyjściu konsoli, zamiast kolejkować nowe wypowiedzi mowy. Na przykład, jeśli NVDA jest zajęta wypowiadaniem linii, która pojawiła się na ekranie 1 minutę temu, a teraz pojawia się nowa linia, ta opcja anuluje wypowiadanie starej linii i od razu zacznie mówić nową linię, zapewniając w ten sposób bardziej w czasie rzeczywistym informację zwrotną na temat tego, co dzieje się w oknie konsoli.

Sygnał dźwiękowy w aktualizacjach konsoli

Emituj sygnał dźwiękowy impulsu niskiego tonu za każdym razem, gdy aktualizowany jest tekst konsoli.

Wymuszanie kombinacji Control+V w konsolach

Ta opcja sprawia, że skrót Control+V działa wewnątrz sesji "ssh".

Eksperymentalne: edycja wiersza polecenia

Uwaga: ta funkcja jest eksperymentalna. Przeczytaj uważnie tę sekcję i upewnij się, że rozumiesz, jak to działa, zanim zgłosisz problemy.

Naciśnij "NVDA + E", aby zidentyfikować bieżący monit w oknie konsoli i edytować go w dostępnym oknie "Edytuj monit". Po edycji możesz nacisnąć "Escape", aby zaktualizować bieżący wiersz poleceń, lub "Enter", aby zaktualizować i natychmiast wykonać polecenie. Alternatywnie możesz nacisnąć "Alt + F4", aby zamknąć okno wiersza polecenia edycji bez aktualizowania wiersza poleceń.

Ta funkcja została przetestowana w wierszu polecenia systemu Windows "cmd.exe", a także w powłoce bash przez połączenia ssh, a także w WSL i cygwin. Może również działać w alternatywnych powłokach Uniksa, jednak nie został przetestowany.

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.

Eksperymentalne: przechwytywanie danych wyjściowych poleceń

Uwaga: ta funkcja jest eksperymentalna. Przeczytaj uważnie tę sekcję i upewnij się, że rozumiesz, jak to działa, zanim zgłosisz problemy.

W wierszu poleceń lub w oknie "Edytuj monit" naciśnij "Control + Enter", aby przechwycić dane wyjściowe polecenia. Ten dodatek jest w stanie przechwytywać duże dane wyjściowe, które obejmują wiele ekranów, chociaż gdy wyjście jest większe niż 10 ekranów, proces przechwytywania zajmuje dużo czasu. Dodatek będzie odtwarzał długi dźwięk dzwonka i będzie trwał tak długo, jak długo dodatek przechwytuje dane wyjściowe aktualnie uruchomionego polecenia lub do momentu osiągnięcia limitu czasu. Możesz też nacisnąć "NVDA+E", aby przerwać przechwytywanie.

Gdy funkcja "Użyj automatyzacji interfejsu użytkownika, aby uzyskać dostęp do konsoli Systemu Windows, gdy jest dostępna" jest włączona w ustawieniach NVDA, możesz przełączyć się do innych okien podczas przechwytywania. Jeśli jednak ta opcja jest wyłączona, NVDA używa starszego kodu konsoli, który działa tylko wtedy, gdy consoel jest skoncentrowany, a zatem przełączenie do dowolnego innego okna spowoduje wstrzymanie przechwytywania.

Przechwytywanie poleceń działa poprzez przekierowanie danych wyjściowych polecenia do polecenia "mniej". Domyślny sufiks dodawany do poleceń to: |less -c 2>&1 Zmień go tylko wtedy, gdy wiesz, co robisz. Ten dodatek wie, jak wchodzić w interakcje z wyjściem polecenia "less", aby pobrać dane wyjściowe strona po stronie.

W systemie Windows narzędzie "mniej.exe" należy zainstalować osobno. Możesz zainstalować go za pomocą cygwin lub pobrać plik binarny systemu Windows w innym miejscu.

Jeśli używasz "tmux" lub "screen" w linuksie, upewnij się, że na dole nie jest wyświetlana żadna linia stanu. W biegu 'tmux' tmux set status off , aby pozbyć się wiersza stanu lub zmodyfikować plik "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.