Glossário

Definições curtas dos termos que você encontrará ao ler esta documentação. As entradas que têm uma página de tópico mais profunda citam essa página ao final.

instance

Uma cópia em execução do Chinaski servindo um site: seu próprio serviço systemd, seu próprio arquivo de banco de dados SQLite, suas próprias configurações. Várias instâncias (por cliente, por estágio) podem compartilhar um servidor por meio do padrão de units de instância (veja Quickstart e The Database).

CMS

O aplicativo de administração privado onde você produz o conteúdo. Ele armazena tudo em SQLite e, em produção, faz bind apenas em um endereço de loopback, de modo que os visitantes nunca o alcançam.

builder

O processo separado que transforma seu banco de dados de conteúdo no site estático: ele lê o banco de dados, renderiza seus templates e escreve HTML puro em disco. Builds são explícitos (dashboard, webhook, API ou linha de comando), nunca efeitos colaterais automáticos.

staging e live

Todo build é escrito em um diretório de staging ao lado da saída, e então trocado para a saída ao vivo somente quando o build está completo e passa por suas verificações de segurança. Um build que falha deixa o site anterior servindo intacto.

block

Um pedaço reutilizável de conteúdo estruturado incorporado em qualquer página ou post com {{block:name}}. Tipos simples recebem campos planos; tipos estruturados armazenam linhas repetidas como JSON com um editor de linhas. Veja Blocks.

stack

Uma sequência de blocos tratada como uma unidade: duplicável, exportável, com histórico de revisões e diffs. Feita para grandes seções que se repetem entre páginas.

snippet

HTML/JavaScript/CSS puro injetado no <head> ou <body> das páginas construídas, para tags de analytics, tokens de verificação e estilos personalizados. Snippets podem ser globais (todas as páginas) ou atribuídos a páginas e posts individuais. Veja Snippets.

slot

Uma localização de menu nomeada em um tema (por exemplo, header ou footer), descoberta a partir de marcadores de workspace que seus templates declaram, e então oferecida no admin de Navigation. Veja Navigation e a referência de Themes.

theme

O conjunto de templates que renderiza seu site, com um tema ativo por instância. Temas fornecem templates de página, post e listagem, e expõem tipos de bloco e configurações do site como variáveis de template (veja a documentação embutida de Themes).

media

Imagens e arquivos enviados com seus metadados (texto alternativo, legendas, dimensões). A pasta de mídia é sincronizada na árvore de saída de cada idioma no momento do build.

modo air-gap

O estado de implantação sem rede de saída. Ativá-lo mostra um banner na barra lateral e muda o comportamento onde conexões importam: código de snippets externos é removido, restaurações de backup remotas são desativadas e integrações que enviam dados para fora ficam indisponíveis. A instalação offline também é suportada por meio de um instalador empacotado.

render cache e dirty set

Como os builds continuam rápidos: conteúdo inalterado é reconhecido e pulado (sem re-render), enquanto itens editados, transições agendadas desde o último build e páginas que dependem de blocos ou stacks alterados são reconstruídos.

build fingerprint

Um hash da configuração e dos templates de tema que afetam o build. Quando qualquer coisa global muda (uma configuração, o tema), o fingerprint deixa de corresponder e o próximo build cai para um rebuild completo, para que nada seja perdido.

promotion guard e builds bloqueados

A verificação de "sempre online" entre um build concluído e a publicação: um build que derrubaria uma grande parcela de páginas ou dispararia um pico de links quebrados é bloqueado, e o site anterior continua servindo. Um "Promote anyway" explícito permite contorná-lo por um build (veja Build Failures).

padrão de redirecionamento

Um redirecionamento cujo slug antigo termina em *, correspondendo a todos os caminhos sob aquele prefixo, com $1 substituindo o sufixo correspondente no destino. Redirecionamentos de padrão são servidos como páginas de redirecionamento em vez de regras de configuração do servidor.

segredo da instância (CHINASKI_SECRET)

A chave aleatória de 32+ bytes exigida na inicialização: ela assina os cookies de sessão e criptografa as credenciais armazenadas. Ela é excluída das exportações de configurações, nunca deixando seu servidor.

conta provisória e /setup

Instalações novas começam com uma senha de admin provisória. Toda requisição de admin redireciona para /setup até que uma senha real seja definida, após o que a página de setup desaparece (404). Redefinir a senha de um admin rearma esse mesmo fluxo.

manager

O Chinaski Manager (github.com/bigjohncobb/chinaski-manager): um painel de controle separado, distribuído junto, para provisionar e rodar muitas instâncias do CMS em um servidor: tenants, ciclo de vida da instância (build/deploy/rollback/start/stop), anexação de domínios com regeneração automática do servidor web, backups por instância e do control-plane, e verificações de saúde. Seus "tenants" agrupam instâncias no nível do manager; ele não coloca vários sites em um único banco de dados (veja Instances).