Помощник отладки

• Автор: Люк Дэвис
• Скачать стабильную версию

Цель этого дополнения - облегчить отладку в NVDA. Новые функции будут добавлены на основе предложений пользователей. Все письма или GitHub issues с отзывами или идеями по функциям приветствуются.

Ключевая команда

• NVDA+shift+F1: вставляет маркерную строку в журнал NVDA.

Объяснение и использование

При нажатии командной клавиши дополнение вставляет в журнал NVDA (на уровне Info) строку, подобную следующей:

-- mark 1...

Оно также сообщит: "Зафиксирована отметка 1!".

Если вы снова нажмете на клавишу, то получите:

-- Марк 2...

и будет произнесено "Logged mark 2!".

Допустим, вы собираетесь выполнить ряд задач, которые, как вы знаете, приводят к появлению длинных ошибок в журнале NVDA. Вы собираетесь опубликовать соответствующие фрагменты журнала в списке рассылки или на NVDA GitHub issue tracker. Однако вы не хотите рыться во всем журнале, чтобы найти нужный контент. Поэтому вы используете это дополнение, чтобы вставить метку 1 прямо перед тем, как сделать то, что вызывает первую ошибку. Если вы знаете, что что-то еще вызовет последующие ошибки или ошибки другого типа, вы вставляете еще одну метку, чтобы отделить эту ошибку от предыдущей, или чтобы вы могли сказать: "Вот что я делал в метке 3, где возникли некоторые ошибки". Другой пример: во время работы с каким-то приложением происходит что-то, что вызывает ошибку (возможно, вы слышите звук ошибки Windows). Вы хотите вернуться и найти эту ошибку позже, но не хотите прекращать работу и сохранять журнал прямо сейчас. Поэтому вы снова используете это дополнение, чтобы вставить отметку в журнал. На этот раз отметка появится после ошибок в журнале, а не перед ними. Но в любом случае пометки помогут вам сузить важные разделы журнала.

Строки с метками, показанные выше, можно легко найти с помощью команды find в текстовом редакторе, таком как Notepad или Notepad++. Кроме того, по умолчанию над каждой меткой вставляется пустая строка. Пустые строки также возможны после метки. Пустые строки могут быть полезны, если вы используете программу просмотра журнала NVDA или другой текстовый редактор и хотите использовать клавиши со стрелками для быстрого чтения журнала вверх/вниз, чтобы найти определенную метку. Легко выбрать слово "blank" из кучи текста, который произносится при быстром перемещении по журналу. Если вы стреляете очень быстро, вам может понадобиться более одной пустой строки, что можно настроить в настройках.

Примечание: счетчик отметок выдержит перезагрузку плагинов (NVDA+control+F3), но начнет отсчет с единицы, если вы перезапустите NVDA.

Конфигурация:

В разделе настроек NVDA Preferences вы найдете категорию "Debug Helper". В диалоговом окне настроек вы можете изменить количество пустых строк, вставляемых до и после каждой строки метки. По умолчанию используется одна строка до и ноль после, хотя вы можете использовать от нуля до 10 строк. В категории "Инструменты" панели "Жесты ввода" NVDA вы можете изменить NVDA+shift+F1 на последовательность клавиш по вашему выбору.

Changelog

• Версия 1.0.2 (2019-08-28)
  • Перевод и очистка кода.
• Версия 1.0.1 (2019-08-26)
  • Незначительное исправление, вероятно, устраняющее проблему установки на некоторых версиях Windows.
• Версия 1.0 (2019-08-22)
  • Первоначальный релиз. Включает следующие возможности:
    • Возможность генерировать пронумерованные строки отметок в журнале (на уровне info).
    • Возможность добавлять 0-10 пустых строк до и после каждой линии отметок.
    • Настройка через диалоговую систему настроек NVDA.