← back to the garden

MD

Tutorial para Criar um Site Autoral Inspirado no Scientiac

Guia pratico para transformar a analise do scientiac.space em um plano de site pessoal handmade, IndieWeb, com Markdown, RSS, taxonomias, Webmentions e POSSE.

  • tutorial
  • indieweb
  • site-pessoal
  • markdown
  • rss
  • webmentions
  • zola
  • astro

Tutorial: como criar um site autoral inspirado no scientiac.space

Este tutorial transforma a análise do scientiac.space em um plano prático para construir um futuro site pessoal, autoral e independente.

A ideia não é copiar o visual do Scientiac pixel por pixel. A ideia é aprender com a estrutura: conteúdo em Markdown, site estático, feeds, taxonomias, Webmentions, POSSE, identidade própria e uma sensação clara de arquivo vivo.

A lição principal é simples: o site pessoal deve ser a casa principal. Redes sociais, newsletters e plataformas externas são apenas canais laterais.

1. O que você vai construir

Ao final deste plano, o site ideal terá:

  • uma página inicial simples e autoral;
  • textos em Markdown;
  • arquivo cronológico de publicações;
  • categorias e séries;
  • feeds RSS/Atom segmentados;
  • página now;
  • página uses;
  • página colophon;
  • busca local;
  • Webmentions;
  • links rel=me;
  • POSSE manual ou semi-automatizado;
  • uma estrutura pronta para crescer sem virar um monstro.

O objetivo é criar um site que funcione como:

  • casa pessoal;
  • diário técnico;
  • arquivo de projetos;
  • índice de ideias;
  • laboratório IndieWeb;
  • ponto canônico para publicações autorais.

2. O que o scientiac.space ensina

O scientiac.space é um site pessoal estático feito com Zola, publicado a partir de um repositório público no GitHub:

scientiac/scientiac.github.io

Ele combina:

  • Zola como gerador de site estático;
  • Markdown como formato principal de conteúdo;
  • Tera templates para HTML;
  • CSS próprio com estética textual e acadêmica;
  • busca client-side com índice gerado no build;
  • RSS e Atom;
  • taxonomias editoriais;
  • Webmentions;
  • Fediverse;
  • IndieWeb Webring;
  • GitHub Actions para automação;
  • GitHub Pages ou fluxo equivalente para publicação.

A força do site não está em ter tecnologia extravagante. Está em ter coerência: ele é pequeno, estranho, pessoal, legível e independente.

3. Antes de escolher a stack

Antes de pensar em Zola, Astro, Ghost ou Craft CMS, defina a função editorial do site.

Responda:

  1. O site será um blog, um arquivo, um laboratório ou uma publicação?
  2. Você quer escrever principalmente textos longos, notas curtas ou logs técnicos?
  3. Você quer editar por Markdown/Git ou por painel?
  4. O site precisa de banco de dados agora?
  5. O conteúdo precisa ser estruturado como catálogo, ou basta Markdown?

Para um site pessoal handmade, a regra é:

Comece pelo formato que te faz publicar mais, não pelo formato que parece mais sofisticado.

4. Escolha da stack

Opção A: Zola

Use Zola se quiser máxima simplicidade, velocidade e permanência.

Zola
Markdown
Git
Tera templates
RSS/Atom
Pagefind ou elasticlunr
Webmention.io
GitHub Actions / Forgejo Actions
Cloudflare Pages / GitHub Pages / VPS

Vantagens:

  • rápido;
  • estático;
  • barato;
  • quase indestrutível;
  • ótimo para arquivo pessoal;
  • combina com IndieWeb e small web.

Limitações:

  • publicar exige Git/Markdown;
  • editar pelo celular é menos confortável;
  • conteúdo muito estruturado pode dar trabalho.

Opção B: Astro

Use Astro se quiser mais liberdade visual e páginas experimentais.

Astro
Markdown/MDX
Content Collections
Pagefind
RSS
Webmention.io
Cloudflare Pages

Vantagens:

  • flexível;
  • ótimo para componentes;
  • bom para miniapps e páginas especiais;
  • mais confortável para misturar conteúdo e interface.

Limitações:

  • mais dependências;
  • ecossistema Node pode distrair;
  • risco de virar projeto de ferramenta, não de publicação.

Opção C: Ghost

Use Ghost se a prioridade for publicação editorial com painel pronto.

Ghost
Tema customizado
RSS nativo
Content API
Admin API
n8n / automações

Vantagens:

  • editor bom;
  • API madura;
  • newsletter e publicação editorial funcionam bem;
  • você já tem familiaridade com esse caminho.

Limitações:

  • menos handmade;
  • Webmentions e POSSE exigem adaptação;
  • taxonomias IndieWeb não são tão naturais.

Opção D: Craft CMS

Use Craft CMS apenas se o site virar um acervo estruturado grande.

Craft CMS
Twig ou headless GraphQL
MySQL/PostgreSQL
PHP
Nginx/Apache

Vantagens:

  • painel editorial excelente;
  • campos personalizados fortes;
  • relações entre entidades;
  • bom para catálogos, acervos e múltiplos tipos de conteúdo.

Limitações:

  • pesado para um site pessoal simples;
  • exige banco, servidor PHP, backup e manutenção;
  • pode virar complexidade bonita antes de existir conteúdo.

Recomendação direta

Objetivo Melhor escolha
Site pessoal autoral, handmade e IndieWeb Zola ou Astro
Publicação editorial com painel Ghost
Acervo estruturado com entidades e relações Craft CMS

Minha escolha inicial seria:

pablo.space          site principal handmade com Astro ou Zola
press.pablo.space    Ghost para publicação editorial
archive.pablo.space  Craft CMS apenas se houver dor real de acervo

5. Estrutura recomendada do site

Um bom site pessoal não precisa de menu gigante. Ele precisa de uma arquitetura clara.

/
├── /archive/          tudo publicado
├── /writings/         ensaios e textos longos
├── /notes/            notas curtas
├── /projects/         projetos vivos
├── /series/           séries de posts
├── /syndications/     POSSE, ECHO, respostas e republicações
├── /links/            links comentados
├── /cinema/           diário de filmes
├── /books/            leituras
├── /infra/            servidores, self-hosting e logs técnicos
├── /idea/             educação, Portal IDEA e bastidores
├── /now/              o que está acontecendo agora
├── /uses/             setup, ferramentas e apps
├── /contact/          contato e identidade
├── /feeds/            todos os feeds RSS/Atom
├── /colophon/         como o site foi feito
└── /source/           código-fonte ou notas técnicas

Não coloque tudo no menu principal. Use uma página /more/ ou /index/ para links secundários.

Menu principal sugerido:

Home | Arquivo | Projetos | Notas | Mais

ou:

Main | Writings | Lab | Index | More

6. Taxonomias essenciais

Taxonomia é o sistema que impede o site de virar uma pilha indistinta de posts.

Use pelo menos quatro dimensões:

Tipo

type:
  - essay
  - note
  - report
  - poem
  - story
  - link
  - log
  - review

Projeto

project:
  - portal-idea
  - openclaw
  - owncast
  - runv
  - ipfs
  - weirdnet
  - pablo-space
  - go-to-social
  - le-rss

Série

series:
  - building-the-small-web
  - server-notes
  - fediverse-experiments
  - cinema-diary
  - reading-log
  - portal-idea-behind-the-scenes

Sindicação

syndication:
  - posse
  - echo
  - reply
  - repost
  - mastodon
  - bluesky
  - linkedin

Pense assim:

Campo Pergunta que responde
type Que tipo de texto é este?
project A qual projeto ele pertence?
series De qual sequência contínua ele faz parte?
syndication Para onde ele foi publicado ou a que ele responde?

7. Modelo de front matter para posts

Use metadados simples e consistentes. Um post poderia começar assim:

---
title: "Meu primeiro log de servidor"
date: 2026-06-30
summary: "Notas sobre a configuração inicial de um servidor pessoal."
tags: [infra, self-hosting, linux]
type: log
project: pablo-space
series: server-notes
syndication:
  status: posse
  targets: [mastodon, bluesky]
external_urls:
  - https://exemplo.social/@pablo/123
---

Para um site em Zola ou Astro, você pode adaptar os campos conforme o sistema de conteúdo escolhido. O importante é manter intenção editorial.

8. Feeds RSS e Atom

Não tenha apenas um feed geral. O Scientiac mostra uma lição importante: feeds segmentados deixam o site mais útil.

Crie algo assim:

/feed.xml                 tudo
/feed/essays.xml          ensaios
/feed/notes.xml           notas curtas
/feed/projects.xml        relatórios de projetos
/feed/infra.xml           infraestrutura e servidores
/feed/cinema.xml          cinema
/feed/books.xml           leituras
/feed/idea.xml            Portal IDEA e educação
/feed/posse.xml           publicações sindicadas
/feed/links.xml           links comentados

Nem todo leitor quer acompanhar tudo. Quem quer infra pode não querer cinema. Quem quer cinema pode não querer logs de servidor.

RSS segmentado é um recurso pequeno com impacto editorial grande.

9. POSSE: publique no seu site primeiro

POSSE significa:

Publish on your Own Site, Syndicate Elsewhere

Ou seja:

  1. Publique primeiro no seu domínio.
  2. Depois distribua para Mastodon, Bluesky, LinkedIn, Reddit ou outras redes.
  3. Guarde no post os links das cópias externas.

No começo, faça manualmente. Automação vem depois.

Exemplo de fluxo:

Escreve post no site
        ↓
Publica no domínio próprio
        ↓
Copia resumo para Mastodon/Bluesky/LinkedIn
        ↓
Salva URLs externas no front matter
        ↓
O site mostra onde o texto foi republicado

Isso muda a relação com a internet. O seu site vira origem, não vitrine atrasada.

10. Webmentions

Webmentions permitem que outros sites respondam ao seu texto a partir dos sites deles.

Fluxo recomendado para site estático:

Outro site menciona seu post
        ↓
Webmention.io recebe a menção
        ↓
Uma Action ou cron busca o JSON periodicamente
        ↓
O JSON é salvo no repositório ou em /static/
        ↓
O site renderiza as respostas no final dos posts

Para começar:

  1. Configure conta no Webmention.io.
  2. Adicione links rel=me no HTML.
  3. Adicione tags de endpoint Webmention.
  4. Crie uma rotina para buscar as menções.
  5. Renderize as respostas com moderação básica.

Texto de chamada no final do post:

Respondeu a este texto no seu site? Envie sua URL.

11. Busca local

Para busca em site estático, comece simples.

Opções:

Ferramenta Quando usar
Pagefind Melhor opção geral para site estático moderno
elasticlunr Boa se usar Zola e quiser ficar no ecossistema
Meilisearch Só quando o arquivo crescer muito
Tantivy Quando houver necessidade técnica específica

Recomendação:

Use Pagefind no começo, a menos que Zola já resolva a busca de forma suficiente.

12. Páginas que dão alma ao site

Página now

Mostra o que você está fazendo agora.

Inclua:

  • projetos ativos;
  • leituras atuais;
  • servidores em manutenção;
  • foco do mês;
  • coisas pausadas;
  • última atualização.

Página uses

Lista ferramentas, hardware, apps e fluxos de trabalho.

Inclua:

  • computador principal;
  • servidores;
  • sistema operacional;
  • editor;
  • terminal;
  • serviços self-hosted;
  • leitor RSS;
  • e-reader;
  • apps de escrita;
  • automações.

Página colophon

Explica como o site foi feito.

Inclua:

  • stack;
  • hospedagem;
  • fontes;
  • tema;
  • licença;
  • inspiração;
  • automações;
  • política de privacidade simples.

Página links

Não faça apenas favoritos. Faça links comentados.

Formato ideal:

link + comentário + tags + data + relação com projetos

Diário técnico

Use um formato consistente:

Problema
Contexto
Sintoma
Diagnóstico
Correção
Lição aprendida

Isso vira memória técnica, documentação e material de publicação.

13. Blueprint de MVP em quatro semanas

Semana 1: site mínimo

  • Home.
  • Arquivo.
  • Post individual.
  • Categorias.
  • RSS geral.
  • CSS base.
  • Deploy.

Semana 2: identidade editorial

  • Página /now/.
  • Página /uses/.
  • Página /projects/.
  • Página /feeds/.
  • Página /colophon/.

Semana 3: IndieWeb

  • Webmention.io.
  • Links rel=me.
  • Fediverse.
  • POSSE manual.
  • RSS segmentado.

Semana 4: refinamento

  • Busca.
  • Séries.
  • Links comentados.
  • Página de filmes ou livros.
  • Automação leve.

Não adicione Craft CMS, painel complexo, newsletter, área logada ou dashboard antes de publicar conteúdo real.

14. Checklist de implementação

Obrigatório

  • Escolher Zola ou Astro para o MVP.
  • Criar estrutura de conteúdo em Markdown.
  • Criar homepage simples.
  • Criar arquivo cronológico.
  • Criar post individual.
  • Criar taxonomias básicas.
  • Gerar RSS geral.
  • Publicar em Cloudflare Pages, GitHub Pages ou VPS.
  • Criar página colophon.
  • Criar licença clara.

Recomendado

  • Criar feeds segmentados.
  • Criar página now.
  • Criar página uses.
  • Criar página projects.
  • Adicionar busca local.
  • Adicionar rel=me.
  • Conectar Fediverse.
  • Adicionar Webmentions.
  • Criar página de links comentados.
  • Criar página de séries.

Depois

  • POSSE semi-automatizado.
  • Blogroll.
  • Guestbook.
  • Webring.
  • Micropub.
  • Importador de posts antigos.
  • Página /random.
  • Diário de cinema.
  • Diário de leitura.

15. O que evitar no começo

Evite:

  • área logada;
  • comentários nativos com banco;
  • dashboard complexo;
  • React pesado sem necessidade;
  • CMS só porque parece profissional;
  • design system gigante;
  • newsletter antes de ter cadência editorial;
  • analytics invasivo;
  • automação antes de existir conteúdo;
  • testar cinco stacks ao mesmo tempo.

O maior risco é transformar o site em megaprojeto técnico.

Primeiro publique. Depois sofistique.

16. Quando Craft CMS faz sentido

Craft CMS não é ruim. Ele só não é o melhor primeiro passo para um site pessoal handmade inspirado no Scientiac.

Use Craft se o projeto virar algo como:

Murad Library
├── textos
├── filmes
├── livros
├── cursos
├── projetos
├── servidores
├── pessoas
├── links
├── séries
└── coleções editoriais

Nesse caso, Craft permitiria modelar entidades:

Filme
├── título
├── ano
├── diretor
├── nota pessoal
├── texto relacionado
├── tags
├── poster
└── links externos

Projeto
├── nome
├── status
├── domínio
├── stack
├── repositório
├── posts relacionados
├── servidores relacionados
└── data de início

Se a dor for relação entre entidades, painel editorial, mídia e campos estruturados, Craft entra com propósito. Antes disso, ele é complexidade bonita.

17. Modelo final recomendado

Uma arquitetura sensata seria:

pablo.space
  Site principal handmade
  Astro ou Zola
  Markdown
  RSS
  Webmentions
  POSSE

press.pablo.space
  Publicação editorial
  Ghost
  newsletter opcional
  automações via API

archive.pablo.space
  Acervo estruturado futuro
  Craft CMS apenas se houver necessidade real

Também dá para simplificar:

pablo.space
  tudo em Astro ou Zola no começo

Essa é provavelmente a melhor decisão inicial.

18. Critério de sucesso

Não meça o projeto pelo número de tecnologias.

Meça por perguntas melhores:

  • O site publica texto com facilidade?
  • O RSS funciona?
  • O arquivo é navegável?
  • As categorias fazem sentido?
  • Uma pessoa entende o site em 30 segundos?
  • O conteúdo tem voz própria?
  • Dá vontade de voltar?
  • O site é seu, ou parece template?

Se a resposta for sim, o site está funcionando.

19. Plano seco de decisão

Se o objetivo é site pessoal autoral:

Escolha Zola ou Astro.

Se o objetivo é publicação editorial com painel:

Use Ghost.

Se o objetivo é acervo estruturado grande:

Considere Craft CMS depois.

Minha recomendação:

Comece com Zola ou Astro. Publique 30 textos. Depois decida se Craft CMS ainda é necessário.

Depois de 30 textos, a dor real aparece. Antes disso, quase tudo é imaginação de arquitetura.

20. Fontes e referências

Resumo rápido para reler depois

Construa um site pessoal como casa principal, não como vitrine de redes sociais. Use Markdown, RSS, taxonomias, Webmentions e POSSE. Escolha Zola se quiser simplicidade máxima, Astro se quiser liberdade visual, Ghost se quiser painel editorial e Craft CMS apenas se o projeto virar um acervo estruturado grande.