Portfolio Blog Content Hub

Repositório de conteúdo bruto do blog/portfólio, consumido via raw.githubusercontent.com.

Propósito

Este repositório existe para centralizar artigos e assets em uma fonte única de conteúdo, sem interface própria.

Com isso, diferentes front-ends (portfólio, landing, blog) podem consumir o mesmo material sem rebuild e sem redeploy deste repositório.

Arquitetura de Conteúdo

• posts/index.json: manifesto com metadados e ordenação dos posts
• posts/*.md: conteúdo dos artigos em Markdown
• assets/*: imagens e mídias reutilizáveis nos posts
• docs/*: documentação operacional e padrão editorial

Consumo (Raw URLs)

Manifesto:

https://raw.githubusercontent.com/NullCipherr/portfolio-blog/main/posts/index.json

Exemplo de artigo:

https://raw.githubusercontent.com/NullCipherr/portfolio-blog/main/posts/mercury-server-zig-http11.md

Contrato Mínimo do index.json

Cada item do manifesto deve representar um post e conter, no mínimo:

• slug (string única)
• title
• description
• date (ISO 8601, ex.: 2026-05-18)
• tags (array)
• coverImage (URL relativa ou absoluta)
• contentPath (ex.: posts/meu-artigo.md)

Observação: mantenha o contrato estável para evitar quebra nos consumidores.

Fluxo de Publicação

1. Criar/atualizar o arquivo .md em posts/
2. Adicionar/atualizar o item correspondente em posts/index.json
3. Validar links, data, slug e path
4. Commitar e publicar na branch principal

Checklist completo em docs/CHECKLIST_PUBLICACAO.md.

Boas Práticas

• Não versionar segredos nem credenciais
• Evitar breaking changes no manifesto
• Priorizar textos escaneáveis (títulos, subtítulos, blocos curtos)
• Otimizar assets antes de publicar (peso e dimensões)

Licença

Este repositório está sob a licença MIT. Veja LICENSE.