[Comm] Gitea + VitePress = ?

[Олег Щавелев]

Случайная находка в глубинах интернета, VitePress — отличная история для 
создания библиотеки знаний. Давайте по порядку!

VitePress — это генератор статических сайтов (SSG), предназначенный для 
быстрого создания веб-сайтов, ориентированных на контент. В двух словах, 
VitePress <https://vitepress.dev/> берет ваш исходный контент, 
написанный в Markdown <https://github.com/markdown-it/markdown-it>, 
применяет к нему тему и создает статические HTML-страницы, которые можно 
легко развернуть где угодно.

*Первой пробой пера стал ресурс ALT Gnome Wiki 
<https://alt-gnome.wiki/>, и хочется поделиться результатами работы 
данной библиотеки знаний:*

Количество авторов: 25 участников.

Количество визитов за текущий квартал: 19,2 тыс.

Количество пользователей за последний квартал: 10,4 тыс.

Количество просмотров за последний квартал: 72,4 тыс.

Мы предполагали, что внесение изменений в библиотеку знаний вызовут 
сложности у активных участников, но это оказалось ошибочным суждением, 
за полгода было отправлено 239 PR, что является, на мой взгляд, отличным 
результатом. А общее количество изменений составляет 1262 изменения.

*Теперь о технических сладостях, и по порядку, как это все работает.*

Все содержание проекта — это md-файлы, участник может написать статью 
или ее изменить, а именно добавить файл или его редактировать и 
отправить PR в наш адрес 
<https://github.com/OlegShchavelev/ALTRegularGnomeWiki>, используя 
сервис GitHub. Если сомневаетесь, что это просто, отправьте небольшой PR 
и самостоятельно оцените, посмотрите, пощупаете.

Далее мы принимаем PR и добавляем в основную ветку, и начинается самое 
интересное, срабатывает автоматизация и запускается сервис GitHub 
Actions <https://docs.github.com/en/actions>, а после — GitHub Pages, а 
если проще, то GitHub Actions запускают контейнер, который скачивает и 
запускает Linux-среду, устанавливается окружение Node с утилитой npm и в 
данной среде собирается проект, используя возможности Vitepress. 
Результат — статические файлы, которые отправляются в сервис GitHub 
Pages и уже доступны пользователям.

К сожалению, от знакомых, сообществ и коллег иногда приходят тревожные 
новости, что тот или иной аккаунт на GitHub заблокирован, как правило, 
это временная история, но вы поняли, о чем идет речь. GitLab имеет 
региональные ограничения по регистрациям определенных почтовых 
провайдеров, а о точечных блокировках не слышно, хотя, может быть, они и 
есть. А GitFlic не имеет таких возможностей по работе со статическими 
сайтами.

*А вот Gitea...*

Как минимум умеет работать аналогично GitHub Actions 
<https://docs.gitea.com/next/usage/actions/overview>, так еще полностью 
открытый, но нужен сервер и умелые руки системных администраторов. 
Сделать небольшое пространство для сообщества Альта и клипать интересные 
проекты совместно с дружным сообществом. К примеру мы остановиться не 
можем и уже начали ALT KDE Wiki <https://alt-kde.wiki/>, но это 
отдельная история.

*А кто хочет подробности, несколько ссылок:*

https://gittea.dev/

https://packages.altlinux.org/ru/sisyphus/srpms/gitea/

https://docs.gitea.com/next/usage/actions/overview/

И, если нас услышат, будем делать совместные проекты в зоне 
altlinux.org, в крайнем случае — нет)
----------- следующая часть -----------
Вложение в формате HTML было удалено...
URL: <http://lists.altlinux.org/pipermail/community/attachments/20240409/946239dd/attachment.html>