--- title: Este blogue é uma pasta de ficheiros markdown slug: why-this-blog-has-no-cms locale: pt description: Não há CMS por trás do blogue do LiteTMS. Cada artigo é um ficheiro markdown no repositório, validado em CI e servido em HTML, markdown puro e RSS. date: 2026-07-15 updated: 2026-07-15 category: technology tags: markdown, blog, aieo, engineering author: LiteTMS Team draft: false --- Não existe nenhum CMS por trás deste blogue nem qualquer base de dados. Cada artigo é um ficheiro markdown adicionado ao mesmo repositório do código do LiteTMS, pelo que publicar um artigo funciona exatamente como lançar uma funcionalidade: um commit e um deploy. Queríamos fazer isto de forma diferente da maioria dos blogues corporativos, e este artigo mostra todo o mecanismo, incluindo o código-fonte da própria página que está a ler. ## A configuração que todos os outros utilizam Um blogue corporativo típico funciona com um sistema completo de gestão de conteúdos (CMS). Uma base de dados, um painel de administração, contas de utilizador, plugins e um tema que se torna uma dor de cabeça sempre que se tenta alterar algo. Toda essa engrenagem existe para que uma equipa de editores possa publicar sem ter de se aproximar do código. Não temos uma equipa de editores e já passamos o dia inteiro num repositório de código. Por isso, dispensámos toda essa engrenagem. Cada sistema adicional é mais uma coisa para atualizar, salvaguardar e proteger. Uma pasta com ficheiros de texto não é. ## O aspeto do ficheiro de um artigo Eis uma versão resumida do cabeçalho deste próprio artigo, seguida da estrutura do corpo do texto: ```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. ``` O bloco no topo é uma lista simples de pares de chave e valor. Abaixo dele encontra-se markdown vulgar, processado por uma biblioteca padrão de markdown. Um ficheiro por idioma: este artigo existe como um ficheiro `.en.md` e um ficheiro `.pl.md` com o mesmo nome, e a versão polaca foi escrita de raiz e não traduzida automaticamente. A secção `## FAQ` no final do exemplo é a convenção real, não mero adorno. Cada pergunta é do tipo que uma pessoa escreveria num motor de busca, e o processo de compilação transforma esses pares em dados estruturados que os motores de busca podem apresentar como resultados enriquecidos (rich results). Existe um exemplo real no fundo desta página. ## Um validador em vez de um editor Antes de qualquer publicação entrar em produção, um script de compilação lê cada ficheiro de artigo e valida-o em relação ao esquema. A descrição tem de ter entre 80 e 170 carateres. A categoria tem de ser um de cinco valores permitidos. A data tem de ser uma data real do calendário e o slug tem de coincidir com o nome do ficheiro. De seguida, o script gera um único ficheiro de índice com os metadados de todos os artigos, e o site lê apenas esse ficheiro. Apresentar uma página de listagem tem exatamente o mesmo custo com quinhentos artigos ou com cinco. O mesmo script é executado no CI a cada push. Se um artigo for inválido, ou se alguém se tiver esquecido de regerar o índice, a compilação falha e nada é publicado. Conteúdo com erros nunca chega a produção, porque a produção nunca recebe nada que o validador não tenha aprovado. ## Porquê markdown, francamente O markdown venceu por motivos práticos e sem artifícios. Um ficheiro markdown pode ser lido em qualquer editor de texto, com ferramentas dedicadas ou sem elas. Permite comparações linha a linha (diffs), pelo que um artigo é revisto da mesma forma que o código: vê-se exatamente que frase mudou. E é o formato mais económico possível para ser processado por assistentes de IA, algo que ganha relevância a cada mês. Este último ponto explica por que razão cada artigo é disponibilizado de três formas. A página que está a ler é a versão em HTML. Se adicionar `.md` ao endereço no seu navegador, obtém o ficheiro-fonte original, byte a byte tal como foi gravado no repositório, servido em markdown simples. Além disso, cada idioma tem o seu próprio feed RSS para leitores e agregadores. Existe também um catálogo legível por máquina de todos os artigos publicados em [/blog/index.md](/blog/index.md), e o ficheiro `llms.txt` do site encaminha os crawlers de IA diretamente para lá. Nada disto surge alguma vez como conteúdo duplicado, pois os ficheiros originais contêm um cabeçalho noindex e uma ligação canónica que aponta de volta para a página HTML. ## O que ganha com isto enquanto leitor Nada disto é uma funcionalidade do produto. Trata-se de uma decisão sobre a forma como gerimos as nossas próprias publicações, alinhada com a promessa do [primeiro artigo](/en/blog/welcome-to-the-litetms-blog): sem números inventados e com textos que pode verificar diretamente na fonte. O próprio TMS foi construído com a mesma preferência por mecanismos simples e transparentes. Se quiser explorar, o [registo é gratuito](/en/register). ## FAQ ### Posso ler um artigo do blogue do LiteTMS em markdown simples? Sim. Adicione `.md` ao endereço de qualquer artigo e o site redireciona-o para o ficheiro-fonte original, disponibilizado em markdown simples. O catálogo completo dos artigos publicados encontra-se em /blog/index.md. ### Por que razão o blogue do LiteTMS não utiliza um CMS? Porque um CMS seria um segundo sistema para atualizar e proteger, e as únicas pessoas que publicam aqui já trabalham no repositório do produto. Ficheiros markdown com um validador de CI cumprem a mesma função com muito menos manutenção. ### Escrever a pensar em assistentes de IA torna os artigos piores para as pessoas? Não. A estrutura valorizada pelos assistentes, nomeadamente um parágrafo de abertura direto, títulos descritivos e perguntas literais com respostas curtas, é a mesma estrutura que facilita a leitura rápida de um artigo. O markdown em bruto é um formato separado, pelo que o texto que lê continua a ser um artigo normal.