Как хранить сайт на гитхабе?

Question

[Губернатор]

Не знаю как грамотно сформулировать, но есть некоторые сайты которые предлагают внести правки в статьи/страницы сделав пулл реквест в их гитхаб.
Интересует как работает такая концепция и как реализовать такое самостоятельно?
То есть что бы страницы хранились в гит-репозитории и при обновлении соответственно обновлялась страница.

Не много слышал про CI/CD, но не уверен что это то что нужно.

Пример сайта который позволяет редактировать свои статьи пулл-реквестом: https://doka.guide/

Comments

[Дмитрий]

Помню на руби был подобный движок для гитхаба, делать какие нибудь книги справки

[Кирилл Никитин]

Pages. Просто в настройках репозитория ставится «сделать сайтом».

[RAX7]

Как устроен сайт
Сайт «Доки» работает на базе Eleventy. При помощи Nunjucks-темплейтов Eleventy превращает статьи в формате Markdown в HTML-страницы.
Проект собирается с помощью GitHub Actions и хостится на сервере, читайте подробнее про деплой.
https://github.com/doka-guide/platform#%D0%BA%D0%B...

[Ankhena]

Про деплой https://www.youtube.com/watch?v=hevU4NdIsoU&list=P...
Про Eleventy https://www.youtube.com/watch?v=DtTadxKrFMY

Answer 1

[Виталий Першин]

Видео от Вадима Макеева, одного из участников проекта Дока: https://www.youtube.com/watch?v=hevU4NdIsoU

Answer 2

[paran0id]

Можно задействовать https://www.netlify.com - там даже на бесплатном тарифе это работает.

Comments

[Егор Левченко]

К сожалению, нельзя назвать Netlify универсальным решением.

Как хранилище сайта с небольшой посещаемостью и без необходимости собирать большие анкеты и формы — хорошо.

Из минусов:
- часть серверов забанено по IP в России, часть на Украине, часть в других странах. На это влиять никак не получится. Периодически сайт будет просто недоступен у каких-нибудь провайдеров: пример Билайн, Ростелеком.
- если форм или посещений будет очень много, либо если (как в Доке) сайт будет собираться под каждый PR пользователя, а пользователей будет много, то вы быстро упрётесь в потолок по количеству сборок и придётся платить.

Answer 3

[Alex_mos]

Сайт «Доки» работает на базе Eleventy. При помощи Nunjucks-темплейтов Eleventy превращает статьи в формате Markdown в HTML-страницы.

Проект собирается с помощью GitHub Actions и хостится на сервере, читайте подробнее про деплой

У них вроде в репозиторий все расписано, если брать конкретно сайт doka.

Если нужно разместить сайт на GitHub то в интернете много информации по этому вопросу

Answer 4

[Сергей delphinpro]

Технически и самому сделать просто.
Пишется небольшой скрипт, который будет скачивать репозиторий и обновлять статьи.
На гитхабе может быть настроен хук, который буде дергать этот скрипт при определенных событиях в репе. Или вручную периодически его запускать. Или по крону.
Статьи могут заливаться в базу из полученных файлов репозитория, а может быть просто сделан markdown парсер, который будет на лету отображать страницы скаченного репо.

Answer 5

[Сергей Соколов]

github pages

1. создать репо с названием username.github.io, где username – точное имя вашего аккаунта или организации, в которой это репо
   
2. в нём создать index.html
   
3. запушить в основную ветку main
   
4. открыть https://username.github.io
   

Потом можно настроить и свой домен на этот сайт.

Единственная неприятность, если сайт требует билда скриптов и прочего, в итоге придётся коммитить и скомпилированные файлы.

Answer 6

[JRBRO]

Тоже искал в свое время как это сделать, в итоге выбрал netlify.

Но тут вы можете почитать

Answer 7

[Ярослав]

Хостить такие статические сайты можно на разных хостингах: github pages, gitlab pages (да, у них же хостите и гит-репозиторий и у них же сайт), netlify, cloudflare pages.

Общая схема: если хостинг там же, где и репозиторий, то обычно через CI/CD делается. Если снаружи (например, репозиторий на гитхабе, а хостинг на cloudflare), то при обновлении репозитория дергается хук и хостинг выкачивает новые странички себе.

Возможно вам будет интересно почитать про концепцию JAMstack, это как бы "старые" статические сайты (которые быстро загружаются из CDN, не рендерятся на сервере), как из 90-ых, но со всеми фичами из XXI века через javascript API. Вот авто-обновление контента на хостинге из репозитория - это часть JAMstack.