[devel] Fwd: [Comm] Gitea + VitePress = ?
Evgeny Sinelnikov
sin на altlinux.org
Пт Апр 12 13:05:24 MSK 2024
Добрый день,
поддерживаю идею, с точки зрения стека давно искал удобный вариант.
Статический генератор + gitea выглядит очень интересно.
По-позже, отпишусь подробнее.
пт, 12 апр. 2024 г. в 01:27, Aleksey Novodvorsky <aen at basealt.ru>:
>
> чт, 11 апр. 2024 г. в 23:50, Alexey Shabalin <a.shabalin at gmail.com>:
> >
> > Всем привет.
> > Уже не первый раз обращаются с вопросом об организации на ресурсах
> > Альт сервиса, похожего на Github.
> > В основном хотят увидеть возможность хранения git + PR/MR. Дальше идут
> > Action (CI/CD), и как ниже в письме, например аналог Github Pages.
> >
> > Да, я тоже поддерживаю создание такого сервиса, и готов принять
> > участие в его создании.
> > Из наиболее популярных решений, предлагаю остановиться на gitea.
> > Gitlab слишком тяжелый как по используемым ресурсам, так и с точки
> > зрения администратора.
> > Не говоря уже о том, что опакетить его в сизиф практически нереально.
> > В этом смысле gitea (или её форки/предки) поддерживает большинство
> > запрашиваемых функций, при этом она остается удобной в
> > администрировании, и присутствует в сизифе.
> >
> > Так же перед созданием такого сервиса, надо будет решить несколько
> > организационно-технических вопросов:
> > - кого и как пускаем в этот сервис? только членов Team? всех? если
> > люди хотят сделать PR в какие-то проекты на gitea, то получается надо
> > дать возможность регистрации всем желающим.
>
> Ресурсы?
> Помимо материальных (обрудование, канал, администрирование) надо, по
> нынешним временам, учитывать контроль информации
> Возможно, стоит ограничиться теми, кого рекомендуют и обязуются
> контролировать члены тим.
>
> > в принципе неактивных можно удалять по крону :)
> > - Я бы предпочел в качестве сервиса аутентификации использовать
> > внешний сервис, а не внутреннюю базу пользователей gitea (наш сервис,
> > внешний для gitea :)
> > Этот наш новый сервис аутентификации позволит в дальнейшем
> > подключать наши новые сервисы для Team или сторонних пользователей, и
> > иметь единую учетку для доступа ко всем сервисам.
> +1
> > - Доменное имя для Pages (это уже решили, тут проблем нет).
> > - по остальному у меня есть представление, будут спорные вопросы,
> > попрошу помощи у аудитории.
>
> Мне это нравится.
>
> Прошу держать в cc: Олега Щавелева, автора исходного письма в
> community@, он не член тим
>
> Rgrds, Алексей
>
> >
> >
> > ---------- Forwarded message ---------
> > От: Олег Щавелев <oleg at alt-gnome.ru>
> > Date: вт, 9 апр. 2024 г. в 17:26
> > Subject: [Comm] Gitea + VitePress = ?
> > To: <community at lists.altlinux.org>
> >
> >
> > Случайная находка в глубинах интернета, 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 at lists.altlinux.org
> > https://lists.altlinux.org/mailman/listinfo/community
> >
> >
> > --
> > Alexey Shabalin
> > _______________________________________________
> > Devel mailing list
> > Devel at lists.altlinux.org
> > https://lists.altlinux.org/mailman/listinfo/devel
> _______________________________________________
> Devel mailing list
> Devel at lists.altlinux.org
> https://lists.altlinux.org/mailman/listinfo/devel
--
Sin (Sinelnikov Evgeny)
Подробная информация о списке рассылки Devel