--- title: Questo blog è una cartella di file markdown slug: why-this-blog-has-no-cms locale: it description: Nessun CMS per il blog LiteTMS. Ogni post è un file Markdown nel repository, validato in CI e distribuito come HTML, Markdown puro e feed RSS. date: 2026-07-15 updated: 2026-07-15 category: technology tags: markdown, blog, aieo, engineering author: LiteTMS Team draft: false --- Dietro questo blog non c'è alcun CMS e nemmeno un database. Ogni articolo è un file Markdown salvato nello stesso repository del codice di LiteTMS, quindi pubblicare un post funziona esattamente come il rilascio di una funzionalità: un commit e un deploy. Volevamo fare le cose diversamente rispetto alla maggior parte dei blog aziendali, e questo articolo vi mostra l'intero meccanismo, compreso il codice sorgente della pagina stessa che state leggendo. ## La configurazione usata da tutti gli altri Il tipico blog aziendale si basa su un intero Content Management System: un database, un pannello di amministrazione, account utente, plugin e un tema che crea problemi a ogni modifica. Tutta questa infrastruttura esiste affinché un team editoriale possa pubblicare senza avvicinarsi al codice. Noi non abbiamo una redazione e trascorriamo già l'intera giornata in un repository di codice. Abbiamo quindi evitato questa complessità. Ogni sistema in più richiede patch, backup e sicurezza. Una cartella di file di testo no. ## Com'è fatto il file di un articolo Ecco una versione ridotta dell'intestazione di questo stesso post, seguita dalla struttura del corpo del testo: ```markdown --- 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 blocco iniziale è un elenco lineare di coppie chiave-valore. Al di sotto si trova del semplice Markdown, renderizzato da una libreria standard. Viene utilizzato un file per ciascuna lingua: questo post esiste come file `.en.md` e come file `.pl.md` con lo stesso nome, e la versione polacca è scritta direttamente nella lingua di destinazione anziché tradotta automaticamente. La sezione `## FAQ` alla fine dell'esempio è una convenzione vera e propria, non una decorazione. Ciascuna domanda è formulata come quella che una persona inserirebbe in un motore di ricerca, e la procedura di build converte queste coppie in dati strutturati che i motori di ricerca possono mostrare come risultati avanzati. In fondo a questa pagina troverete un esempio reale. ## Un validatore al posto di un editor Prima di qualsiasi rilascio, uno script di compilazione legge ogni file di articolo e ne verifica la conformità allo schema. La descrizione deve essere compresa tra 80 e 170 caratteri. La categoria deve rientrare tra i cinque valori ammessi. La data deve essere una data di calendario valida e lo slug deve corrispondere al nome del file. Lo script scrive quindi un unico file indice con i metadati di ciascun post, e il sito legge solo quel file. Una pagina di elenco richiede le stesse risorse con cinquecento articoli come con cinque. Lo stesso script viene eseguito nella CI a ogni push. Se un post non è valido o qualcuno ha dimenticato di rigenerare l'indice, la compilazione fallisce e non viene rilasciato nulla. I contenuti non validi non possono arrivare in produzione, perché la produzione non riceve mai nulla che non sia stato approvato dal validatore. ## Perché il Markdown, in tutta onestà Il Markdown ha prevalso per ragioni molto pratiche. Un file Markdown è leggibile con qualsiasi editor di testo, con o senza strumenti dedicati. Si confronta riga per riga, quindi un articolo viene revisionato come il codice: si vede esattamente quale frase è stata modificata. Inoltre, è il formato più economico in assoluto da elaborare per un assistente IA, un aspetto che acquista importanza ogni mese che passa. Quest'ultimo punto spiega perché ogni articolo qui viene distribuito in tre modalità. La pagina che state leggendo è la versione HTML. Aggiungendo `.md` all'indirizzo nel browser si ottiene il file sorgente grezzo, byte per byte esattamente come inviato nel commit, servito come semplice Markdown. Inoltre, ogni lingua ha il proprio feed RSS per lettori e aggregatori. Esiste anche un catalogo leggibile dalle macchine di tutti gli articoli pubblicati su [/blog/index.md](/blog/index.md), e il file `llms.txt` del sito indirizza i crawler IA direttamente a esso. Nulla di tutto questo viene mai considerato contenuto duplicato, poiché i file raw contengono un'intestazione noindex e un link canonico che rimanda alla pagina HTML. ## Cosa significa tutto questo per voi lettori Niente di tutto questo è una funzionalità del prodotto. Si tratta di una scelta su come gestiamo le nostre pubblicazioni, in linea con l'impegno preso nel [primo articolo](/en/blog/welcome-to-the-litetms-blog): niente numeri inventati e testi verificabili direttamente alla fonte. Il TMS stesso è costruito sulla medesima preferenza per meccanismi semplici e ispezionabili. Se volete dare un'occhiata, [la registrazione è gratuita](/en/register). ## FAQ ### È possibile leggere un articolo del blog di LiteTMS come semplice testo Markdown? Sì. Aggiungendo `.md` all'indirizzo di qualsiasi articolo, il sito reindirizza al file sorgente non elaborato, distribuito come semplice Markdown. Il catalogo completo degli articoli pubblicati è disponibile su /blog/index.md. ### Perché il blog di LiteTMS non usa un CMS? Perché un CMS rappresenterebbe un secondo sistema da aggiornare e proteggere, e le uniche persone che pubblicano qui lavorano già nel repository del prodotto. I file Markdown con un validatore in CI svolgono la stessa funzione richiedendo molta meno manutenzione. ### Scrivere pensando agli assistenti IA peggiora la lettura per le persone? No. La struttura premiata dagli assistenti, ovvero un paragrafo iniziale diretto, titoli descrittivi e domande esplicite con risposte brevi, è la stessa struttura che rende un articolo facile da scorrere rapidamente. Il Markdown grezzo è un formato separato, quindi l'articolo che leggete resta un testo del tutto normale.