Acest supliment adună diverse caracteristici pentru depanarea și testarea NVDA.
Comanda NVDA+shift+Q deschide un dialog pentru a specifica unele opțiuni
suplimentare înainte de a reporni NVDA. Opțiunile care pot fi specificate
corespund opțiunilor liniei de comandă care pot fi utilizate cu
nvda.exe
, de ex. -c
pentru calea de configurare,
--suplimente-dezactivate
pentru a dezactiva suplimentele, etc.
Pressing NVDA+shift+alt+E allows to report the last error logged without needing to open the log. A second press clears the memorized last error.
Setarea "Redați un sunet pentru erorile înregistrate" a fost introdusă în NVDA 2021.3 și permite să specificați dacă NVDA va reda un sunet de eroare în cazul în care este înregistrată una.
Acest supliment oferă o comandă suplimentară (NVDA+control+alt+E) pentru a comuta această setare. Puteţi alege:
Pentru NVDA anterior versiunii 2021.3, acest add-on oferă portarea inversă a acestei funcționalități și posibilitatea de a o controla cu ajutorul comenzilor de la tastatură. Cu toate acestea, caseta de bifare din panoul de setări avansate nu este portată înapoi.
Această caracteristică permite raportarea unor proprietăți ale obiectului de navigare curent fără a deschide vizualizatorul de jurnal.
Pentru a lista proprietățile unui obiect, mutați obiectul navigator la acesta și utilizați următoarele comenzi:
Lista proprietăților acceptate este următoarea: nume, rol, stare, valoare, windowClassName, windowControlID, windowHandle, locație, clasa Python, clasa Python mro.
When using object navigation commands, you can also choose to have the currently selected property reported instead of NVDA usual object reporting. A toggle command allows to switch between this custom reporting of objects and NVDA usual reporting.
For exemple, you may select "windowClassName" property and enable custom object reporting. Then when moving the navigator object to next or previous object, you will hear the object's windowClassName instead of usual reporting.
All the commands of the Object property explorer are unassigned by default; you will have to assign them a shortcut in the Input gesture dialog to use them.
Când modul de descriere extinsă a scriptului este activ, modul de ajutor pentru intrare (NVDA+1) este modificat după cum urmează. Dacă un script nu are descriere, sunt raportate numele și clasa scriptului. Dacă un script are o descriere, descrierea acestuia este raportată ca de obicei. Gestul de activare sau dezactivare a acestei funcții este NVDA+control+alt+D.
Executarea unui gest legat de un script fără descriere în modul de ajutor pentru intrări, creați și o intrare pentru acest script în dialogul de gestionare a gesturilor. Această intrare se află într-o categorie dedicată numită „Scripturi fără descriere (modificați pe propriul risc!)”. Acest lucru permite adăugarea, ștergerea sau modificarea cu ușurință a gesturilor NVDA native pentru aceste scripturi. Rețineți totuși că se intenționează adesea ca un astfel de script să nu aibă nicio descriere pentru a împiedica utilizatorul să modifice gestul asociat. Într-adevăr, gestul poate fi definit pentru a se potrivi cu o tastă de comandă rapidă a aplicației. De exemplu, scriptul script_toggleItalic de pe NVDAObjects.window.winword.WordDocument este obligat să controleze+I și acest lucru nu ar trebui modificat deoarece gestul este transmis aplicației pentru a executa efectiv tasta de comandă rapidă.
Control+shift+I comută și în cursiv în Word, chiar dacă nu este raportat nativ de NVDA. Pentru ca rezultatul control+shift+I să fie raportat de NVDA ca control+I, ar trebui să efectuați următorii pași:
Eroare cunoscută: un script adăugat pentru o anumită clasă este vizibil chiar dacă managerul de gesturi este deschis într-un alt context.
While testing or working, you may want to mark a specific moment in the log, so that you can turn to it easily later when reading the log.
To add a marker message in the log, press NVDA+control+K.
A message as follows will be logged at INFO level:
-- NDTT marker 0 --
You can add as many markers as you want in the log. The marker's number
will be incremented each time you place a marker in the log; it will only be
reset when NVDA is restarted.
Un mod de citire a jurnalelor oferă comenzi pentru a ușura citirea și analiza jurnalelor. În fereastra de vizualizare a jurnalelor, cititorul de jurnal este activat implicit, astfel că comenzile de citire a jurnalelor sunt disponibile imediat. Într-o altă zonă de citire a textului, cum ar fi un editor (de exemplu, Notepad++) sau o pagină web (de exemplu, problema GitHub), trebuie să apăsați pe NVDA+control+alt+L pentru a activa modul cititor de jurnal și a utiliza comenzile acestuia. Când ați terminat cu sarcinile de citire și analiză a jurnalelor, puteți dezactiva din nou NVDA+control+alt+L pentru a dezactiva modul de citire a jurnalelor.
Comenzile disponibile în modul cititor de jurnal sunt descrise mai jos.
Comandă cu o singură literă similară cu tastele de navigare rapidă a modului de navigare permit trecerea la diferite tipuri de mesaje de jurnal:
ERROR
and CRITICAL
)WARNING
)INFO
)DEBUGWARNING
)IO
)DEBUG
)Apăsarea unei singure litere trece la următoarea apariție a acestui mesaj. Combinarea literei cu tasta Shift trece la apariția anterioară a acestui mesaj.
Sometimes, you may have to look at a log taken on a system in a foreignh language that you do not understand. E.g. the log was taken on a Chinese system / NVDA, whereas you only understand French. If you have Instant Translate add-on installed, you may use it in conjonction with quick log navigation commands to have speech messages translated.
If you want to disable speech translation, press T again.
În jurnal, unele linii se pot referi la codul sursă:
File "virtualBuffers\__init__.pyc", line 226, in _getStoryLength
INFO - config.ConfigManager._loadConfig (22:45:26.145) - MainThread (16580):
Poate doriți să deschideți fișierul care conține acest cod pentru a înțelege contextul urmăririi sau al mesajului înregistrat. Apăsați tasta C pentru a deschide acest fișier.
Pentru ca această caracteristică să funcționeze, trebuie să fi configurat comanda editorului preferat în setările suplimentului. Dacă nu rulați NVDA din sursă, ar trebui configurat și locația codului sursă NVDA.
NVDA oferă deja un backup a jurnalului sesiunii anterioare a NVDA; fișierul
se numește nvda-old.log
. Uneori, totuși, poate doriți să accesați
jurnalele mai vechi, de ex. pentru că a trebuit să reporniți NVDA din nou
înainte să vă uitați la nvda-old.log
. Acest program de completare vă
permite să configurați dacă doriți să faceți backup pentru jurnalele vechi
și câte dintre ele; acest lucru se face în setările
suplimentului.
Un dialog de gestionare a jurnalelor permite vizualizarea jurnalelor de rezervă. Poate fi deschis accesând meniul NVDA -> Instrumente -> Manager jurnal În acest dialog, puteți vedea lista tuturor jurnalelor de rezervă, le puteți deschide sau șterge. Pentru a putea deschide un jurnal, ar trebui mai întâi să fi configurat Comandă pentru a deschide un fișier în editorul tău preferat.
openCodeFile
În consolă, puteți apela următoarea funcție pentru a vizualiza codul sursă care definește variabila myVar
:
openCodeFile(myVar)
Pentru ca această caracteristică să funcționeze, trebuie să fi configurat comanda editorului preferat în setările suplimentului. Dacă nu rulați NVDA din sursă, ar trebui configurat și locația codului sursă NVDA.
Funcțiile openCodeFile
pot fi apelate pe obiecte definite în codul NVDA
sau pe obiecte definite de suplimente. Nu poate fi apelat pe obiecte al
căror cod sursă nu este disponibil, cum ar fi modulele integrate Python.
Dacă nu ați importat încă obiectul în consolă, puteți, de asemenea, să
transmiteți numele acestuia ca parametru funcției openCodeFile
.
Mai jos sunt exemple de apel în codul NVDA:
speech.speech.speak
:
openCodeFile(speech.speech.speak)
openCodeFile("speech.speech.speak")
TextInfo
:
openCodeFile(textInfos.TextInfo)
copyToClipboard
of the class
TextInfo
:
openCodeFile(textInfos.TextInfo.copyToClipboard)
openCodeFile(focus)
api.py
defining the module api
:
openCodeFile(api)
Puteți defini un script personalizat care va fi executat în spațiul de nume al consolei Python atunci când este deschis pentru prima dată sau dacă suplimentul este reîncărcat (NVDA+F3) după ce consola a fost deja deschisă.
De exemplu, scriptul vă permite să executați noi importuri și să definiți aliasuri pe care le veți putea folosi direct în consolă, după cum se arată mai jos:
# Various import that I want in the console.
import globalVars as gv
import core
import ui
# Aliases
ocf = openCodeFile
Scriptul consolei Python ar trebui să fie plasat în următoarea locație: pathToNVDAConfig\ndtt\consoleStartup.py
De exemplu:
C:\Users\myUserName\AppData\Roaming\nvda\ndtt\consoleStartup.py
Uneori, este posibil să doriți să vedeți care parte a codului este responsabilă pentru vorbire. Pentru aceasta, puteţi activa înregistrarea urmăririi seriei ordonate a funcţiei de vorbire apăsând NVDA+control+alt+S. De fiecare dată când NVDA vorbește, o urmărire a seriei ordonate corespunzătoare va fi înregistrată în jurnal.
Notă: Puteți modifica fișierul scriptului direct pentru a corecta o altă funcție. Consultați toate instrucțiunile din fișier pentru detalii despre utilizare.
<a id="setări
Unele caracteristici ale suplimentului pot necesita o configurație specifică. Un panou de setări vă permite să le activați sau să controlați modul în care funcționează. Pentru a vizualiza și modifica aceste setări, accesați meniul NVDA -> Preferințe și selectați categoria NVDA Dev & Test Toolbox. Acest dialog de setări poate fi accesat și direct din dialogul Manager jurnal.
These settings are global and can only be configured when the default profile is active.
<a id="comandăDeschidereSetări
Unele funcții vă permit să vedeți conținutul în editorul dvs. preferat. Aceasta include comenzile pentru vizualizarea fișierului sursă din jurnal sau dintr-un obiect din consolă, precum și butonul Deschidere al log manager.
Pentru a le folosi, mai întâi trebuie să configurați comanda care va fi apelată pentru a deschide fișierul în editorul dvs. preferat.
Comanda ar trebui să fie de forma:
"C:\path\to\my\editor\editor.exe" "{path}":{line}
Desigur, ar trebui să modificați această linie în funcție de numele real și locația editorului dvs. și de sintaxa folosită de acesta pentru a deschide fișierele.
{path}
va fi înlocuit cu calea completă a fișierului de deschis și {line}
cu numărul liniei în care doriți să fie setat cursorul.
Pentru Notepad++, de exemplu, comanda de tastat în consolă ar fi:
"C:\Program Files\Notepad++\notepad++.exe" "{path}" -n{line}
Când utilizați o comandă pentru a vizualiza fișierul sursă dintr-un jurnal sau dintr-un obiect din consolă, fișierul poate aparține NVDA însuși.
Dacă nu rulați NVDA din sursă, NVDA conține doar fișiere compilate.
Astfel, puteți specifica aici o locație alternativă în care va fi găsit fișierul sursă corespunzător, de ex. locul în care ați clonat fișierele sursă NVDA, astfel încât un fișier sursă poate fi oricum deschis.
Locaţia ar trebui să fie astfel:
C:\pathExample\GIT\nvda\source
Desigur, înlocuiți locaţia sursei NVDA cu cea corectă.
Asigurați-vă totuși că versiunea fișierului sursă (de exemplu, GIT commit) este aceeași cu cea a instanței care rulează NVDA.
Caseta combinată Backup jurnale vechi permite activarea sau dezactivarea funcției. Dacă este activat, puteți specifica mai jos în "imitați numărul de back-up-uri numărul maxim de backup-uri de siguranţă pe care doriți să le păstrați. Aceste setări au efect numai la următoarea pornire a NVDA, când are loc backup-ul.
openCodeFile
poate primi acum ca parametru obiectul
sau un șir care conține numele acestuia.openCodeFile
și
comanda de deschidere a fișierului sursă corespunzător unei linii din
jurnal.[[!tag dev stable]]