Ky blog është një dosje me skedarë markdown

Nuk ka asnjë CMS pas këtij blogu dhe asnjë bazë të dhënash. Çdo artikull është një skedar markdown i ruajtur në të njëjtin depo kodi me kodin e LiteTMS, prandaj publikimi i një artikulli funksionon saktësisht si hedhja e një funksioni të ri: një commit dhe një deploy.

Donim ta bënim këtë ndryshe nga shumica e blogjeve të kompanive, dhe ky artikull ju tregon të gjithë mekanizmin, përfshirë kodin burimor të vetë faqes që po lexoni.

Struktura që përdorin të gjithë të tjerët

Një blog tipik kompanie funksionon me një sistem të plotë të menaxhimit të përmbajtjes. Një bazë të dhënash, një panel administrimi, llogari përdoruesish, shtojca dhe një temë vizuale që shkakton probleme sa herë e prekni. E gjithë kjo makineri ekziston që një ekip redaktorësh të mund të publikojë pa iu afruar kodit.

Ne nuk kemi një ekip redaktorësh dhe e kalojmë gjithë ditën në depon e kodit. Kështu që e anashkaluam këtë makineri. Çdo sistem shtesë kërkon përditësime, kopje rezervë dhe masa sigurie. Një dosje me skedarë teksti nuk kërkon asgjë nga këto.

Si duket skedari i një artikulli

Ja një kopje e shkurtuar e kreut të vetë këtij artikulli, e ndjekur nga struktura e përmbajtjes:

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

Blloku në krye është një listë e thjeshtë çiftesh çelës dhe vlerë. Nën të qëndron markdown i zakonshëm, i shfaqur nga një bibliotekë standarde markdown. Një skedar për çdo gjuhë: ky artikull ekziston si një skedar .en.md dhe një skedar .pl.md me të njëjtin emër, dhe versioni polak është shkruar drejtpërdrejt në mënyrë origjinale dhe jo me përkthim automatik.

Seksioni ## FAQ në fund të shembullit është një rregull i mirëfilltë, jo thjesht dekor. Çdo pyetje është e llojit që dikush do ta shkruante në një fushë kërkimi, dhe procesi i ndërtimit i kthen këto çifte në të dhëna të strukturuara që motorët e kërkimit mund t'i shfaqin si rezultate të pasura. Në fund të kësaj faqeje gjendet një shembull i drejtpërdrejtë.

Një mekanizëm vlerësimi në vend të një redaktori

Përpara se të publikohet ndonjë gjë, një skript ndërtimi lexon çdo skedar artikulli dhe e kontrollon atë sipas skemës përkatëse. Përshkrimi duhet të ketë midis 80 dhe 170 karaktere. Kategoria duhet të jetë një nga pesë vlerat e lejuara. Data duhet të jetë një datë e vërtetë kalendarike dhe slug-u duhet të përputhet me emrin e skedarit.

Më pas, skripti krijon një skedar të vetëm indeksi me metadata-t e çdo artikulli, dhe faqja lexon vetëm atë skedar. Një faqe listimi kushton njëlloj si me pesëqind artikuj, ashtu edhe me pesë.

I njëjti skript ekzekutohet në CI gjatë çdo push-i. Nëse një artikull nuk është i vlefshëm, ose dikush ka harruar të rigjenerojë indeksin, ndërtimi dështon dhe asgjë nuk hidhet në prodhim. Përmbajtja me gabime nuk mund të arrijë në mjedisin e prodhimit, sepse ky i fundit nuk pranon kurrë asgjë që nuk është miratuar nga validatori.

Pse markdown, sinqerisht

Markdown fitoi për arsye krejt praktike. Një skedar markdown mund të lexohet në çdo redaktues teksti, me ose pa vegla të posaçme. Ai mund të krahasohet rresht për rresht, kështu që një artikull shqyrtohet njëlloj si kodi: shihni saktësisht se cila fjali ka ndryshuar. Dhe është formati më ekonomik i mundshëm për t'u përpunuar nga një asistent i inteligjencës artificiale, gjë që po bëhet gjithnjë e më e rëndësishme çdo muaj.

Kjo pikë e fundit është arsyeja pse çdo artikull këtu ofrohet në tri mënyra. Faqja që po lexoni është versioni HTML. Shtoni .md në adresën e shfletuesit tuaj dhe do të merrni skedarin burimor të papërpunuar, bajt për bajt ashtu siç është ruajtur, të shërbyer si tekst i thjeshtë markdown. Gjithashtu, çdo gjuhë ka kanalin e vet RSS për lexuesit dhe agregatorët.

Ekziston gjithashtu një katalog i lexueshëm nga makina për çdo artikull të publikuar në /blog/index.md, dhe skedari llms.txt i faqes i drejton robotët kërkues të inteligjencës artificiale drejt e atje. Asgjë nga këto nuk shfaqet kurrë si përmbajtje e dyfishtë, sepse skedarët e papërpunuar përmbajnë një krye noindex dhe një lidhje kanonike që kthen te faqja HTML.

Çfarë përfitoni ju si lexues

Asgjë këtu nuk është një funksion produkti. Është një vendim rreth mënyrës se si ne menaxhojmë botimet tona dhe përputhet me premtimin nga artikulli i parë: pa shifra të trilluara dhe me tekst që mund ta verifikoni te burimi. Vetë TMS-ja është ndërtuar mbi të njëjtën preferencë për mekanizma të thjeshtë dhe të verifikueshëm. Nëse dëshironi ta provoni, regjistrimi është falas.