Genesis (Генератор проектов дополнений для NVDA)

• Автор: Edilberto Fonseca edilberto.fonseca@outlook.com
• Лицензия: GPL 2
• Версия: 2025.1.0

Описание

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

При желании Genesis может создать удалённый репозиторий на GitHub, используя официальный шаблон.

Сгенерированная структура основана на официальном шаблоне сообщества NVDA: https://github.com/nvaccess/addonTemplate

Основные возможности

• Интуитивно понятный и доступный графический интерфейс
• Автоматическая генерация начальной структуры дополнения
• Заполнение основных метаданных
• Возможность включения папок документации и локализации
• Возможность клонирования официального репозитория NVDA
• Опциональная интеграция с GitHub
• Выделенная панель настроек в NVDA

Целевая аудитория

Дополнение предназначено для:

• Начинающих, которые хотят создать своё первое дополнение
• Опытных разработчиков, желающих ускорить запуск новых проектов

Требования

Для использования Genesis

Внешние зависимости не требуются. Дополнение работает непосредственно в NVDA.

Для разработки сгенерированного дополнения

Установите:

• Python 3.13 (рекомендуется 64-битная версия) https://www.python.org/downloads/windows/
• Git https://git-scm.com/
• Scons 4.5.2 или выше pip install scons
• GNU Gettext Требуется для компиляции файлов перевода https://gnuwin32.sourceforge.net/downlinks/gettext.php
• Markdown 3.3.0+ (опционально) pip install markdown

Для публикации на GitHub (опционально)

• Учётная запись GitHub
• Токен доступа (PAT) с разрешением repo

Удалённая публикация происходит только при включении в: NVDA > Параметры > Настройки > Genesis

Аутентификация GitHub

Если включена опция «Разрешить публикацию репозитория на GitHub», Genesis запросит ваш токен доступа.

Когда опция отключена:

• Аутентификация запрашиваться не будет
• Никакие данные не будут отправлены на GitHub
• Проект будет создан только локально

Как создать токен на GitHub

1. Перейдите на страницу https://github.com/settings/tokens
2. Перейдите в раздел «Tokens (classic)» → «Generate new token (classic)»
3. Установите имя
4. Выберите срок действия
5. Выберите разрешение repo
6. Создайте токен и сохраните его в надёжном месте

Примечания

• Токен не сохраняется дополнением
• Он проверяется напрямую через API GitHub
• Его можно отозвать в любое время

Установка

Через магазин дополнений

1. NVDA > Сервис > Магазин дополнений
2. Вкладка «Доступные»
3. Найдите «Genesis»
4. Нажмите «Установить»
5. Перезапустите NVDA

Ручная установка

1. Скачайте файл genesis.nvda-addon
2. Нажмите Enter на скачанном файле
3. Следуйте инструкциям для установки дополнения
4. Перезапустите NVDA

Технические характеристики

• Использует официальный шаблон NVDA в качестве основы
• Совместим с официальной системой сборки
• Удалённая публикация является опциональной
• Метаданные автоматически применяются к файлу buildVars.py

Сочетания клавиш

| Сочетание | Действие | | ------------- | -------------------------------------- | | NVDA+Alt+G | Открывает Genesis | | Alt+G | Генерирует новый проект | | Alt+L | Очищает все поля | | Alt+T | Клонирует официальный репозиторий NVDA | | Alt+S | Закрывает Genesis |

Переводчики

• Португальский (Бразилия), pt_BR — Edilberto Fonseca