From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Message-ID: Date: Thu, 11 Apr 2024 16:04:29 +0300 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird To: community@lists.altlinux.org References: Content-Language: ru From: Anton Farygin Organization: BaseALT In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Subject: Re: [Comm] Gitea + VitePress = ? X-BeenThere: community@lists.altlinux.org X-Mailman-Version: 2.1.12 Precedence: list Reply-To: ALT Linux Community general discussions List-Id: ALT Linux Community general discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 11 Apr 2024 13:04:30 -0000 Archived-At: List-Archive: List-Post: Олег, это конечно идеально написать в devel, а не в community@ On 09.04.2024 17:26, Олег Щавелев wrote: > > Случайная находка в глубинах интернета, VitePress — отличная история > для создания библиотеки знаний. Давайте по порядку! > > VitePress — это генератор статических сайтов (SSG), предназначенный > для быстрого создания веб-сайтов, ориентированных на контент. В двух > словах, VitePress берет ваш исходный контент, > написанный в Markdown , > применяет к нему тему и создает статические HTML-страницы, которые > можно легко развернуть где угодно. > > *Первой пробой пера стал ресурс ALT Gnome Wiki > , и хочется поделиться результатами работы > данной библиотеки знаний:* > > Количество авторов: 25 участников. > > Количество визитов за текущий квартал: 19,2 тыс. > > Количество пользователей за последний квартал: 10,4 тыс. > > Количество просмотров за последний квартал: 72,4 тыс. > > Мы предполагали, что внесение изменений в библиотеку знаний вызовут > сложности у активных участников, но это оказалось ошибочным суждением, > за полгода было отправлено 239 PR, что является, на мой взгляд, > отличным результатом. А общее количество изменений составляет 1262 > изменения. > > *Теперь о технических сладостях, и по порядку, как это все работает.* > > Все содержание проекта — это md-файлы, участник может написать статью > или ее изменить, а именно добавить файл или его редактировать и > отправить PR в наш адрес > , используя > сервис GitHub. Если сомневаетесь, что это просто, отправьте небольшой > PR и самостоятельно оцените, посмотрите, пощупаете. > > Далее мы принимаем PR и добавляем в основную ветку, и начинается самое > интересное, срабатывает автоматизация и запускается сервис GitHub > Actions , а после — GitHub Pages, > а если проще, то GitHub Actions запускают контейнер, который скачивает > и запускает Linux-среду, устанавливается окружение Node с утилитой npm > и в данной среде собирается проект, используя возможности Vitepress. > Результат — статические файлы, которые отправляются в сервис GitHub > Pages и уже доступны пользователям. > > К сожалению, от знакомых, сообществ и коллег иногда приходят тревожные > новости, что тот или иной аккаунт на GitHub заблокирован, как правило, > это временная история, но вы поняли, о чем идет речь. GitLab имеет > региональные ограничения по регистрациям определенных почтовых > провайдеров, а о точечных блокировках не слышно, хотя, может быть, они > и есть. А GitFlic не имеет таких возможностей по работе со > статическими сайтами. > > *А вот Gitea...* > > Как минимум умеет работать аналогично GitHub Actions > , так еще > полностью открытый, но нужен сервер и умелые руки системных > администраторов. Сделать небольшое пространство для сообщества Альта и > клипать интересные проекты совместно с дружным сообществом. К примеру > мы остановиться не можем и уже начали 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