Re: [Comm] Gitea + VitePress = ?

[Anton Farygin <rider@basealt.ru>]

Олег, это конечно идеально написать в devel, а не в community@


On 09.04.2024 17:26, Олег Щавелев wrote:
>
> Случайная находка в глубинах интернета, 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, в крайнем случае — нет)
>
>
> _______________________________________________
> community mailing list
> community@lists.altlinux.org
> https://lists.altlinux.org/mailman/listinfo/community