Руководство для Store NVDA.RU

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

Как использовать

Дополнение поставляется без назначенных команд для ярлыков, и мы можем назначить команды для этих ярлыков:

• Показывает окно со всеми дополнениями и информацией о них: Это покажет нам окно со всеми дополнениями, которые у нас есть в магазине nvda.ru.
• Проверяет обновления установленных дополнений: магазин проанализирует установленные дополнения и, если обнаружит обновление, предложит нам возможность обновить их автоматически.
• Открыть папку с загруженными дополнениями: Это поможет нам открыть папку со скаченными файлами. Путь до этой папки задаётся в настройках дополнения.

Мы можем назначить клавиатурные команды для этих трёх опций, зайдя в меню NVDA / Параметры / Жесты ввода и поискать Магазин NVDA.RU.

Отображение окна со всеми дополнениями и информацией о них.

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

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

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

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

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

На этом экране у нас есть следующие клавиши быстрого доступа для перемещения по интерфейсу:

• F1: Однократное нажатие прочитать описание, двукратное нажатие скопировать в буфер обмена.
• F2: Скачать дополнение в папку загрузок.
• F3: Скопировать ссылку на загрузку дополнения в буфер обмена.
• F4: Открыть папку с загруженными дополнениями.
• F5: Однократное нажатие сообщит версию, двукратное сообщит протестированную и минимальную версию NVDA, трёхкратное скопирует всю эту информацию в буфер обмена.
• F6: Однократное нажатие скопирует ссылку на страницу дополнения в магазине, двукратное откроет эту ссылку в браузере.
• F7: Однократное нажатие скопирует ссылку на страницу репозитория разработчика дополнения, двукратное откроет эту ссылку в браузере.
• Alt+1: Переход в область поля поиска *Alt+2: Переход в область списка дополнений.
• Alt+3: Переход в область информации.
• Application, Shift+F10: открыть контекстное меню действий.
• Escape, Alt+F4: закрыть окно.

Контекстное меню в списке дополнений

В списке дополнений можно открыть контекстное меню либо с помощью клавиши Applications на обычной клавиатуре, либо Shift + F10 для тех клавиатур, на которых нет клавиши Applications.

Примечание: Клавиши "Application" и Shift+F10 срабатывают только в области списка дополнений.

Это меню состоит из четырёх подменю и двух пунктов:

• Скачать дополнение.
• Фильтры (подменю).
• Копировать в буфер обмена (подменю).
• Посетить (подменю).
• Открыть папку загрузки.
• Просмотреть документацию установленного дополнения (пункт будет доступен на дополнениях у которых есть документация).
• Сменить сервер (подменю).

В подменю "Фильтры" у нас есть следующие опции:

• Показать все дополнения: Эта опция используется по умолчанию при первом запуске магазина.

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

• Показать дополнения, совместимые с API 2027: Эта опция будет показывать только те дополнения, которые отмечены в манифесте как совместимые с API 2027.

• Показать дополнения, совместимые с API 2026: Эта опция будет показывать только те дополнения, которые отмечены в манифесте как совместимые с API 2026.

• Показать дополнения, совместимые с API 2025: Эта опция будет показывать только те дополнения, которые отмечены в манифесте как совместимые с API 2025.

• Показать дополнения, совместимые с API 2024: Эта опция будет показывать только те дополнения, которые отмечены в манифесте как совместимые с API 2024.

• Показать дополнения, совместимые с API 2023: Эта опция будет показывать только те дополнения, которые отмечены в манифесте как совместимые с API 2023.

• Показать дополнения, совместимые с API 2022: Эта опция будет показывать только те дополнения, которые отмечены в манифесте как совместимые с API 2022.

• Показать дополнения, совместимые с API 2021: Эта опция будет показывать только те дополнения, которые отмечены в манифесте как совместимые с API 2021.

• Показать дополнения, совместимые с API 2020: Эта опция будет показывать только те дополнения, которые отмечены в манифесте как совместимые с API 2020.

• Показать дополнения, совместимые с API 2019: Эта опция будет показывать только те дополнения, которые отмечены в манифесте как совместимые с API 2019.

• Показать дополнения, совместимые с API 2018: Эта опция будет показывать только те дополнения, которые отмечены в манифесте как совместимые с API 2018 и старее.

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

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

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

Эти опции выполняются индивидуально, и их результаты нельзя сохранять.

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

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

В подменю "Копировать в буфер обмена" у нас есть следующие опции:

• Копировать информацию: Если мы выберем эту опцию, вся вкладка выбранного нами дополнения будет скопирована в буфер обмена.

• Скопировать ссылку на страницу дополнения в магазине: Если мы выберем эту опцию, URL на страницу дополнения в русском каталоге будет скопирован в буфер обмена, также не открывая контекстного меню можно нажать команду F6.

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

• Копировать ссылку для скачивания: Когда мы нажмём этот пункт, то скопируется URL в буфер обмена для загрузки дополнения, также не открывая контекстного меню можно нажать команду F3.

• Копировать описание: Когда мы нажмём этот пункт, то скопируется описание в буфер обмена, также не открывая контекстного меню можно нажать дважды команду F1, однократное нажатие просто прочитает вам описание

В подменю "Посетить" у нас есть следующие опции:

• Страницу дополнения в магазине: Если мы выберем эту опцию, URL на страницу дополнения в русском каталоге будет открыт в браузере, также не открывая контекстного меню можно дважды быстро нажать команду F6.

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

В подменю "Сменить сервер" у нас есть следующие опции:

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

Проверить наличие обновленных дополнений

Это позволит нам обновить те дополнения, которые в https://nvda-addons.ru являются более новыми, чем те, которые установлены на нашем компьютере.

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

Нужно отметить пробелом нужное дополнение и нажать на кнопку "Обновить".

На этом экране будет показано обновление, которую мы выбрали.

На этом экране имеются следующие клавиши:

Примечание: Нижеследующие команды кроме закрытия окна, на текущий момент не работают.

• Alt+S: Выделит все дополнения из списка, чтобы установить все обновления наших дополнений, установленных на компьютере.
• Alt+D: Снимет выделение из списка всех обновлений всех дополнений, если они были отмечены ранее.
• Alt+A: Запустит обновление тех дополнений, которые мы выбрали в списке.
• Alt+C, Alt+F4 или Escape: закроет окно.

Панель настроек

Вы можете настроить некоторые аспекты дополнения "Магазин NVDA.RU", зайдя в меню NVDA / Параметры / Настройки и отыскав категорию NМагазин VDA.RU.

• Включить или отключить проверку обновлений.

Следует отметить, что флажок "Включить или отключить проверку обновлений" по умолчанию отключен.

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

• 15 минут
• 30 минут
• 45 минут
• 1 час
• 12 часов
• 1 день
• 1 неделя

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

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

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

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

• Сортировать дополнения магазина и результаты поиска по алфавиту.

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

• Устанавливать дополнения после загрузки.

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

• Папка загрузки.

По умолчанию каталог загрузки расположен в пользовательской папки NVDA.'nvda\Store\dl

При помощи кнопки "Обзор" вы можете изменить путь к нужной вам папке.

• Установленные дополнения, доступные на сервере.

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

Будут показаны только те, которые совместимы с текущим NVDA Api.

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

ВНИМАНИЕ: Изменения в списке будут сохранены, только если вы нажмете кнопку ОК или Применить в диалоговом окне параметров.

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

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

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

Примечание

При проверке обновлений теперь есть две защиты:

1-Проверяется, есть ли дополнения, которые необходимо удалить.

Если да, то эти дополнения будут исключены, даже если есть обновления.

2º Проверяется, соответствует ли дополнение на сервере требованиям API установленного NVDA.

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

При установке также предусмотрены некоторые средства защиты:

1º Теперь он предупредит нас, если дополнение не было обновлено, и сообщит его название.

2º На этом этапе также проверяется, имеет ли устанавливаемое дополнение минимальную версию для использования в NVDA, которую мы установили.

3º Дополнение "Store" не позволит нам продолжить поиск обновлений, если мы уже обновили одно или несколько дополнений и не решили перезапустить NVDA.

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

5º Аналогичным образом, если мы попытаемся активировать опцию "Проверка обновлений установленных дополнений" и не перезапустим NVDA, программа чтения выдаст сообщение о необходимости перезапустить NVDA для применения обновлений.

6º В худшем случае, если базы не загружаются из-за отсутствия Интернета, нам будут показаны информационные сообщения в реестре NVDA, а также при попытке зайти в магазин мы получим предупреждение в виде голосового сообщения.

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

Версия 2026.04.03.

• Устранены ошибки при открытии диалоговых окон проявившиеся в NVDA 2026.1 из-за изменения API.
• Настройки магазина перенесены из общих настроек NVDA в отдельное диалоговое окно.
• В подменю «Магазин NVDA.RU« добавлен пункт «Настройки магазина».
• В жестах ввода добавлен ярлык «Показывает окно настроек магазина» без назначеного сочетания клавиш.
• В подменю «Магазин NVDA.RU« добавлен пункт «Открыть папку загрузки» с загруженными дополнениями.

Версия 2026.02.21.

В диалоговое окно списка дополнений добавлены следующие команды:

• F5: Однократное нажатие сообщит версию, двукратное сообщит протестированную и минимальную версию NVDA, трёхкратное скопирует всю эту информацию в буфер обмена.
• F6: Однократное нажатие скопирует ссылку на страницу дополнения в магазине, двукратное откроет эту ссылку в браузере.
• F7: Однократное нажатие скопирует ссылку на страницу репозитория разработчика дополнения, двукратное откроет эту ссылку в браузере.

В контекстное меню «Действия» добавлены следующие пункты:

• В подменю скопировать в буфер обмена:
• Скопировать ссылку на страницу дополнения в магазине.
• Скопировать ссылку на репозиторий разработчика.
• Добавлено подменю «Посетить» с пунктами:
• Страницу дополнения в магазине.
• Репозиторий разработчика.

Переименованы пункты:

• Копировать ссылку на веб-страницу дополнения на Скопировать ссылку на репозиторий разработчика.

• Посетить веб-страницу на Репозиторий разработчика.

• обновлена справка и локализация для интерфейса.

Версия 2026.02.11.

• Добавлен фильтр показа дополнений совместимых с API NVDA 2018 и старее.
• Полностью изменена логика для фильтрации дополнений по API NVDA.
• Теперь учитывается весь диапазон API NVDA указанный в параметрах minimumNVDAVersion и lastTestedNVDAVersion.

Примеры:

Если в значениях указано: minimumNVDAVersion = 2024.1 lastTestedNVDAVersion = 2026.1 Такое дополнение будет доступно в фильтрах для API 2024, 2025, 2026.

А если указано значение: minimumNVDAVersion = 2026.1 lastTestedNVDAVersion = 2026.1 Такое дополнение будет доступно только в фильтре для API 2026.

Если указаны следующие значения: minimumNVDAVersion = 2013.1 lastTestedNVDAVersion = 2018.2 Такое дополнение будет доступно только в фильтре для API 2018.

А вот если будет указаны следующие значения: minimumNVDAVersion = 2025.1 lastTestedNVDAVersion = 2999.9 Такое дополнение будет доступно в фильтрах для API 2025, 2026, 2027.

Версия 2026.02.05.

• В диалоговом окне списка дополнений добавлено три сочетания клавиш для быстрого перехода между следующими областями:
• Alt+1: Поле поиска
• Alt+2: Список. дополнений.
• Alt+3: Область информации.
• • Добавлена кнопка очистки поля поиска (кнопка доступна лишь тогда когда в поле есть хоть бы один введенный символ). После очистки список обновляется фокус перемещается в область списка дополнений.
• В Общих настройках NVDA, удалена автоматическая фокусировка на первом элементе при попадании курсора на панель «Магазин NVDA.RU». Это вызывало дополнительное замедление и подвисание NVDA.
• Обновлены переводы и справка.

Версия 2025.12.05.

• Исправлена сортировка по количеству загрузок - теперь сортируется как числовые значения (по убыванию), а не как строки.
• Расширен функционал поиска - теперь поиск работает не только по названиям дополнений, но и по авторам и описаниям.

Версия 2025.12.03.

• Улучшена установка фокуса при открытии диалоговых окон с установкой курсора на нужные элементы.
• Улучшена стабильность открытия диалоговых окон.
• Добавлен короткий звук и голосовое сообщение при открытии диалоговых окон.

Версия 2025.12.01.

В диалоговое окно списка дополнений добавлены следующие функции:

• Команда F1 - однократное нажатие прочитать описание, двойное быстрое нажатие скопировать описание в буфер обмена.
• Команда F4 - открыть папку загрузок выбранную в настройках.
• В контекстном меню добавлены пункты:
• Открыть папку загрузки.
• Копировать описание (в подменю Копировать в буфер обмена).
• Обновлены переводы для интерфейса.
• Обновлена справочная документация.

Версия 2025.11.28.

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

Версия 2025.10.15.

• Изменен манифест для беспрепятственной установки на NVDA 2026.1.

Версия 2025.07.27.

В диалоговом окне списка дополнений изменен интерфейс следующим образом.

Убраны кнопки:

• Скачать дополнение.
• Посетить веб-страницу.
• Просмотреть документацию по установленному дополнению.
• Изменить сервер.

Функции этих кнопок перемещены в контекстное меню "Действия" в следующем порядке:

• Скачать дополнение.
• Фильтры (подменю).
• Скопировать в буфер обмена (подменю).
• Посетить веб -страницу.
• Просмотреть документацию по установленному дополнению.
• Изменить сервер (подменю).

Изменены пункты меню:

• Пункт "Скачать дополнение" изменен с подменю на обычный пункт. Для пункта назначена команда F2.
• Пункт "Скопировать ссылку для скачивания" изменен с подменю на обычный пункт. Для пункта назначена команда F3.

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

В области поиска убрана кнопка "Искать". Для запуска поиска достаточно после написания запроса нажать в редакторе клавишу Enter.

Версия 2025.07.22.

• • В панель настроек добавлена опция для выбора директории для загрузки дополнений.
• По умолчанию загружаемые дополнения будут сохраняться в пользовательскую папку конфигурации NVDA, в "Store\dl".
• • В жестах ввода добавлен ярлык для открытия директории загруженных дополнений.
• Удален весь функционал для автоперевода описаний (внешняя зависимость перестала работать).

Версия 2025.06.19

• Незначительное улучшение: С этой версии в интерфейсе NVDA дополнение будет отображаться как «Магазин NVDA.RU»,. Таким образом пользователям будет легче различать сторонние магазины дополнений.
• Благодарю за конструктивное предложение Ольгу Троян.

Версия 2025.05.09

Эта версия была выпущена в честь восьмидесятой годовщины Великой Победы Советского народа над европейским нацизмом.

& Практически весь код дополнения переведен на английский.

• Дополнение TiendaNVDA выведено в отдельную ветку под названием Store.
• В подменю "Фильтры" добавлен диапазон пунктов "Показывать дополнения с поддержкой API 2023" до "Показывать дополнения с поддержкой API 2019".
• По умолчанию добавлен сервер русского сообщества.
• Обновлены переводы для русского.