Официальный русскоязычный каталог дополнений NVDA

Упаковщик дополнений

О дополнении

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

NVDA имеет множество дополнений, которые можно установить с [веб-сайт дополнений сообщества NVDA].(https://addons.nvda-project.org)

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

Дополнение создает резервную копию выбранных дополнений, упаковывает в стандартный файл ".nvda-addon", который можно установить в дальнейшем на другой ПК, другую копию NVDA или можно поделиться.

Также в процессе генерации дополнение автоматически удаляет папку "pycache".

Сгенерированный файл ".nvda-addon" также имеет номер версии, взятый из файла "manifest.ini", как оригинальные дополнения, загруженные с официального сайта сообщества.

Важное замечание

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

Использование дополнения

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

Нажимайте стрелки вверх и вниз для перемещения по списку дополнений. Чтобы выбрать одно дополнение, нажмите Пробел или, если нужно выбрать сразу все дополнения, нажмите Alt+В.

Кнопки можно перемещать с помощью клавиши Tab, они следующие:

• Выбрать все: выберет все доступные дополнения в списке;
• Убрать выделение со всего: все ранее сделанные выборки будут удалены;
• Папка назначения: текстовое поле только для чтения, которое по умолчанию пусто и будет местом назначения папки при первом выборе папки для создания дополнений;
• Обзор: откроет окно для выбора папки назначения;
• Генерировать дополнения: выбранные дополнения будут сгенерированы в выбранной папке;
• Закрыть: закроет окно дополнения.

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

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

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

В дополнении нет предопределенных жестов, и вы можете назначить их, зайдя в меню NVDA, Параметры, Жесты ввода... и отыскав категорию "Упаковщик дополнений". На данный момент есть только одна функция, которую можно назначить жесту: "Показывает окно упаковщика дополнения", которая будет открывать окно упаковщика дополнения.

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

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

Важные изменения в сгенерированном файле

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

В исходном дополнении сгенерированный файл ".nvda-addon" имел необязательный тег "gen" в конце имени файла (например: addonPacker-1.0_gen.nvda-addon), что указывало на то, что дополнение не было оригинальным и был сгенерирован.

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

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

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

• Alt + С: Перейти к списку дополнений.
• Alt + В: выбрать все дополнения, независимо от того, выбрано оно уже или нет.
• Alt + У: Отменить выбор всех выбранных дополнений.
• Alt + О: Открывает окно для выбора папки.
• Alt + Г: Генерирует выбранные дополнения.
• Alt + З или Alt + F4: Закрывает дополнение.

Уведомление о конфиденциальности

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

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

Я и, конечно же, автор дополнения (hxebolax) освобождаемся от какой-либо ответственности.

Авторы:

• hxebolax: оригинальный автор дополнения;
• Dragan Ratkovich, Модификации, редактор англоязычной документации, модификатор кода