GitLab Manager для NVDA

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

Возможности

• Просмотр репозиториев: Отображение списка ваших GitLab-репозиториев
• Создание репозиториев: Создание новых проектов с настройками видимости, лицензии и README
• Быстрый доступ: Открытие репозиториев в веб-браузере одним нажатием
• Настройки: Хранение персонального токена доступа для авторизации

Начало работы

Первая настройка

При первом запуске дополнения необходимо указать персональный токен доступа GitLab:

1. Создайте токен на GitLab:

   • Перейдите в настройки вашего профиля GitLab
   • Выберите “Access Tokens”
   • Создайте новый токен с правами api и read_repository
   • Скопируйте сгенерированный токен

2. В NVDA откройте Менеджер GitLab:

   • Нажмите NVDA+N для открытия меню NVDA
   • Перейдите в “Сервис” → “Менеджер GitLab…”
   • В появившемся окне введите ваш токен
   • Нажмите “ОК”

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

Основное окно управления

После настройки токена откроется главное окно Менеджера GitLab:

1. Список репозиториев - отображает все ваши проекты GitLab
2. Кнопки управления:
   • Открыть в браузере - открывает выбранный репозиторий в веб-браузере
   • Создать новый… - открывает диалог создания нового репозитория
   • Закрыть - закрывает окно

Создание нового репозитория

Диалог создания репозитория содержит следующие поля:

1. Имя репозитория - обязательное поле, название вашего проекта
2. Описание - необязательное поле для описания проекта
3. Видимость - уровень доступа к репозиторию:
   • private - только для вас и выбранных участников
   • internal - для всех авторизованных пользователей
   • public - публичный доступ
4. Инициализировать с README - создает файл README.md в новом репозитории
5. Лицензия - выбор лицензии для проекта:
   • нет - без лицензии
   • MIT - лицензия MIT
   • GPL-3.0 - GNU General Public License v3.0
   • Apache-2.0 - Apache License 2.0

Настройки

Токен доступа хранится в конфигурации NVDA и сохраняется между сеансами. Для изменения токена:

1. Удалите текущий токен из конфигурации (переименуйте или удалите файл nvda.ini в профиле пользователя)
2. Перезапустите NVDA
3. Запустите GitLab Manager и введите новый токен

Поиск и устранение неисправностей

“Не удалось получить список репозиториев”

1. Проверьте подключение к интернету
2. Убедитесь, что токен доступа действителен и не истек
3. Проверьте права токена (должны быть включены api и read_repository)
4. Если используете GitLab инстанс, убедитесь, что URL настроен корректно

“Не удалось создать репозиторий”

1. Проверьте, что у вас есть права на создание репозиториев
2. Убедитесь, что имя репозитория уникально
3. Проверьте сетевое подключение

Технические детали

Требования

• Аккаунт GitLab с API токеном

Хранение данных

• Токен доступа хранится в config.conf["gitlab"]["token"]
• URL GitLab API по умолчанию: https://gitlab.com/api/v4
• Для использования собственного GitLab инстанса измените URL в конфигурации

Безопасность

• Токен доступа хранится в зашифрованном виде в конфигурации NVDA
• Не передавайте файлы конфигурации третьим лицам
• Регулярно обновляйте токены доступа