Dan il-blogg huwa fowlder ta' fajls markdown

M'hemm l-ebda CMS wara dan il-blogg u l-ebda bażi tad-dejta lanqas. Kull artiklu huwa fajl markdown ikkommitjat fl-istess repożitorju tal-kodiċi ta' LiteTMS, u għalhekk il-pubblikazzjoni ta' artiklu taħdem eżattament bħall-ħruġ ta' karatteristika ġdida: commit u deploy.

Ridna nagħmlu dan b'mod differenti mill-biċċa l-kbira tal-blogs tal-kumpaniji, u dan l-artiklu jurik il-mekkaniżmu kollu, inkluż is-sors tal-paġna stess li qed taqra bħalissa.

Is-sistema li juża kulħadd

Blogg tipiku ta' kumpanija jaħdem fuq sistema sħiħa ta' ġestjoni tal-kontenut (CMS). Bażi tad-dejta, pannell tal-amministrazzjoni, kontijiet tal-utenti, plugins, u tema li toħloqlok problemi kull meta tmissha. Dak il-makkinarju kollu jeżisti sabiex tim ta' edituri jkun jista' jippubblika mingħajr ma jersaq qrib il-kodiċi.

Aħna m'għandniex tim ta' edituri, u diġà nqattgħu l-ġurnata kollha f'repożitorju tal-kodiċi. Għalhekk qbiżna dak il-makkinarju kollu. Kull sistema addizzjonali tfisser xi ħaġa li trid taġġornaha b'irqajja' tas-sigurtà (patches), tagħmlilha backup, u tħarisha. Fowlder ta' fajls tat-test ma jeħtieġx dan.

Kif jidher fajl ta' artiklu

Hawnhekk għandek verżjoni mqassra tal-intestatura ta' dan l-artiklu stess, segwita mill-istruttura tal-kontenut:

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

Il-blokka fin-naħa ta' fuq hija lista sempliċi ta' pari ta' ċwievet u valuri. Taħtha hemm markdown ordinarju, ipproċessat minn librerija standard tal-markdown. Fajl wieħed għal kull lingwa: dan l-artiklu jeżisti bħala fajl .en.md u fajl .pl.md bl-istess isem, u l-verżjoni bil-Pollakk hija miktuba direttament minn persuna minflok ma ġiet tradotta b'mod awtomatiku.

It-taqsima ## FAQ fl-aħħar tal-kampjun hija l-konvenzjoni reali, mhux sempliċi tiżjin. Kull mistoqsija hija tat-tip li wieħed ifittex f'magna tat-tiftix, u l-proċess tal-build jibdel dawk il-pari f'dejta strutturata li l-magni tat-tiftix jistgħu juru bħala riżultati arrikkiti (rich results). Hemm eżempju dirett fil-qiegħ ta' din il-paġna.

Validatur minflok editur

Qabel ma jiġi ppubblikat xi ħaġa, skript tal-build jaqra kull fajl ta' artiklu u jivverifikah mal-iskema. Id-deskrizzjoni trid tkun bejn 80 u 170 karattru. Il-kategorija trid tkun waħda minn ħames valuri permessi. Id-data trid tkun data reali tal-kalendarju, u l-islug irid jaqbel mal-isem tal-fajl.

Imbagħad, l-iskript jikteb fajl ta' indiċi uniku bil-metadejta ta' kull artiklu, u s-sit jaqra biss dak il-fajl. Paġna ta' lista ta' artikli tieħu l-istess riżorsi b'ħames mitt artiklu daqs kemm tieħu b'ħamsa.

L-istess skript jaħdem fis-sistema tas-CI ma' kull push. Jekk artiklu ma jkunx validu, jew xi ħadd jinsa jiġġenera mill-ġdid l-indiċi, il-build tfalli u ma jiddeplojja xejn. Kontenut bi żbalji ma jistax jasal fl-ambjent ta' produzzjoni, għax il-produzzjoni qatt ma tirċievi xi ħaġa li l-validatur ma approvax.

Għaliex markdown, onestament

Il-markdown intgħażel għal raġunijiet prattiċi ħafna. Fajl markdown jista' jinqara f'kull editur tat-test, bl-għodod jew mingħajrhom. Huwa jqabbel id-differenzi (diff) linja b'linja, u b'hekk artiklu jiġi rivedut bl-istess mod bħall-kodiċi: tara eżattament liema sentenza nbidlet. Barra minn hekk, huwa l-aktar format effiċjenti biex jinqara minn assistenti tal-IA, fattur li qed isir dejjem aktar importanti ma' kull xahar li jgħaddi.

Dik l-aħħar raġuni hija għaliex kull artiklu hawnhekk huwa disponibbli fi tliet forom. Il-paġna li qed taqra hija l-verżjoni HTML. Żid .md mal-indirizz fil-brawżer tiegħek u tirċievi l-fajl tas-sors oriġinali, byte b'byte kif ġie kkommitjat, ipprovdut bħala markdown sempliċi. U kull lingwa għandha l-RSS feed tagħha għall-qarrejja u l-aggregaturi.

Hemm ukoll katalgu li jista' jinqara mill-magni ta' kull artiklu ppubblikat fuq /blog/index.md, u l-fajl llms.txt tas-sit jidderieġi l-crawlers tal-IA direttament lejh. Xejn minn dan ma jidher bħala kontenut doppju, għaliex il-fajls oriġinali jinkludu intestatura noindex u link kanonika lura lejn il-paġna HTML.

X'joffrilek dan bħala qarrej

Xejn minn dan mhuwiex funzjoni tal-prodott. Hija deċiżjoni dwar kif nittrattaw il-pubblikazzjoni tagħna stess, u taqbel mal-wegħda mill-ewwel artiklu: l-ebda numru ivvintat, u test li tista' tivverifikah direttament mis-sors. It-TMS stess huwa mibni fuq l-istess preferenza għal mekkaniżmi sempliċi u trasparenti li jistgħu jiġu spezzjonati. Jekk tixtieq tagħti ħarsa, ir-reġistrazzjoni hija b'xejn.