Início
Bem-vindo à documentação do Chinaski : o manual completo e verificado no código-fonte para o CMS auto-hospedado e construtor de sites estáticos chamado de opção chata à prova de balas. Tudo na árvore foi checado contra a versão do código que documenta; nada de hipóteses é entregue.
Seções
As convicções por trás do Chinaski e por que ele é construído do jeito que é.
Instale o Chinaski e publique sua primeira página.
A arquitetura e o modelo de conteúdo que sustentam o Chinaski.
Tudo sobre criar e gerenciar conteúdo (páginas, posts, blocos, stacks, formulários, mídia, documentos).
Rodar um site em vários idiomas.
Construir e customizar temas com Template Toolkit.
URLs canônicas, tags sociais, sitemaps e redirects.
Rodar o Chinaski em produção.
Contas, autenticação e o modelo de segurança.
Proteger e restaurar seu conteúdo.
Automatize o Chinaski via MCP e webhooks.
Material de referência exaustivo (builder, app, variáveis de ambiente, configurações, schema, templates).
Passo a passo para objetivos comuns.
Diagnóstico e correção de problemas comuns.
Metadados do projeto, releases e como contribuir.
Qual seção para a sua dúvida?
- "Posso usar / vai servir?" : comece por Primeiros Passos e Filosofia; a página de Requisitos é a checagem honesta mais rápida.
- "Como escrevo/publico/agendo X?" : a seção Criação de Conteúdo tem uma página por fluxo (páginas, posts, formulários, calendário, em massa, importação/exportação).
- "Como a máquina funciona?" : Conceitos Centrais para o modelo; Referência para os fatos exatos (variáveis de ambiente, chaves de configuração, schema).
- "Como rodar em produção / servir / manter seguro?" : Implantação e Operações, Backup e Segurança.
- "Algo não está se comportando" : Solução de problemas primeiro, depois o reference da seção relevante.
As coisas que o produto faz por design
- Auto-hospedado, ciente de air-gap. Instalações novas rodam totalmente desconectadas (sem telemetria, sem phone-home); recursos que exigem conectividade (email, webhooks, verificação de atualizações, backups em nuvem) são opt-in.
- O site público é saída estática: o trabalho é edição no banco de dados mais builds explícitos; tudo na seção Criação de Conteúdo edita o banco de dados, e cada build ou promove completamente ou continua servindo o que estava no ar.
- Dois papéis + escopo por usuário por idioma e tipo de conteúdo; tudo que é relevante à segurança é registrado em um audit trail mais logs de auth/eventos.
- API + automação por IA: REST com chaves de API de leitura/escrita para scripts; o servidor MCP embutido para que assistentes operem o CMS diretamente.
A checagem honesta mais rápida para saber se serve é ler para o que o Chinaski não serve : se você precisa de um marketplace de plugins, essa é a porta de saída.