Guias & Receitas
Passo a passo para objetivos comuns, escritos como receitas de alcance-de-objetivo em vez de documentação de funcionalidades. Cada guia existe como um passo a passo completo; as subpáginas vinculadas cobrem as referências subjacentes.
Migração
- Migrar do WordPress: os caminhos verificados que funcionam hoje: importação de Markdown com front matter, idas-e-voltas JSON/CSV, ou os endpoints bulk da API REST; re-upload de mídia; tratamento da exportação de redirecionamentos; a lista do que não migra automaticamente.
Multilíngue
- Configurar um Site Multilíngue: a ordem de decisão real: idiomas → modo de URL → permalinks → menus/copys por idioma, com as regras de remoção de idioma.
Deployment
- Domínio Personalizado & TLS: apontar DNS, servir TLS (automático no Caddy; certbot no nginx) e casar o proxy com o bind do CMS.
- Implantação no Caddy: o Caddyfile embarcado adaptado por instância, incluindo o include de redirecionamentos e a política de cache.
- Implantação no nginx: os três placeholders, as duas rotas de proxy obrigatórias, a sincronização da root.
- Implantação no Netlify: publicando a saída estática no Netlify, com a ressalva do
_redirects.
Receitas de conteúdo
- Configurar um Blog: os padrões de postagem a definir antes do primeiro post (permalinks, posts por página, feed).
- Adicionar um Formulário de Contato: criação do formulário → incorporação (ou URL independente) → SMTP (e opcionalmente Turnstile) → teste de submissão; configurações de e-mail/webhook ficam nas páginas de formulários.
- Construir um Tema do Zero: a rota recomendada (clonar, depois personalizar, depois ativar) e onde vive o kit de ferramentas de criação.
Identidade
- Configurar SSO: pondo um provedor de identidade OAuth/OIDC na frente do login de admin, os campos a configurar e como as novas contas se comportam.
O que os guias pressupõem
- O Getting Started está concluído: a instância está instalada, a senha de setup mudada e o admin alcançável.
- Os guias estreitam, não substituem, a referência: cada passo aponta para a página de referência que documenta os valores que ele define. Quando um guia e uma referência um dia discordarem, a referência é o fato.
Também em Guias & Receitas
Migre do WordPress pelas vias de importação reais do Chinaski: Markdown com front matter, o que não é suportado e uma ordem prática de migração.
Passe de um site em um só idioma para publicação multilíngue: ative idiomas, defina o padrão, estruture as URLs e traduza cada locale.
Aponte seu domínio para o servidor em quatro passos: registros DNS, a Site URL canônica, o proxy reverso e a verificação do TLS.
Configure um blog funcional no Chinaski: escolha o prefixo de URL dos posts, organize posts e categorias, ajuste o índice e ative o feed.
Crie um formulário de contato com campos no admin, coloque-o em uma página com um block de formulário e veja o que acontece após o envio.
Crie um tema Chinaski de ponta a ponta: clone um starter, gere com o Claude ou copie os templates, depois ligue blocks e menus e teste.
Publique a saída gerada do Chinaski na Netlify: o arquivo _redirects que o builder escreve e as duas ressalvas a checar antes de publicar.
Deploy do Chinaski com Caddy: pré-requisitos, adaptação do Caddyfile de exemplo, bloco por site para a saída estática e snippet de redirecionamentos.
Receita de produção para servir um site Chinaski com nginx: saída estática, proxy das rotas dinâmicas ao daemon, TLS e deploys sincronizados.
Configure o login único com qualquer provedor OAuth 2.0 ou OpenID Connect: o que registrar no provedor e quais ajustes preencher.