Tento blog je priečinok so súbormi markdown

Za týmto blogom nestojí žiadne CMS a ani žiadna databáza. Každý článok je markdownový súbor nahraný do rovnakého repozitára ako kód LiteTMS, takže publikovanie článku funguje presne ako nasadenie novej funkcie: commit a deploy.

Chceli sme to urobiť inak než väčšina firemných blogov, a tento článok vám ukáže celý mechanizmus vrátane zdrojového kódu stránky, ktorú práve čítate.

Riešenie, ktoré používajú všetci ostatní

Bežný firemný blog beží na plnohodnotnom redakčnom systéme (CMS). Databáza, administračný panel, používateľské účty, pluginy a šablóna, ktorá sa bráni akejkoľvek úprave. Celá táto mašinéria existuje len preto, aby redakčný tím mohol publikovať bez toho, aby musel prísť do kontaktu s kódom.

My redakčný tím nemáme a v repozitári s kódom trávime celý deň. Celú túto mašinériu sme preto vynechali. Každý systém navyše znamená ďalšie miesto, ktoré treba záplatovať, zálohovať a zabezpečovať. Priečinok s textovými súbormi nič také nevyžaduje.

Ako vyzerá súbor s článkom

Tu je skrátená hlavička priamo tohto článku, za ktorou nasleduje štruktúra samotného textu:

---
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.

Blok na začiatku je jednoduchý zoznam kľúčov a hodnôt. Pod ním sa nachádza bežný markdown, ktorý spracováva štandardná knižnica na vykresľovanie markdownu. Jeden súbor pre každý jazyk: tento článok existuje ako súbor .en.md a súbor .pl.md s rovnakým názvom, pričom poľská verzia je napísaná priamo, bez strojového prekladu.

Sekcia ## FAQ na konci ukážky je reálna konvencia, nie len dekorácia. Každá otázka je formulovaná tak, ako by ju človek zadal do vyhľadávača, a zostavovací proces (build) tieto dvojice premení na štruktúrované dáta, ktoré vyhľadávače dokážu zobraziť ako rozšírené výsledky. Živý príklad nájdete v spodnej časti tejto stránky.

Validátor namiesto redaktora

Predtým, než sa čokoľvek nasadí, zostavovací skript prečíta každý súbor s článkom a skontroluje ho voči schéme. Popis musí mať rozsah od 80 do 170 znakov. Kategória musí byť jednou z piatich povolených hodnôt. Dátum musí byť platným kalendárnym dňom a slug musí zodpovedať názvu súboru.

Skript následne vygeneruje jediný indexový súbor s metadátami všetkých článkov a web číta výhradne tento súbor. Vygenerovanie stránky so zoznamom článkov tak trvá rovnako pri piatich stovkách článkov ako pri piatich.

Rovnaký skript beží v CI pri každom pushi. Ak je článok neplatný alebo niekto zabudol pregenerovať index, zostavenie zlyhá a nič sa nenasadí. Pokazený obsah sa do produkcie nedostane, pretože do produkcie neprejde nič, čo neschválil validátor.

Prečo vlastne markdown

Markdown zvíťazil z čisto praktických dôvodov. Markdownový súbor sa dá čítať v akomkoľvek textovom editore, so špeciálnymi nástrojmi aj bez nich. Porovnanie zmien (diff) funguje po riadkoch, takže článok prechádza kontrolou presne ako kód: presne vidíte, ktorá veta sa zmenila. Zároveň je to pre AI asistentov ten najúspornejší formát na spracovanie, čo má s každým mesiacom o niečo väčší význam.

Posledný bod je dôvodom, prečo sa tu každý článok poskytuje tromi spôsobmi. Stránka, ktorú práve čítate, je verzia v HTML. Pridajte k adrese v prehliadači .md a získate čistý zdrojový súbor, bajt po bajte tak, ako bol commitnutý, zobrazený ako čistý markdown. A každý jazyk má vlastný RSS kanál pre čítačky a agregátory.

Na adrese /blog/index.md sa navyše nachádza strojovo čitateľný katalóg všetkých publikovaných článkov a súbor llms.txt naň priamo navádza AI roboty. Nič z toho sa pritom nezobrazuje ako duplicitný obsah, pretože čisté súbory obsahujú hlavičku noindex a kanonický odkaz späť na HTML stránku.

Čo z toho máte vy ako čitateľ

Nič z tohto nie je funkcia samotného produktu. Ide o rozhodnutie o tom, ako pristupujeme k vlastnému publikovaniu, a nadväzuje na sľub z prvého článku: žiadne vymyslené čísla a text, ktorý si môžete overiť priamo v zdroji. Samotný TMS systém staviame na rovnakej preferencii jednoduchých a overiteľných postupov. Ak sa chcete pozrieť, ako funguje, registrácia je bezplatná.