Руководство по zUtilidades

• Автор: Эктор Х. Бенитес Корредера (Héctor J. Benítez Corredera)
• Совместимость с NVDA: с 2024.1 по 2026.1
• Скачать дополнение:
• Проект на GitHub:

Содержание

• Введение
• Модуль "Запуск приложений"
• Главный экран
• Список категорий
• Список приложений
• Меню "Добавить действие"
• Редактировать действие
• Удалить действие
• Кнопка "Меню"
• Горячие клавиши
• Примечания автора
• Модуль "Быстрые заметки"
• Добавление быстрой заметки из любого места
• Виртуальные меню для "Запуска приложений" и "Быстрых заметок"
• Переводчики и соавторы
• Журнал изменений
• Версия 0.2.6
• Версия 0.2.7 и 0.2.8
• Версия 0.2.5
• Версия 0.2.4
• Версия 0.2.3
• Версия 0.2.2
• Версия 0.2.1
• Версия 0.2
• Версия 0.1.6
• Версия 0.1.5
• Версия 0.1

Введение

zUtilidades призван стать набором небольших приложений для NVDA.

Планируется добавлять приложения, которые могут представлять интерес, чтобы мы могли быстро обращаться к ним, и которые, в свою очередь, будут просты в использовании и иметь понятный интерфейс.

zUtilidades будет иметь меню в меню "Сервис" NVDA. В этом меню будут добавляться различные модули.

Для каждого модуля можно назначить горячую клавишу, перейдя в меню NVDA / Параметры / Жесты ввода и найдя там категорию zUtilidades.

По умолчанию модули не имеют назначенных клавиш.

Таким образом, мы можем запускать модули либо через меню Сервис / zUtilidades, либо назначив комбинацию клавиш для каждого модуля.

В настоящее время включает в себя следующие модули:

• Запуск приложений.
• Быстрые заметки.

Модуль "Запуск приложений"

Этот модуль позволяет нам быстро и из любой точки компьютера запускать приложение, будь то портативная версия или установленная программа.

Главный экран

Главный экран состоит из списка категорий, списка приложений и кнопки "Меню".

При нажатии клавиши Tab мы будем перемещаться по различным областям.

Список категорий

В этой области мы можем добавлять, редактировать или удалять категории, имея возможность сортировать наши приложения по категориям так, как нам удобно.

Получить доступ к опциям "Добавить", "Редактировать" или "Удалить" можно двумя способами.

Находясь в области "Категории", нажмите клавишу "Приложения" или, если у вас нет такой клавиши, Shift+F10. Откроется меню, где можно выбрать одну из трех опций.

Диалоги добавления и редактирования очень просты: в них есть одно текстовое поле для ввода имени новой категории или редактирования выбранной категории, а также две кнопки "OK" и "Отмена".

Если вы выберете удаление, имейте в виду, что содержимое этой категории будет удалено полностью без возможности отмены действия. Будьте осторожны, так как вы можете потерять все приложения, команды или ярлыки, которые были в этой категории, и их придется вводить заново.

Также можно получить доступ к этим опциям, либо нажав Tab до кнопки "Меню", либо с помощью комбинации клавиш Alt+M. Это откроет меню с подменю "Категории", где можно выбрать одну из трех вышеупомянутых опций.

Обратите внимание, что "Редактировать" и "Удалить" всегда применяются к категории, на которой установлен фокус. При отсутствии категорий будут выдаваться соответствующие сообщения.

С помощью комбинаций клавиш Alt + Стрелка вверх и Стрелка вниз можно перемещать категории для их сортировки.

Список приложений

В этой области отображаются приложения, соответствующие выбранной категории.

У нас есть три опции: "Добавить действие", "Редактировать действие" или "Удалить действие".

Эти опции можно вызвать так же, как и в списке категорий: либо клавишей "Приложения" или Shift+F10, либо перейдя к кнопке "Меню" (Alt+M) и выбрав подменю "Приложения".

В этом списке приложений можно запустить приложение, на котором установлен фокус, нажав клавишу пробела.

С помощью комбинаций клавиш Alt + Стрелка вверх и Стрелка вниз можно перемещать запись для сортировки.

В этой области можно быстро перемещаться по записям, нажимая первую букву названия. Это позволит быстро найти нужное приложение, если в базе данных их много.

Меню "Добавить действие"

В этом меню можно выбрать одну из следующих опций:

• Добавить приложение:

При добавлении приложения есть два обязательных поля: имя приложения и путь к папке, где находится ваше приложение.

В настоящее время дополнение поддерживает приложения с расширениями exe, bat и com.

После заполнения обязательных полей можно выбрать, требует ли приложение дополнительных параметров или его нужно запускать от имени администратора.

Если вы хотите запустить приложение от имени администратора, при запуске будет запрошено соответствующее разрешение.

• Добавить команду CMD

В этом диалоге можно добавлять консольные команды.

Поле имени для идентификации команды и поле команды являются обязательными.

Несколько важных замечаний: помимо запуска команд cmd, если вы владеете Windows PowerShell, вы также можете запускать команды PowerShell, введя в командной строке PowerShell, а затем то, что вы хотите выполнить.

Аналогично, для команд CMD можно выполнять несколько строк, которые должны быть разделены символом &. Этот символ вводится с помощью Shift+7 в английской раскладке клавиатуры. В русской раскладке это обычно Shift+7 (символ &). При использовании другой раскладки клавиша может отличаться.

Приведу пример командной строки для перезапуска проводника Windows, где используется символ & для разделения команд:

taskkill /f /im explorer.exe & start explorer

В этом диалоге также можно установить паузу, чтобы консоль не закрывалась и можно было увидеть результаты.

Также можно запускать команду от имени администратора.

• Добавить ярлык папки

В этом диалоге нужно выбрать имя для идентификации ярлыка папки и выбрать саму папку.

Это позволит быстро открывать папки вашей системы из любого места.

• Добавить для запуска ярлык Windows

В этом диалоге можно выбрать ярлык для запуска. Также можно выбрать, запускать ли его от имени администратора.

Поля для идентификации имени ярлыка и пути к нему являются обязательными.

• Добавить установленное приложение

В этом диалоге будут получены все приложения, установленные на вашем компьютере, как пользовательские, так и приложения, входящие в состав Windows.

Также на этом экране можно выбирать приложения, установленные из магазина Windows.

Предупреждение: это не работает для Windows 7.

После добавления приложения из этого диалога его нельзя редактировать. Если нужно изменить запись, ее придется удалить и добавить заново.

Опция запуска от имени администратора в этом диалоге будет работать не для всех приложений. Она работает только для тех, которые допускают повышение привилегий до администратора.

Также обратите внимание, что в этом диалоге в комбинированном списке также будут отображаться ярлыки, установленные приложениями. Их можно выбрать, но некоторые могут не открываться и выдавать ошибку.

Также следует быть осторожным, так как в этом списке могут отображаться приложения для администрирования или управления, которые лучше не трогать, если вы не знаете, для чего они предназначены.

Редактировать действие

Диалог "Редактировать" полностью аналогичен диалогу "Добавить действие", но позволяет изменять выбранную запись.

Он позволяет изменять все элементы, кроме тех, что были добавлены через опцию "Добавить установленное приложение". Диалоги будут такими же, как и в опциях добавления.

Удалить действие

При удалении записи имейте в виду, что это действие необратимо.

Кнопка "Меню"

Эта кнопка доступна из любой части интерфейса по комбинации Alt+M.

В этом меню находятся четыре подменю: "Категории", "Действия", "Создать или восстановить резервные копии" и "Параметры". Также в этом меню есть опция "Выход".

О подменю "Категории" и "Действия" уже было рассказано, поэтому объясню подменю "Создать и восстановить резервные копии" и "Параметры".

При выборе "Создать резервную копию" откроется стандартное окно сохранения Windows, где нужно будет выбрать место для сохранения резервной копии базы данных.

Имя файла по умолчанию выглядит примерно так:

Backup-03052021230645.zut-zl

Расширение устанавливается по умолчанию, а имя соответствует модулю и содержит дату создания. Можно задать любое имя.

После сохранения резервную копию можно восстановить в случае повреждения базы данных, случайного удаления или если вы захотите вернуться к сохраненной версии.

Выберите "Восстановить резервную копию", и откроется стандартное окно Windows для открытия файлов.

Нужно выбрать сохраненную копию с расширением *.zut-zl. Важно: не меняйте расширение, иначе файл не будет найден.

После выбора резервная копия будет восстановлена. При нажатии "OK" дополнение закроется, и при следующем открытии у вас будет восстановленная копия.

Файлы *.zut-zl на самом деле являются сжатыми архивами, но будьте осторожны с их изменением, так как при изменении не совпадет подпись, и восстановить их не удастся.

Это означает, что данные файлы имеют цифровую подпись, и если она не совпадает при восстановлении, возникнет ошибка. Подпись уникальна для каждого файла.

В подменю "Параметры" сейчас есть только опция "Вернуть значения по умолчанию для запуска приложений".

При выборе этой опции вся база данных будет удалена, и дополнение вернется в состояние, как после чистой установки.

Горячие клавиши

В обеих областях (категории и приложения) можно сортировать записи с помощью:

• Alt + Стрелка вверх или Стрелка вниз

Когда категория или приложение достигнут начала или конца списка, вы услышите характерный звуковой сигнал, информирующий о том, что дальше перемещать нельзя.

• Alt + C: Быстро переводит фокус в область категорий.
• Alt + L: Быстро переводит фокус в список приложений.
• Alt + M: Открывает меню.
• Клавиша "Приложения" или Shift + F10: В областях категорий и приложений открывает контекстное меню с опциями.
• Пробел: В области списка приложений запускает приложение, на котором установлен фокус.
• Escape: Закрывает все диалоги, которые может открыть приложение, включая главный экран "Запуска приложений", возвращая фокус туда, откуда он был вызван.

Примечания автора

Несколько замечаний. Во-первых, "Запуск приложений" будет закрываться при запуске какого-либо приложения, поэтому для запуска другого приложения его нужно вызывать снова.

Также реализована функция сохранения последней посещенной позиции категории и приложения. Таким образом, при открытии "Запуска приложений" всегда будут выбраны последняя категория и последнее приложение в этой категории.

Также реализовано сохранение фокуса, поэтому при вызове "Запуска приложений" фокус всегда будет установлен на то место, где он был перед закрытием.

Например, если фокус был на кнопке "Меню" и мы закрыли "Запуск приложений", то в следующий раз при открытии фокус окажется на кнопке "Меню".

Эти функции действуют только в течение текущей сессии NVDA. Это означает, что если перезапустить NVDA, фокус будет начинаться с области категорий.

Это дополнение предназначено для использования с Windows 10. Если вы используете более старые версии и у вас возникнут проблемы, сообщите о них, но, скорее всего, я ничего не смогу сделать, так как некоторые функции доступны только в Windows 10.

Модуль "Быстрые заметки"

Этот модуль служит для хранения под рукой небольших заметок, которые можно просматривать, редактировать и удалять.

Этот модуль имеет то же управление, что и "Запуск приложений", но отличается некоторыми клавишами, описанными ниже.

Я не буду заново объяснять меню, с помощью которого можно создавать резервные копии, восстанавливать их, возвращать дополнение к значениям по умолчанию, управлять категориями и заметками.

Я также не буду заново описывать навигацию по главному интерфейсу, так как она полностью идентична.

Мы можем добавить быструю заметку. В открывшемся диалоге можно ввести заголовок заметки и, нажав Tab, перейти к ее содержимому.

Диалог редактирования заметки полностью аналогичен: можно указать заголовок (или изменить существующий) и отредактировать текст заметки.

Этот модуль отличается от модуля запуска приложений использованием нескольких новых комбинаций клавиш.

• F1: При нахождении на заметке нажатие F1 озвучит ее содержимое.
• F2: Копирует текущую заметку в буфер обмена, чтобы вы могли вставить ее в любом месте, где поддерживается ввод текста. Для этого нужное приложение должно быть в фокусе, иначе ничего не произойдет.
• F3: Эта комбинация закроет окно быстрых заметок и вставит содержимое заметки, на которой был фокус, в то место, где находился фокус до вызова. То есть заметка вставляется в открытое приложение, если оно поддерживает вставку текста (например, "Блокнот", поле письма, Word и т.д.).

Это означает, что если мы вызовем модуль "Быстрые заметки" из "Блокнота" или из поля темы письма, то при нажатии этой комбинации текст вставится туда, где у нас был фокус.

Например, если запустить модуль "Быстрые заметки" с рабочего стола и нажать F3 на заметке, ничего не произойдет. Если мы откроем "Блокнот" и нажмем F3, содержимое заметки вставится в "Блокнот".

Будьте осторожны: если вы находитесь на рабочем столе или в месте, где невозможна прямая вставка, ничего не произойдет.

Также в области категорий и в области списка заметок по-прежнему работает сортировка этих областей с помощью Alt+Стрелка вверх/вниз для перемещения выбранного элемента.

При нажатии пробела откроется окно, в котором можно только просмотреть заметку.

Стоит сказать, что этот модуль поставляется без назначенной горячей клавиши, поэтому ее нужно будет добавить в "Жесты ввода".

В меню "Параметры" был добавлен диалог "Настройки".

В настоящее время в нем есть только одна опция:

• Захватывать заголовок окна в быстрые заметки (из любого места)

Если эта опция отмечена, то при нажатии "Добавить новую быструю заметку" или "Добавить быструю заметку из выделенного текста" поле заголовка заметки будет автоматически заполняться заголовком окна, которое было в фокусе на момент вызова.

Добавление быстрой заметки из любого места

Модуль "Быстрые заметки" также имеет функцию добавления быстрых заметок из любого места без необходимости открывать дополнение для добавления.

В диалоге "Жесты ввода" теперь можно настроить новую комбинацию клавиш, которую можно найти в:

NVDA / Параметры / Жесты ввода / zUtilidades / "С одним нажатием добавить быструю заметку из выделенного текста, с двойным нажатием добавить новую быструю заметку".

Когда комбинация клавиш будет назначена, нужно просто выделить текст в любом месте и нажать эту комбинацию.

Откроется окно, в котором первым делом нужно выбрать категорию для сохранения заметки. Будут показаны только созданные вами категории.

При нажатии Tab мы перейдем в поле для ввода заголовка заметки. Следующее нажатие Tab приведет нас к полю с выделенным ранее текстом.

При нажатии "OK" заметка будет сохранена в выбранной категории.

Если нажать эту комбинацию дважды, откроется тот же экран, но для создания заметки с нуля. Нужно будет выбрать категорию, ввести заголовок и содержимое заметки.

Виртуальные меню для "Запуска приложений" и "Быстрых заметок"

Эти меню призваны расширить возможности zUtilidades, делая его использование более продуктивным и быстрым.

Жесты, назначенные для запуска приложений и быстрых заметок, теперь имеют двойное нажатие.

Если нажать эту комбинацию один раз, откроется графический интерфейс; если нажать дважды, откроется виртуальное меню.

В этом меню можно перемещаться с помощью стрелок вправо и влево между категориями, и с помощью стрелок вверх и вниз между элементами выбранной категории (если они есть).

Между меню "Запуска приложений" и "Быстрых заметок" есть некоторые различия.

В виртуальном меню запуска приложений мы перемещаемся стрелками и нажимаем Enter для выполнения выбранного элемента, которое соответствует соответствующему действию.

Если это команда cmd, она выполнится; если это ярлык папки, произойдет то же самое, как и в графическом интерфейсе.

Клавиша Escape позволяет выйти из меню, если не нужно ничего делать.

Также можно перемещаться по категориям, нажимая первую букву их названия. Буква "ё" не поддерживается, все остальные буквы приведут к быстрому переходу к категории с соответствующей первой буквой.

Если нет категории на нажатую букву, будет произнесено вспомогательное сообщение, как и при нажатии любой другой клавиши, отличной от упомянутых.

Важно отметить, что пока меню активно, все остальные комбинации клавиш NVDA не будут работать до выхода из меню.

В меню "Быстрых заметок" клавиша пробела не используется, и есть отличия от меню запуска приложений.

Если на элементе нажать F1, будет озвучено содержимое заметки; F2 скопирует заметку в буфер обмена; F3 вставит содержимое заметки туда, где находится фокус.

Как и прежде, пока это меню активно, оно имеет приоритет до тех пор, пока не будет нажата клавиша Escape для выхода из меню и восстановления обычной функциональности клавиатуры.

Переводчики и соавторы:

• Французский: Rémy Ruiz
• Португальский: Ângelo Miguel Abrantes
• Итальянский: Alessio Lenzi
• Русский: Valentin Kupriyanov
• Турецкий: Umut KORKMAZ
• Арабский: Wafiq Taher
• Датский: Daniel Gartmann
• Javi Domínguez: Огромное спасибо за обучение программированию меню. Вернее, за объяснение для таких, как я.
• Украинский: VovaMobile
• Английский: Sof

Журнал изменений

Версия 0.2.7 и 0.2.8

• Добавлен английский язык.

Версия 0.2.6

• Добавлен датский язык.
• Исправлена проблема со строками Брайля и отображением сообщений.
• Добавлена совместимость с NVDA 2023.1

Версия 0.2.5

• Исправлена ошибка безопасности на защищенных экранах.
• Исправлена проблема с перезагрузкой дополнений в NVDA.

Версия 0.2.4

• Добавлена возможность захвата URL-адреса в быструю заметку. Настройка в параметрах модуля zNotas.
• Добавлены русский и турецкий языки.
• Исправлена ошибка с внутренними путями NVDA.
• Исправлена ошибка на клавиатурах с кириллическими символами.
• Совместимость с NVDA 2022.1.

Версия 0.2.3

Добавлена возможность захвата заголовка окон при добавлении новой быстрой заметки или при добавлении быстрой заметки из выделенного текста.

Эта опция может быть активирована в меню модуля "Быстрые заметки" в разделе "Параметры" / "Настройки".

Если флажок установлен, то при вызове опций "Добавить новую быструю заметку" или "Добавить быструю заметку из выделенного текста" будет захватываться заголовок окна, из которого был вызван модуль.

Версия 0.2.2

• Добавлена возможность перемещать элементы как в запуске приложений, так и в заметках между категориями.
• Добавлено двойное нажатие для клавиши "Добавить быструю заметку из выделенного текста". Теперь двойное нажатие позволяет создать новую быструю заметку с нуля.
• Обновлена документация на французском языке.
• Добавлен итальянский язык.

Версия 0.2.1

• Исправлена проблема с пустым буфером обмена при попытке вставить текст.

Версия 0.2

• Исправлено множество внутренних ошибок.
• Стабилизирован модуль "Запуск приложений".
• Добавлен новый модуль "Быстрые заметки".
• Добавлены виртуальные меню для обоих модулей.

Версия 0.1.6

• Добавлены французский и португальский (Португалия/Бразилия) языки.

Версия 0.1.5

• Реструктурированы меню.

Добавлена возможность добавлять:

• Добавить команду CMD
• Добавить ярлык папки
• Добавить для запуска ярлык Windows
• Добавить установленное приложение
• В кнопку "Меню" добавлена возможность в "Параметрах" вернуть значения по умолчанию для запуска приложений.
• Исправлены различные ошибки, связанные с базой данных.
• Исправлены внутренние ошибки.
• Дополнение подготовлено для перевода.

Версия 0.1

• Добавлен модуль "Запуск приложений".
• Начальная версия.