Цей додаток включає різні функції для налагодження та тестування NVDA.
Команда NVDA+shift+Q відкриває діалог для встановлення додаткових параметрів
перед перезапуском NVDA. Параметри, які можна вказати, відповідають
параметрам командного рядка, які можна використовувати з nvda.exe
,
напр. -c
для шляху конфігурації, --disable-addons
для вимкнення додатків
тощо.
Натискання NVDA+shift+alt+E дозволяє повідомити про останню зареєстровану помилку без необхідності відкривати журнал. Повторне натискання видаляє останню запам’ятовану помилку.
Налаштування «Відтворення звуку під час журналювання помилок» було представлено в NVDA 2021.3 і дозволяє вказати, чи NVDA відтворюватиме звук помилки, якщо помилка зареєстрована.
Додаток надає ще одну команду (NVDA+control+alt+E) для перемикання цього параметра. Можна вибрати:
Для NVDA до 2021.3 цей додаток забезпечує бекпорт цієї функції та можливість керувати нею за допомогою команд з клавіатури. Однак прапорець на панелі додаткових налаштувань не з'явився.
Ця функція дозволяє повідомляти про деякі властивості поточного об’єкта навігатора, не відкриваючи переглядач журналу.
Щоб отримати список властивостей об’єкта, перемістіть до нього об’єктний навігатор і скористайтеся такими командами:
Список підтримуваних властивостей такий: ім’я, роль, стан, значення, windowClassName, windowControlID, windowHandle, місцезнаходження, клас Python, клас 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.
Коли режим розширеного опису сценарію активний, режим допомоги при введенні (NVDA+1) змінюється наступним чином. Якщо сценарій не має опису, повідомляється ім’я та клас сценарію. Якщо сценарій має опис, його опис повідомляється як зазвичай. Жест для ввімкнення або вимкнення цієї функції: NVDA+control+alt+D.
Виконання жесту, прив’язаного до сценарію без опису в режимі допомоги при введенні також створює запис для цього сценарію в діалозі керування жестами. Цей запис розташовано у спеціальній категорії під назвою «Сценарії без опису (змінюйте на свій страх і ризик!)». Це дозволяє легко додавати, видаляти або змінювати рідні жести NVDA для цих сценаріїв. Однак майте на увазі: часто передбачається, що такий сценарій не має жодного опису, щоб запобігти користувачеві змінити пов’язаний жест. Дійсно, жест можна визначити, щоб він відповідав клавіші швидкого доступу програми. Наприклад, сценарій увімкнення курсиву на NVDAObjects.window.winword.WordDocument прив’язаний до control+I, і це не варто змінювати, оскільки жест передається програмі для фактичного виконання комбінації клавіш.
Control+shift+I також перемикає курсив у Word, навіть якщо про це не повідомляє NVDA. Щоб NVDA повідомила результат control+shift+I як control+I, вам варто виконати такі кроки:
Відома помилка: сценарій, доданий для певного класу, видимий, навіть якщо менеджер жестів відкрито в іншому контексті.
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.
Режим читання журналу надає команди для полегшення читання та аналізу журналу. У вікні перегляду журналу читання журналу початково ввімкнено, тому команди читання журналу доступні негайно. В іншій області читання тексту, наприклад у редакторі (Notepad++) або на веб-сторінці (наприклад, GitHub), вам потрібно натиснути NVDA+control+alt+L, щоб увімкнути режим читання журналу та використовувати його команди. Коли ви закінчите з читанням журналу та аналізом завдань, ви можете знову натиснути NVDA+control+alt+L, щоб вимкнути режим читання журналу.
Команди, доступні в режимі читання журналу, описані нижче.
Команда з однієї літери, подібна до клавіш швидкої навігації в режимі огляду, дозволяє переходити до різних типів повідомлень журналу:
ERROR
and CRITICAL
)WARNING
)INFO
)DEBUGWARNING
)IO
)DEBUG
)Натискання однієї літери переходить до наступної події цього повідомлення. Комбінування літери з клавішею shift дозволяє перейти до попередньої події повідомлення.
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.
У журналі деякі рядки можуть посилатися на вихідний код:
File "virtualBuffers\__init__.pyc", line 226, in _getStoryLength
INFO - config.ConfigManager._loadConfig (22:45:26.145) - MainThread (16580):
Ви можете відкрити файл, що містить цей код, щоб зрозуміти контекст відстеження або зареєстрованого повідомлення. Просто натисніть C, щоб відкрити цей файл.
Щоб ця функція працювала, вам потрібно налаштувати [улюблену команду редактора] (#settingsOpenCommand) у налаштуваннях додатка. Якщо ви не запускаєте NVDA з вихідного коду, слід також налаштувати місце розташування вихідного коду NVDA.
NVDA вже надає резервну копію журналу попереднього сеансу роботи NVDA; файл
називається nvda-old.log
. Однак іноді вам може знадобитися доступ до
старих журналів, наприклад, якщо вам довелося перезапустити NVDA, перш ніж
переглянути nvda-old.log
. За допомогою цього додатка ви можете
налаштувати, чи потрібно створювати резервну копію старих журналів і скільки
їх має бути; це робиться у [налаштуваннях додатка] (#settingsLogsBackup).
Діалог менеджера журналів дозволяє переглядати резервні копії журналів. Його можна відкрити за допомогою меню NVDA -> Інструменти -> Менеджер журналів У цьому діалозі ви можете переглянути список усіх журналів резервного копіювання, відкрити або видалити їх. Щоб мати змогу відкрити журнал, вам слід попередньо налаштувати [Команду для відкриття файлу у вашому улюбленому редакторі] (#settingsOpenCommand).
У консолі можна викликати таку функцію, щоб переглянути вихідний код, який визначає змінну myVar
:
openCodeFile(myVar)
Щоб ця функція працювала, вам потрібно налаштувати [улюблену команду редактора] (#settingsOpenCommand) у налаштуваннях додатка. Якщо ви не запускаєте NVDA з вихідного коду, слід також налаштувати місце розташування вихідного коду NVDA.
Функції openCodeFile
можна викликати для об’єктів, розміщених у коді NVDA,
або для об’єктів, визначених додатками. Його не можна викликати на об’єктах,
вихідний код яких недоступний, наприклад, вбудовані модулі python.
Якщо ви ще не імпортували об’єкт у консоль, ви також можете передати його
ім’я як параметр у openCodeFile
.
Нижче наведено приклади викликів у коді NVDA:
speech.speech.speak
:
openCodeFile(speech.speech.speak)
або з ім'ям, переданим як параметр:openCodeFile("speech.speech.speak")
TextInfo
:
openCodeFile(textInfos.TextInfo)
copyToClipboard
класу TextInfo
:
openCodeFile(textInfos.TextInfo.copyToClipboard)
openCodeFile(focus)
api.py
, що визначає модуль api
:
openCodeFile(api)
Ви можете призначити спеціальний сценарій, який виконуватиметься в просторі імен консолі Python під час її першого відкриття або перезавантаження додатка (NVDA+F3) після того, як консоль уже відкриється.
Наприклад, сценарій дозволяє вам виконувати новий імпорт і визначати псевдоніми, які ви зможете використовувати безпосередньо в консолі, як показано нижче:
# Різний імпорт, який я хочу в консолі. import globalVars as gv import core import ui # Aliases ocf = openCodeFile
Сценарій консолі Python варто розмістити в такому місці: pathToNVDAConfig\\ndtt\consoleStartup.py
Наприклад:
C:\Users\myUserName\AppData\Roaming\\nvda\\ndtt\consoleStartup.py
Іноді вам потрібно буде подивитися, яка частина коду відповідає за мовлення. Для цього ви можете ввімкнути журнал відстеження функції мовлення, натиснувши NVDA+control+alt+S. Кожного разу, коли NVDA говорить, відповідна інформація буде записана в журналі.
Примітка. Ви можете змінити файл сценарію безпосередньо, щоб виправити іншу функцію. Перегляньте всі інструкції у файлі, щоб дізнатися більше про використання.
Деякі функції додатка можуть потребувати певної конфігурації. Панель налаштувань дозволяє увімкнути їх або керувати їхньою роботою. Щоб переглянути і змінити ці налаштування, перейдіть до меню NVDA -> Параметри -> Налаштування і виберіть категорію NVDA Dev & Test Toolbox. До цього діалога налаштувань також можна отримати доступ безпосередньо з діалога Менеджер журналів.
Ці параметри є глобальними, і їх можна налаштувати, лише коли активний початковий профіль.
Деякі функції дозволяють переглядати вміст у вашому улюбленому редакторі. До них належать команди перегляду вихідного файлу з журналу або з об'єкта у консолі, а також кнопка Відкрити менеджер журналів
Щоб ними скористатися, спочатку потрібно налаштувати команду, яка буде викликати відкриття файлу у вашому улюбленому редакторі.
Команда повинна мати вигляд:
"C:\path\до\мій\редактор\editor.exe" "{path}":{line}
Звичайно, вам слід змінити цей рядок відповідно до справжньої назви і розташування вашого редактора та синтаксису, який він використовує для відкриття файлів.
{path}
буде замінено на повний шлях до файлу, який потрібно відкрити, а {line}
- на номер рядка, на якому потрібно встановити курсор.
Для Notepad++, наприклад, команда для введення у консолі буде такою:
"C:\Program Files\Notepad++\notepad++.exe" "{path}" -n{line}
При використанні команди для [перегляду вихідного файлу з журналу] (#logReaderOpenSourceFile) або [з об'єкта у консолі] (#pythonConsoleOpenCodeFile), файл може належати самій NVDA.
Якщо ви не запускаєте NVDA з вихідного джерела, ваша NVDA містить лише скомпільовані файли.
Таким чином, ви можете вказати тут альтернативне місце, де буде знайдено відповідний вихідний файл, наприклад, місце, куди ви клонували вихідні файли NVDA, щоб вихідний файл можна було відкрити у будь-якому випадку.
Шлях має бути таким:
C:\pathExample\GIT\nvda\source
Звісно ж, замініть шлях джерела NVDA на правильний.
Але переконайтеся, що версія вашого вихідного файлу (наприклад, GIT commit) збігається з версією запущеного екземпляра NVDA.
Комбінований список Резервне копіювання старих журналів дозволяє увімкнути або вимкнути функцію. Якщо її увімкнено, ви також можете вказати нижче у полі "Обмежити кількість резервних копій" максимальну кількість резервних копій, яку ви хочете зберегти. Ці налаштування набудуть чинності лише під час наступного запуску NVDA, коли буде виконано резервне копіювання.
openCodeFile
тепер може отримувати параметр об'єкта
або рядок, що містить його ім'я.openCodeFile
і
команди для відкриття вихідного файлу, що відповідає рядку в журналі.[[!tag dev stable]]