Вместо предисловия

Значит, товарищи, собрался я на выходных с силами и сообразил сабж. Всякие-разные блоги веду года с двадцатого, движков перепробовал уйму, — «Вордпресс», «Эгею», «Гост», — ничто не прижилось! Уж думал вообще плюнуть и блог закрыть, однако желание собирать из букв интересные слова и предложения оказалось сильнее. Причём настолько сильнее, что его хватило на разработку собственного движка!

Я всегда был и остаюсь приверженцем минимализма во всех сферах жизни. Сайт мне тоже свой хотелось облагородить и упростить — оставить на нём только всё самое необходимое, и чтобы красиво ещё было. И вот, обнаружив себя с пару дней назад за чтением RFC мне подумалось: «Чёрт возьми, как же хорошо эти документы оформлены!», после чего свету явилась Та Самая Гениальная Идея™.

За два дня очень и очень продуктивной работы мне удалось склепать MVP, благодаря чему теперь у нас есть, вероятно, один из самых минималистичных движков для блога. Он вышел настолько минималистичным, что вместо HTML предлагает всем читателям text/plain (и только его), благодаря чему посты читать можно не отходя от терминала. Нет, вы только вдумайтесь: никакого HTML, никакого CSS, никакого JavaScript! Пир духа!

Зачем

Что оно умеет

Прежде всего оно довольно умело справляется со своей основной задачей: рендерить посты из обычного плейнтекста в красиво оформленный плейнтекст. Посты благодаря этому можно читать плюс-минус везде, где есть интернет. Например, в терминале:

Или с экрана смартфона:

Поскольку движок возвращает честный плейнтекст без хоть какого-либо намёка на HTML, на экранах мобильных телефонов вёрстка текста бы поплыла, поэтому пришлось извращаться: сейчас я по юзерагенту отлавливаю таких пользователей и показываю им версию с правильной шириной абзаца.

Всякие-разные нюансы

Создание нового поста

Достаточно просто положить текстовый файл с расширением .txt в папку /weblog/, после чего движок самостоятельно добавит его в общую ленту постов. За неимением у движка базы данных все данные о посте подтягиваются из этой папки: название поста — название файла без расширения, дата публикации поста — дата создания или внесения изменений в файл.

Движок поддерживает категоризацию: чтобы поместить пост в какую-нибудь категорю, нужно просто создать для неё папку и положить туда файл с текстом поста. Например, если положить пост в папку /weblog/tech/, посту будет присвоена категория «Tech».

Если добавить к названию файла тильду, то его название в ленте постов будет заменено на астеризм (три звёздочки):

Ссылки к постам

Первые версии блога не отображали ссылки к постам, хотя такие наличествовали. Их нужно было угадывать исходя из названия поста. Это было так себе, поэтому в итоге добавил конфигурируемую опцию show_urls с возможными вариантами Full (полный URL), Short (укороченный вариант) и Off (не показывать вовсе).

Выглядит это дело следующим образом:

Отображается на главной, в постах по категориям и по датам. Если перейти по ссылке на конкретный пост, то его URL не будет включён в рендер, потому как он уже присутствует в адресной строке браузера.

Движок умеет отображать посты /по-ссылке-с-названием-поста/, по году, месяцу и дню (например, /2023/ или /2024/04/14/) и по категории (например, /tech/). Выглядит это вот так:

RSS

Здесь всё просто: по пути /rss/ движок генерирует валидный RSS. Если перейти по /rss/название-категории/, то движок сгенерирует ленту постов для выбранной категории. Удобно, если хочется не читать у автора все посты подряд, а подписаться только на то, что интересно.

sitemap.xml

Штука для всяких поисковых движков а-ля гугль. Генерирует XML, содержащий в себе полный перечень постов вкупе с датами их обновления. Таким образом поисковой движок сможет узнать, если автор опубликовал новый пост или изменил содержание уже ранее опубликованного.

Бонусные фичи

Поиск постов

Кажется, что если нет обёртки в виде HTML и JavaScript, то поиск никак не реализовать. Однако всё гениальное — просто, и в этом нам поможет сам браузер: поскольку на главной странице блога отображаются все посты, любой из них можно найти при помощи встроенного в браузер поиска.

Страница ошибки 404

Туда иногда приходит котик :-)

Название заметки.txt

Вместо слэша после названия заметки в её урле можно использовать .txt. Пример: https://renecoignard.com/weblog.txt вместо https://renecoignard.com/weblog/. С отображением постов по категориям тоже работает: https://renecoignard.com/meditations/.

Тёмная тема

Если, например, в «Хроме» включить тёмную тему, она волшебным образом автоматически применится и в блоге.

Вот такие пироги (с котятами). Пользуйтесь на здоровье!

Утащить себе исходники можно туть:

https://github.com/coignard/weblog