docs.ubports.com

Документация UBports в едином рабочем репозитории. Исходники сайта, сборка, переводы и документационный workflow.

> repo: docs.ubports.com
> pipeline: build docs / update translations / publish site
> role: source of truth for UBports documentation

обзор

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

Как вносить изменения

Правила и рекомендации по участию описаны здесь:

• https://docs.ubports.com/en/latest/contribute/documentation.html

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

Сборка документации

Собрать документацию можно командой из корня репозитория:

./build.sh

Скрипт также создаст виртуальное окружение в ~/ubportsdocsenv, если его еще нет.

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

firefox _build/html/index.html

Обновление переводов

Чтобы обновить .po-файлы переводов, выполните:

./update-translations.sh

Чтобы добавить новый язык, внесите его ISO-код в languagues.sh, а затем снова запустите:

./update-translations.sh

контакты