<!DOCTYPE html>
<html data-lt-installed="true">
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
</head>
<body style="padding-bottom: 1px;">
<p>Случайная находка в глубинах интернета, VitePress — отличная
история для создания библиотеки знаний. Давайте по порядку!</p>
<p>VitePress — это генератор статических сайтов (SSG),
предназначенный для быстрого создания веб-сайтов, ориентированных
на контент. В двух словах, <a href="https://vitepress.dev/">VitePress</a>
берет ваш исходный контент, написанный в <a
href="https://github.com/markdown-it/markdown-it">Markdown</a>,
применяет к нему тему и создает статические HTML-страницы, которые
можно легко развернуть где угодно.</p>
<p><b>Первой пробой пера стал ресурс <a
href="https://alt-gnome.wiki/">ALT Gnome Wiki</a>, и хочется
поделиться результатами работы данной библиотеки знаний:</b></p>
<p>Количество авторов: 25 участников.</p>
<p>Количество визитов за текущий квартал: 19,2 тыс.</p>
<p>Количество пользователей за последний квартал: 10,4 тыс.</p>
<p>Количество просмотров за последний квартал: 72,4 тыс.</p>
<p>Мы предполагали, что внесение изменений в библиотеку знаний
вызовут сложности у активных участников, но это оказалось
ошибочным суждением, за полгода было отправлено 239 PR, что
является, на мой взгляд, отличным результатом. А общее количество
изменений составляет 1262 изменения.</p>
<p><b>Теперь о технических сладостях, и по порядку, как это все
работает.</b></p>
<p>Все содержание проекта — это md-файлы, участник может написать
статью или ее изменить, а именно добавить файл или его
редактировать и отправить <a
href="https://github.com/OlegShchavelev/ALTRegularGnomeWiki">PR
в наш адрес</a>, используя сервис GitHub. Если сомневаетесь, что
это просто, отправьте небольшой PR и самостоятельно оцените,
посмотрите, пощупаете.</p>
<p>Далее мы принимаем PR и добавляем в основную ветку, и начинается
самое интересное, срабатывает автоматизация и запускается сервис <a
href="https://docs.github.com/en/actions">GitHub Actions</a>, а
после — GitHub Pages, а если проще, то GitHub Actions запускают
контейнер, который скачивает и запускает Linux-среду,
устанавливается окружение Node с утилитой npm и в данной среде
собирается проект, используя возможности Vitepress. Результат —
статические файлы, которые отправляются в сервис GitHub Pages и
уже доступны пользователям.</p>
<p>К сожалению, от знакомых, сообществ и коллег иногда приходят
тревожные новости, что тот или иной аккаунт на GitHub
заблокирован, как правило, это временная история, но вы поняли, о
чем идет речь. GitLab имеет региональные ограничения по
регистрациям определенных почтовых провайдеров, а о точечных
блокировках не слышно, хотя, может быть, они и есть. А GitFlic не
имеет таких возможностей по работе со статическими сайтами.</p>
<p><b>А вот Gitea...</b></p>
<p>Как минимум умеет работать аналогично <a
href="https://docs.gitea.com/next/usage/actions/overview">GitHub
Actions</a>, так еще полностью открытый, но нужен сервер и
умелые руки системных администраторов. Сделать небольшое
пространство для сообщества Альта и клипать интересные проекты
совместно с дружным сообществом. К примеру мы остановиться не
можем и уже начали <a href="https://alt-kde.wiki/">ALT KDE Wiki</a>,
но это отдельная история.</p>
<p><b>А кто хочет подробности, несколько ссылок:</b></p>
<p><a class="moz-txt-link-freetext" href="https://gittea.dev/">https://gittea.dev/</a></p>
<p><a class="moz-txt-link-freetext"
href="https://packages.altlinux.org/ru/sisyphus/srpms/gitea/">https://packages.altlinux.org/ru/sisyphus/srpms/gitea/</a></p>
<p><a class="moz-txt-link-freetext"
href="https://docs.gitea.com/next/usage/actions/overview/">https://docs.gitea.com/next/usage/actions/overview/</a></p>
<p>И, если нас услышат, будем делать совместные проекты в зоне
altlinux.org, в крайнем случае — нет)</p>
<p></p>
</body>
<lt-container></lt-container>
</html>