Referência
Material de referência exaustivo: os fatos que um desenvolvedor ou operador precisa, sem narrativa. Seis documentos nesta seção, todos construídos da mesma forma: cada fato verificado contra o código-fonte na versão que descrevem.
Nesta seção
- Referência do build.pl. O builder estático: guardrails de invocação, ciclo de vida (staging → checks → manifest → promote), full vs regras incremental, o promotion guard, códigos de saída e a tabela de variáveis de ambiente.
- Referência do cms.pl. A aplicação do CMS: requisitos de inicialização, a estrutura de despacho de admin/API, tarefas agendadas e os helpers que outra tooling reutiliza.
- Variáveis de Ambiente. Cada variável
CHINASKI_*, seu padrão e seu efeito . Incluindo o trio obrigatório (CHINASKI_SECRET,CHINASKI_DB,CHINASKI_OUTPUT) e os conjuntos específicos do MCP/form-suite. - Referência de Settings. Cada chave de configuração por aba, com padrões, regras de validação e quais disparam um rebuild (mais quais não podem ser redefinidos).
- Referência de Schema. Cada tabela e coluna do banco de dados: o que cada uma armazena, as restrições e como as tabelas se relacionam.
- Referência de Templates. As variáveis que cada template de site/bloco recebe, o inventário de partials e as regras de segurança.
Como ler essas páginas
As páginas de referência são deliberadamente concisas : tabelas e regras, nada de tutoriais. Se você quer a história por trás de um fato (por que o promotion guard existe, por que não há sistema de plugins), a seção de Philosophy cobre isso; as seções de Authoring/Admin cobrem os fluxos de trabalho.
Convenções
- Fatos são enunciados como fatos; casos raros que merecem destaque ficam inline na linha relevante.
- Onde o mesmo comportamento tem tanto um controle de campo de configuração quanto uma variável de ambiente, ambos são listados com sua precedência (variáveis de env vencem).
- Os números na referência (limites, padrões, timeouts) são verificados no código . Quando os docs e o código um dia discordarem, confie no código, e registre uma nota para que ambos possam ser corrigidos.
Também em Referência
Referência do builder/build.pl: o ciclo de vida do build, as variáveis de ambiente, as proteções e as opções para executá-lo manualmente.
Execute o daemon cms.pl em desenvolvimento, produção e offline: CHINASKI_SECRET, a unidade systemd e as ferramentas de linha de comando.
Referência das variáveis de ambiente do Chinaski: onde defini-las, o CHINASKI_SECRET obrigatório e as substituições opcionais.
Todas as configurações do Chinaski por aba, de General a Workflow: o que cada chave faz, como o salvamento funciona e quando ele dispara um rebuild.
O que o banco de dados do Chinaski guarda, como funciona o arquivo SQLite único e os comportamentos de exclusão lógica que todo admin deve conhecer.
Referência dos templates de um tema Chinaski: os arquivos .tt obrigatórios e opcionais, as variáveis recebidas e onde ficam os temas.