Šis tinklaraštis yra tiesiog „Markdown“ failų aplankas

Už šio tinklaraščio nėra jokios TVS ir jokios duomenų bazės. Kiekvienas įrašas yra „markdown“ failas, įtrauktas į tą pačią kodo saugyklą kaip ir „LiteTMS“, todėl įrašo publikavimas veikia lygiai taip pat, kaip naujos funkcijos išleidimas: kodo patvirtinimas ir diegimas.

Norėjome viską padaryti kitaip nei daugumoje įmonių tinklaraščių, todėl šiame įraše parodysime visą mechanizmą, įskaitant paties puslapio, kurį dabar skaitote, išeities kodą.

Sąranka, kurią naudoja visi kiti

Įprastas įmonės tinklaraštis veikia visapusiškoje turinio valdymo sistemoje. Duomenų bazė, administratoriaus pultas, naudotojų paskyros, įskiepiai ir dizaino tema, kuri priešinasi vos prie jos prisilietus. Visa ši mašinerija egzistuoja tam, kad redaktorių komanda galėtų publikuoti tekstus net nesiartindama prie kodo.

Mes neturime redaktorių komandos ir visą dieną praleidžiame kodo saugykloje. Todėl šios mašinerijos atsisakėme. Kiekviena papildoma sistema reikalauja atnaujinimų, atsarginių kopijų ir saugumo priežiūros. Tekstinių failų aplankui viso to nereikia.

Kaip atrodo įrašo failas

Štai sutrumpinta paties šio įrašo antraštinės dalies kopija ir po jos einanti pagrindinės dalies struktūra:

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

Viršuje esantis blokas yra paprastas raktų ir reikšmių porų sąrašas. Po juo pateikiamas įprastas „markdown“ tekstas, kurį atvaizduoja standartinė „markdown“ biblioteka. Kiekvienai kalbai skiriamas atskiras failas: šis įrašas egzistuoja kaip .en.md failas ir to paties pavadinimo .pl.md failas, o lenkiškoji versija parašyta natūraliai, be mašininio vertimo.

Pavyzdžio pabaigoje esanti ## FAQ skiltis yra tikras susitarimas, o ne dekoracija. Kiekvienas klausimas suformuluotas taip, kaip žmogus jį įvestų į paieškos laukelį, o kūrimo procesas šias poras paverčia struktūrizuotais duomenimis, kuriuos paieškos sistemos gali rodyti kaip išplėstinius rezultatus (angl. rich results). Veikiantį pavyzdį rasite šio puslapio apačioje.

Tikrintuvas vietoje redaktoriaus

Prieš ką nors išleidžiant, kūrimo scenarijus perskaito kiekvieną įrašo failą ir patikrina jį pagal schemą. Aprašas privalo tilpti tarp 80 ir 170 simbolių. Kategorija turi būti viena iš penkių leistinų reikšmių. Data privalo būti reali kalendorinė data, o identifikatorius turi atitikti failo pavadinimą.

Tada scenarijus sugeneruoja vieną indeksavimo failą su visų įrašų metaduomenimis, o svetainė nuskaito tik šį failą. Sąrašo puslapio generavimas kainuoja tiek pat, nepriklausomai nuo to, ar įrašų yra penki, ar penki šimtai.

Tas pats scenarijus vykdomas CI aplinkoje per kiekvieną kodo išsiuntimą. Jei įrašas yra netinkamas arba kas nors pamiršo iš naujo sugeneruoti indeksą, kūrimo procesas nutrūksta ir niekas nėra diegiama. Sugadintas turinys negali pasiekti gamybinės aplinkos, nes į ją niekada nepatenka niekas, ko nepatvirtino tikrintuvas.

Kodėl būtent „markdown“, jei atvirai

„Markdown“ formatas nugalėjo dėl visiškai paprastų priežasčių. „Markdown“ failą galima skaityti bet kurioje teksto rengyklėje, su specialiomis priemonėmis ar be jų. Skirtumai lyginami eilutė po eilutės, todėl įrašas peržiūrimas lygiai taip pat, kaip ir kodas: aiškiai matote, kuris sakinys pasikeitė. Be to, tai pats ekonomiškiausias formatas dirbtinio intelekto asistentams apdoroti, o tai kas mėnesį tampa vis svarbiau.

Būtent dėl šios priežasties kiekvienas įrašas čia pateikiamas trimis būdais. Puslapis, kurį dabar skaitote, yra HTML versija. Pridėkite .md prie adreso naršyklėje ir gausite grynąjį išeities failą, baitas į baitą tokį, koks buvo įkeltas, pateiktą kaip grynąjį „markdown“. Kiekviena kalba taip pat turi savo RSS srautą skaitytojams ir agregatoriams.

Adresu /blog/index.md taip pat yra mašininiu būdu nuskaitomas visų paskelbtų įrašų katalogas, o svetainės failas llms.txt nukreipia DI naršykles tiesiai į jį. Niekas iš to niekada netampa dubliuotu turiniu, nes pirminiai failai turi „noindex“ antraštę ir kanoninę nuorodą atgal į HTML puslapį.

Ką tai suteikia jums kaip skaitytojui

Nė vienas iš šių dalykų nėra produkto funkcija. Tai sprendimas, kaip organizuojame savo leidybą, ir jis atitinka pirmajame įraše duotą pažadą: jokių išgalvotų skaičių ir tekstas, kurį galite patikrinti pirminiame šaltinyje. Pati TMS sistema sukurta remiantis tuo pačiu principu, teikiant pirmenybę paprastai ir patikrinamai mechanikai. Jei norite apsižvalgyti, registracija yra nemokama.

DUK

Ar galiu skaityti „LiteTMS“ tinklaraščio įrašą kaip grynąjį „markdown“?

Taip. Prie bet kurio įrašo adreso pridėkite .md, ir svetainė nukreips jus į grynąjį išeities failą, pateikiamą kaip grynąjį „markdown“. Visas publikuotų įrašų katalogas pasiekiamas adresu /blog/index.md.

Kodėl „LiteTMS“ tinklaraštis nenaudoja TVS?

Nes TVS būtų antra sistema, kurią reikėtų atnaujinti ir saugoti, o vieninteliai čia publikuojantys žmonės jau ir taip dirba produkto kodo saugykloje. „Markdown“ failai su CI tikrintuvu atlieka tą patį darbą, reikalaudami gerokai mažiau priežiūros.

Ar rašymas DI asistentams neblogina įrašų kokybės žmonėms?

Ne. Struktūra, kurią vertina asistentai, tai yra aiški pirmoji pastraipa, apibūdinančios antraštės ir konkretūs klausimai su trumpais atsakymais, yra ta pati struktūra, kuri padeda lengvai peržvelgti straipsnį akimis. Grynasis „markdown“ yra atskiras formatas, todėl jūsų skaitomas straipsnis išlieka įprastas straipsnis.