Blog Builder
Ajude o usuário a lançar um blog pessoal -- desde a escolha de um framework até a implantação ao vivo com SEO adequado. Escopo completo: escolha do framework -> tema -> template de postagem -> implantação -> SEO.
Fluxo de Trabalho
Passo 1 -- Entender o contexto do usuário
Pergunte (ou deduza pelo contexto):
- Formação técnica? (não técnico / desenvolvedor JS / desenvolvedor Python / etc.)
- Começando do zero ou já possui um site existente?
- Alvo de implantação preferido: GitHub Pages, Vercel, Cloudflare Pages?
- Foco do conteúdo: escrita, portfólio, blog tutorial, documentação?
Passo 2 -- Recomendar um framework
| Situação | Recomendado |
|---|---|
| Não técnico, só quer escrever | Hugo -- zero JS, rápido, enorme biblioteca de temas |
| Já escreve JS/TS, quer controle de componentes | Astro -- arquitetura islands, ótima DX |
| Ama ecossistemas de temas, confortável com Node | Hexo -- ecossistema maduro de plugins |
| Desenvolvedor React, quer controle total | Next.js -- App Router + MDX |
Apresente a recomendação com uma breve justificativa. Confirme antes de prosseguir.
Passo 3 -- Configuração do framework
Leia o arquivo de referência relevante e guie o usuário na instalação + um tema inicial:
| Framework | Arquivo de referência |
|---|---|
| Hugo | references/hugo.md |
| Hexo | references/hexo.md |
| Astro | references/astro.md |
| Next.js | references/nextjs.md |
Passo 4 -- Gerar um template de postagem
Produza um arquivo de template de postagem pronto para uso com frontmatter completo. Os templates de ativos em assets/post-templates/ são pontos de partida -- copie e adapte para o tema escolhido pelo usuário e suas preferências.
Passo 5 -- Implantação
Leia references/deployment.md para o fluxo de CI/CD apropriado. Forneça o YAML completo do GitHub Actions, pronto para commit.
Notas importantes:
- GitHub Pages: envie para .github/workflows/deploy.yml; ative Pages nas configurações do repositório
- Vercel: conecte o repositório no dashboard; defina o preset do framework e o diretório de saída
- Cloudflare Pages: comando de build = npm run build, diretório de saída = dist (Astro/Hexo/Next.js) ou public (Hugo)
Passo 6 -- Configuração de SEO
Todo blog precisa de:
- sitemap.xml -- específico do framework; veja references/.md
- robots.txt -- forneça o conteúdo real do arquivo, não apenas uma descrição
- Tags Open Graph -- og:title, og:description, og:image, og:url como marcação real
- URLs canônicas -- defina baseURL / site na configuração para que sitemaps e tags OG funcionem corretamente
Sempre observe: a URL do site deve ser definida na configuração do framework para que o sitemap gere URLs absolutas corretas.
Princípios orientadores
- Forneça conteúdo real de arquivo (código, YAML, TOML), não apenas descrições
- Inclua apenas os campos que importam -- evite boilerplate esmagador
- Aponte uma ou duas armadilhas que costumam pegar as pessoas (ex.: baseURL do Hugo, campo site do Astro)
- Prefira exemplos prontos para copiar e colar