O manifesto do HTML simples

As stacks web modernas tornaram as páginas fáceis de montar e difíceis de ler para uma máquina. Publicamos o documento, e mais nada tem de correr antes de as palavras contarem.

Porque os frameworks JavaScript quebraram o acesso dos robôs

Uma página de framework responde muitas vezes com uma casca. As frases chegam depois, quando um programa corre. Os motores de pesquisa podem gastar uma segunda vaga de rastreio nesse programa. Muitos rastreadores de IA não o fazem.

O custo não é teórico. CSS por usar, uma pilha funda de div e ligações que não são ligações ficam entre o robô e o facto. O orçamento de rastreio vai para a casca. O facto chega tarde, ou não chega.

Se um facto importa, está no HTML, visível, na ordem dos títulos, e só se repete em JSON-LD quando a página diz o mesmo.

GeoHTML

Porque a IA precisa de estrutura semântica

Os grandes modelos de linguagem e os sistemas de recuperação dividem uma página em segmentos. Um título, um parágrafo, um item de lista e uma célula de tabela são segmentos que já sabem nomear. Um div com estilo é uma caixa.

A estrutura semântica não é um adorno em cima de um componente. É a API. De h1 para h2 para h3, por essa ordem, diz ao modelo onde uma secção começa. Uma tabela diz-lhe que células partilham a linha. Um elemento a com href diz-lhe o próximo destino.

Esconder o mesmo texto com CSS, ou carregá-lo quando um controlo abre, ensina o sistema a tratar a página como incompleta. Não fazemos isso com nada que queiramos ver citado.

A que nos comprometemos

Cada página pública da GeoHTML é um ficheiro que um rastreador lê até ao fim sem navegador.

  • HTML simples para as palavras, com um h1 e sem níveis de título saltados
  • CSS nativo, sem framework e sem tipo de letra web, salvo se o projeto impuser a exceção
  • Nenhum texto essencial por trás de display:none, de renderização no cliente ou de uma ligação com onclick
  • JSON-LD que coincide com o texto visível, incluindo as FAQ
  • Um equivalente traduzido no mesmo caminho, sob cada prefixo de língua, ligado com hreflang
  • Ordem do código-fonte igual à ordem em que uma pessoa lê

Este sítio é o exemplar. O hub de artigos mostra as mesmas regras usadas num documento, e a página de preços diz o que um projeto contém.

O resultado sem lastro: 100 perfeitos

As arquiteturas GeoHTML obtêm nativamente pontuações perfeitas de 100/100 no Google Lighthouse. Como não usamos JavaScript e publicamos HTML simples, o Total Blocking Time é de 0 ms, com apresentação imediata para pessoas e para motores de resposta de IA.

Google PageSpeed Insights com uma pontuação perfeita de 100 no computador para a GeoHTML
Desempenho no computador: 0,2 s de Contentful Paint, desvio de layout 0.
Google PageSpeed Insights com uma pontuação perfeita de 100 no telemóvel para a GeoHTML
Desempenho no telemóvel: 100 perfeito nas quatro métricas da Google.

Perguntas sobre o manifesto

São contra o JavaScript?

Não. Somos contra exigir JavaScript para se poder ler uma frase pública. Use um cliente quando a tarefa precisa de um. Não o use para publicar um parágrafo.

Porque não um framework conhecido com renderização no servidor?

A renderização no servidor pode pôr o texto na primeira resposta. Mesmo assim tende a enviar o framework, o passo de hidratação e uma grande carga de CSS. Nós entregamos o documento e uma folha de estilos curta.

Pedir uma auditoria gratuita de extração por IA

Envie um URL público. Uma pessoa lê o HTML que o servidor devolve e responde com o que os robôs de IA podem citar e com o que nunca veem.

Pedir uma auditoria gratuita de extração por IA