jekyll-guide

Что это?

Пример использования github'овского генератора статических сайтов Jekyll.

И что в конечном итоге я получу?

Например такой результат:

• jekyll-guide
• gitmoji
• react
• jekyll
• electron
• ratchet
• неподъёмная куча других проектов 😏

А почему бы мне это всё не запилить на HTML+CSS+JS?

Конечно же можно это всё ручками запилить и в большинстве случаев это придётся сделать. Но в еще большем количестве случаев достаточно донести информацию в чуть более симпатичной форме.

Для этого и нужен Jekyll - достаточно выбрать подходящую тему (можно и свою запилить), сделать репу на github.com*, настроить её и фигачить Markdown, не заморачиваясь над внешним видом.

* Jekyll можно использовать и без гитхаба - на локалке пройтись им по пачке Markdown, получить на выходе пачку обычных HTML+CSS+JS файлов и залить их куда надо.

Как это сделать?

Самый простой сценарий:

1. Пишем обычный Markdown в файл README.md (можно прям через github)
2. Заходим в настройки репозитория
3. Пролистываем до раздела GitHub Pages
4. В выпадашке Source выбираем ветку master branch и нажимаем Save

• Выбираем тему в следующей выпадашке, если нужно

5. Обновляем страницу до тех пор, пока не увидите надпись Your site is published at ... в шапке раздела GitHub Pages
6. Переходим на страничку, сгенеренную в разделе 5.
7. 😎

Где взять больше инфы?

• Гайд по настройке и использованию GiHub Pages
• Читшит по Markdown
• Инфа по Jekyll