Этот блог построен с помощью системы Jekyll, которая способна генерировать страницы формата HTML из других форматов, в частности из Markdown. Более того, процесс генерации, как и само размещение сайта, происходит на серверах GitHub в рамках проекта GitHub Pages. О том, как пользоваться всем этим и пойдёт дальше речь.
Эту заметку стоит воспринимать как “шпаргалку”, а не как руководство по использованию.
Git и GitHub
Git - популярная в наше вемя система контроля версий, получившая популярность с развитием ОС из семейства линуксов. Как и всё, рождённое в среде Linux, git обладает командным интерфейсом.
Все изменения исходных текстов хранятся в виде кусочков данных, называемых “коммитами” (eng. ‘commit’). Для создания коммита и сохранения изменений в истории нужно выполнить следующее в консоли:
cd /d "D:\GitHub\makarnat73.github.io"
git commit -am "Название коммита"
Названия могут быть любыми, но лучше выдерживать баланс между краткостью и осмысленностью. Например
добавлен пост о погоде в Японии или исправлены опечатки в посте за 3 авг 2018 выглядят
прилично.
Все файлы проекта (этого сайта) вместе с их историей называются репозиторием и дублируются в облако. GitHub - один из облачных сервисов, который позволяет это делать, а также предоставляет графический интерфейс для работы с репозиторием в виде десктопного приложения. В нём процесс создания аналогичен.
Чтобы отправить новые коммиты в облако можно выполнить в консоли git push, или нажать в
приложении кнопку Push origin.
Jekyll admin
Есть много способов обновлять информацию на сайте и создавать новые посты. Самый простой - открыть
каталог проекта и начать изменять содержимое файлов. К примеру, все посты содержатся в поддиректории
posts/ и могут редактироваться прямо там. Например, этот пост содержится в файле
/posts/2018-08-04-getting-started.md.
Как и все остальные файлы, его название строго соответствует шаблону:
год-месяц-день-название-через-дефисы.md.
Возможно, проще редактировать страницы и иметь возможность быстро посмотреть, как они выглядят. Для
этого можно запустить локальный web-сервер с Jekyll, и редактировать страницы в Jekyll Admin page.
Команда для консоли (из каталога проекта): bundle exec jekyll serve. Аналогичный скрипт лежит на
рабочем столе. Завершается работа сервера комбинацией клавиш Ctrl+C в открывшемся терминале, и
двухкратным ответом y.
Пока сервер работает, сайт доступен локально по адресу http://localhost:4000/, а консоль Jekyll Admin по адресу http://localhost:4000/admin/
MarkDown
При работе из Jekyll Admin все основные для MD возможности доступны из графического интерфейса. Одноко вот краткий перечень возможностей MD:
Часть одного
и того же
абзаца.
Новый абзац через пустую строку.
*курсив* **жирный** ***жирный курсив***
_курсив_ __жирный__ ___жирный курсив___
- элемент списка 1
- элемент списка 2
- элемент списка 3
Превращается в:
Часть одного и того же абзаца.
Новый абзац через пустую строку.
курсив жирный жирный курсив
курсив жирный жирный курсив
- элемент списка 1
- элемент списка 2
- элемент списка 3
(конец)