А вот решили вы, например, что для каких-нибудь нужд вам вполне будет достаточно простенького сервера на базе Ubuntu Server. Поставили вы его. Дождались консоли. Установили необходимое ПО. И в какой-то момент решили почитать инструкцию на русском языке, которая хранится тут же в обычном текстовом файле. Отправили команду

cat very-important-manual-ru.txt | more

на выполнение и… получили кракозябры. В подмышках начинают шевелиться волосы. В памяти появляются вспышки, возвращающие вас лет на 15 назад: борьба с кодировками… KOI8-R… CP1251… Отчаяние начинает проникать в вашу душу.

Но! Не всё так страшно. Неприятность эта лечится и довольно просто.

В предыдущих статьях (1, 2) мы установили Jekyll локально и настроили его автозапуск в качестве демона. Всё замечательно работает (по крайней мере, у меня ;)), однако хочется большего: например не вспоминать всякий раз на каком порту он висит, а просто обращаться к серверу по имени и чтоб он возвращал нам наш блог. Ну вот как-то так

Давайте сразу договоримся о начальных данных:

1. Имеем виртуальную (в моём случае) или отдельную машину (web-server) с установленным на ней Jekyll. В принципе и наличие одной машины подойдёт. Тут важна концепция, а не детали.
2. 10 минут свободного времени.
3. Желание.

А больше ничего и не потребуется ;).

Начнём.

Это просто!

1. Необходимо создать файл /lib/systemd/system/jekyll.service

   sudo nano /lib/systemd/system/jekyll.service
   

   Содержимое файла:

   [Unit]
   Description=Jekyll Daemon
   After=syslog.target network.target
   
   [Service]
   Type=simple
   Restart=always
   StandardOutput=syslog
   StandardError=syslog
   SyslogIdentifier=jekyll
   ExecStart=/usr/local/bin/jekyll serve --source /www/jekyll/src --destination /www/jekyll/dst --host 0.0.0.0
   

   Замените --source и --destination на свои пути. В папке --source должны лежать исходники сайта. В --destination будет сложен результат компиляции.

2. Необходимо активировать наш новый сервис

   sudo systemctl enable jekyll
   

3. …и можно запускать

   sudo service jekyll start
   

Ну и напоследок: если интересно следить за тем, как там Jekyll ворочает файлами, то сделать это можно заглянув в syslog

cat /var/log/syslog | grep jekyll | tail

Ну или с автообновлением:

watch 'cat /var/log/syslog | grep jekyll | tail'

Это хорошая идея установить Jekyll локально на своей машине/сервере и проверять правильность оформления статей/постов (да и всего сайта целиком) перед публикацией их на всеобщее обозрение.

Обратимся к Wikipedia для начала:

Atom — общее название двух связанных веб-технологий: формата для описания ресурсов на веб-сайтах и протокола для их публикации.

Формат Atom основан на XML и позволяет описывать наборы веб-ресурсов — например, новостные ленты, анонсы статей в блоге и тому подобное. Он решает те же задачи, что RSS, но возник позже и учёл многие его недостатки. Формат описан в RFC 4287 и сейчас активно поддерживается компанией Google во многих её проектах.

Итак, Atom это тот же RSS только немного другой :). Нас сейчас не интересует протокол публикации Atom. Мы сосредоточимся на формате выдачи новостной ленты Atom.