Цей блог - просто папка з файлами markdown

У цього блогу немає CMS і немає бази даних. Кожен допис - це markdown-файл, зафіксований у тому ж репозиторії, де зберігається код LiteTMS, тому публікація допису працює так само, як випуск нової функції: коміт і деплой.

Ми хотіли зробити це інакше, ніж у більшості корпоративних блогів, і ця публікація демонструє весь механізм, включно з вихідним кодом сторінки, яку ви зараз читаєте.

Структура, якою користуються всі інші

Типовий корпоративний блог працює на повноцінній системі керування вмістом (CMS). База даних, панель адміністратора, облікові записи користувачів, плагіни та тема оформлення, яка пручається кожному налаштуванню. Увесь цей механізм існує лише для того, щоб команда редакторів могла публікувати матеріали, не торкаючись коду.

У нас немає редакції, і ми й так проводимо весь робочий день у репозиторії коду. Тому ми відмовилися від цієї надбудови. Кожна додаткова система потребує оновлень, резервного копіювання та захисту. З папкою текстових файлів цього робити не потрібно.

Як виглядає файл допису

Ось скорочена копія заголовка саме цього допису, за якою наведено структуру його тексту:

---
title: This blog is a folder of markdown files
slug: why-this-blog-has-no-cms
locale: en
description: There is no CMS behind the LiteTMS blog. Every post is...
date: 2026-07-15
category: technology
tags: markdown, blog, aieo, engineering
draft: false
---

The first paragraph answers the title on its own, because that is
the part search snippets and AI assistants quote.

## A section heading

Plain markdown body. Nothing exotic.

## FAQ

### Does this sample show the FAQ convention?

Yes. Each ### line is a literal question, answered right below it.

Блок угорі - це простий список пар ключів і значень. Нижче розміщено звичайний markdown, який рендериться стандартною бібліотекою markdown. Один файл на кожну мову: цей допис існує як файл .en.md та файл .pl.md з однаковою назвою, причому польська версія написана носієм мови з нуля, а не перекладена машинно.

Розділ ## FAQ наприкінці зразка - це дійсний стандарт, а не прикраса. Кожне запитання сформульовано так, як людина ввела б його в пошуковий рядок, а процес збирання перетворює ці пари на структуровані дані, які пошукові системи можуть показувати як розширені результати. Живий приклад наведено внизу цієї сторінки.

Валідатор замість редактора

Перш ніж щось потрапить у реліз, скрипт збирання зчитує кожен файл допису та перевіряє його на відповідність схемі. Опис має містити від 80 до 170 символів. Категорія має бути однією з п'яти дозволених. Дата має бути реальною календарною датою, а slug повинен збігатися з назвою файлу.

Потім скрипт записує єдиний індексний файл із метаданими кожного допису, і сайт читає лише цей файл. Сторінка зі списком матеріалів вимагає однакових ресурсів незалежно від того, скільки там дописів: п'ять чи п'ятсот.

Цей же скрипт запускається в CI під час кожного push. Якщо допис містить помилку або хтось забув оновити індекс, збирання завершується збоєм, і нічого не деплоїться. Некоректний вміст не може потрапити в продакшн, оскільки в продакшн ніколи не потрапляє те, що не пройшло перевірку валідатором.

Чому саме markdown, якщо чесно

Markdown переміг із цілком практичних міркувань. Файл markdown можна прочитати в будь-якому текстовому редакторі, з додатковими інструментами чи без них. Зміни в ньому відстежуються рядок за рядком через diff, тому допис рецензується так само, як і програмний код: чітко видно, яке саме речення було змінено. До того ж це найдешевший за ресурсами формат для опрацювання ШІ-асистентами, що стає дедалі важливішим щомісяця.

Саме через останній пункт кожен допис тут надається у трьох варіантах. Сторінка, яку ви читаєте, - це HTML-версія. Додайте .md до адреси в браузері, і ви отримаєте необроблений вихідний файл, байт у байт такий, як у коміті, що віддається у форматі звичайного markdown. Крім того, кожна мова має власний RSS-фід для читачів та агрегаторів.

Також доступний машиночитний каталог усіх опублікованих дописів за посиланням /blog/index.md, і файл llms.txt на сайті спрямовує ШІ-краулери безпосередньо до нього. Усе це ніколи не відображається як дубльований контент, оскільки необроблені файли містять заголовок noindex і канонічне посилання назад на HTML-сторінку.

Що це дає вам як читачеві

Ніщо з описаного не є функцією продукту. Це рішення про те, як ми організовуємо власні публікації, і воно відповідає обіцянці з першого допису: жодних вигаданих цифр і текст, першоджерело якого завжди можна перевірити. Сама TMS побудована на тому ж принципі простих і прозорих механізмів. Якщо ви хочете протестувати систему, реєстрація безкоштовна.