Referência de Settings

O Chinaski armazena a configuração de seu site como settings: pares chave/valor que você edita em Settings na área de admin (/admin/settings). Cada salvamento tem um snapshot, para que você veja e revisite o que mudou na aba History, e o app registra cada salvamento.

As configurações se organizam em abas: General, Organization, Integrations, Security, Email, PWA, Deploy, Backups, Permalinks e Workflow (mais API Keys e Environment, que são funcionalidades inteiras com suas próprias páginas). Cada aba salva de forma independente: apenas a aba que você envia é escrita, e um salvamento dispara automaticamente um rebuild do site quando os valores alterados afetam sua saída pública.

General

• Nome do site: mostrado nos títulos do navegador e nos e-mails de saída.
• Tagline: usada nas meta descrições, resumos do feed RSS e o subtítulo padrão de página.
• Copyright do rodapé: acrescentado ao ano © no rodapé. Deixe em branco para omitir.
• Noindex: desautoriza rastreadores via robots.txt e adiciona noindex a cada página.
• Minificar HTML: colapsa espaços em branco no HTML construído. Ligado por padrão; desligue para manter o espaçamento original durante depuração.
• Imagem padrão do site: usada como fallback de og:image em páginas e posts sem imagem própria. Deixe em branco para omitir.
• Idiomas ativos: códigos ISO 639-1 separados por vírgula (por exemplo en,es,pt). Os códigos são validados ao salvar. Você não pode remover um idioma que ainda tem páginas, posts ou blocos: apague ou reatribua esse conteúdo primeiro. Salve aqui antes de mudar o idioma padrão.
• Idioma padrão: idioma de fallback para o build estático; deve estar presente em Idiomas Ativos. Silenciosamente ajustado à lista ativa se não estiver.
• Fuso horário do site: um nome IANA (por exemplo UTC, America/New_York). Datas de publicação agendada são interpretadas neste fuso. Valores inválidos fazem fallback para UTC ao salvar.
• URL do Site: usada para URLs absolutas no sitemap.xml e no RSS. Inclua o protocolo; sem barra final (uma é removida ao salvar).
• Posts por página: número de posts no índice do blog e nos arquivos de categoria. Limitado à faixa de 1 a 100.
• Prefixo de URL base: prefixo para links do build estático (por exemplo /prefix); deixe em branco para relativo à raiz. A variável de ambiente CHINASKI_URL_BASE o sobrescreve.
• URL base do CMS: URL pública deste CMS. Permite que o shortcode [form:slug​] incorpore um formulário ao vivo quando o formulário não faz parte do build estático. A variável de ambiente CHINASKI_CMS_URL a sobrescreve.
• Título do índice do blog: heading e título de página da listagem do blog; em branco usa “Blog”. Cada idioma configurado pode ter sua própria sobrescrita.

Integrations

• URL do build webhook / URL do publish webhook / Segredo de webhook: notificações de webhook de saída. A URL deve ser um endereço público http(s). O segredo é armazenado criptografado; deixe em branco para manter o valor atual.
• GA4 ID / GTM ID: snippets de analytics. Ambos são removidos das páginas construídas no modo air-gap.
• Twitter site.
• Aviso de cookies: chave de ativação, texto do aviso, URL da política de cookies e rótulos dos botões aceitar/recusar. Cada idioma configurado pode sobrescrever o texto do aviso e os rótulos.

Security

Os campos Turnstile e SSO só aparecem quando o modo air-gap está desligado.

• Contato de segurança: deve ser um endereço mailto: ou uma URL https://, ou o salvamento é rejeitado.
• URL da política de segurança.
• Turnstile site key / secret key: Cloudflare Turnstile para as páginas de login e formulários. A secret é armazenada criptografada; deixe em branco para manter o valor atual.
• Limiar de falha: dispara um alerta no event log quando as falhas de autenticação registradas (incluindo tentativas bloqueadas) nos últimos 10 minutos atingem essa contagem. Padrão 20. Este é apenas um limiar de alerta; o próprio bloqueio de login é fixo: 60 segundos após 5 falhas consecutivas, 5 minutos após 10 e 30 minutos após 20, por IP.
• Rate limit de chave de API: requisições por minuto; de 1 a 10000, padrão 100.
• Autorregistro: permite cadastro a partir da página de login. Desligado por padrão.
• Expiração de senha: dias antes das senhas expirarem; 0 desabilita a expiração.
• SSO (OAuth): chave de ativação mais client ID, client secret, URL de autorização, URL de token e URL de userinfo. O client secret é armazenado criptografado; deixe em branco para mantê-lo.

Email

• SMTP host, port, encryption, username: escolha a criptografia entre STARTTLS, SSL ou nenhuma (STARTTLS é o padrão; escolhas inválidas são redefinidas a ele ao salvar).
• From address: de onde os e-mails de confirmação são enviados.
• Senha SMTP: armazenada criptografada. Deixe em branco para manter a senha existente; use uma senha de app.
• E-mail de notificação de build: recebe uma mensagem quando um build tem sucesso ou falha. Deixe em branco para desabilitar.

PWA

• Habilitar PWA: gera um manifest, service worker e página de fallback offline em tempo de build.
• Short name: rótulo do ícone na tela inicial (cerca de 16 caracteres no máximo); o padrão é o nome do site.
• Cor do tema / cor de fundo: valores hex CSS que controlam o chrome do navegador e a splash screen.
• Modo de exibição: standalone, minimal-ui, fullscreen ou browser.
• Título / mensagem offline: conteúdo da página de fallback offline.

Deploy

• Deploy SSH/rsync: chave de ativação mais host, usuário, caminho remoto e caminho da chave SSH.
• Deploy S3: chave de ativação mais bucket, endpoint, região, access key e secret key. A secret key é armazenada criptografada; deixe em branco para mantê-la.

Deploys nunca executam no modo air-gap, independente dessas configurações.

Backups

• DigitalOcean Spaces: endpoint, bucket, região (padrão nyc3), access key e secret key. A secret key é armazenada criptografada; deixe em branco para mantê-la. Mudar apenas as credenciais do Spaces não dispara um rebuild.
• Agendamento: frequência do backup (off por padrão) e horário do dia (padrão 02:00).
• Verificar cada backup após criação: habilitado a menos que você explicitamente o desligue.
• Retenção local: manter os últimos N backups locais e/ou manter backups locais por N dias; 0 significa ilimitado.

Permalinks

• Prefixo de URL de posts: padrão blog. Apenas letras, dígitos e hífens sobrevivem a um salvamento; um valor em branco reverte para blog. Quando você o muda, o prefixo antigo é lembrado para que URLs antigas sejam redirecionadas automaticamente após o próximo rebuild.
• Modo de URL de idioma: como o código de idioma aparece nas URLs: path, none ou subdomain. Ele segue sua contagem de idiomas: um site monolíngue é forçado a none, um site multilíngue nunca pode ser none. Padrão path.
• Redirecionamento da home: para onde a raiz do domínio (/) redireciona, com padrão blog. Rebuild necessário após mudar.
• Cada idioma configurado também pode definir seu próprio prefixo de URL de post; limpar uma sobrescrita faz aquele idioma voltar ao padrão.

Salvar permalinks sempre dispara um rebuild.

Workflow

• Exigir aprovação: quando habilitado, mudanças de conteúdo de usuários não admin esperam aprovação de um admin antes de irem ao ar.
• E-mail de notificação de revisão: recebe notificações sobre eventos do fluxo de revisão.
• Promotion guard: compara cada build contra a última promoção limpa e pode se recusar a promover um build degradado:
  • Modo: warn (padrão: registra o problema e promove mesmo assim), enforce (descarta o staging, continua servindo o build anterior e marca o build como falha) ou off. Um build bloqueado pode ser promovido manualmente com “Promote anyway” no dashboard ou pela flag de força.
  • Limiar de queda na contagem de páginas: percentual máximo permitido de queda; padrão 80.
  • Máximo de links quebrados: aumento permitido versus o último build limpo; padrão 25.
  • Máximo de blocos não resolvidos: uma contagem absoluta. Este portão fica sem configuração até você digitar um número (incluindo 0); limpar o campo o desliga de volta.
  • Aumento máximo de problemas de acessibilidade: aumento permitido versus o último build limpo; padrão 10.
  • Forçar para além do guard nunca atualiza as baselines de qualidade; o próximo build normal ainda compara contra a última promoção limpa.

Segredos e notas de segurança

• A senha SMTP, o segredo de webhook, a secret key do deploy S3, a secret key do Turnstile, o OAuth client secret e a secret key do Spaces são armazenados criptografados em repouso e nunca devolvidos ao seu navegador ou à API em texto puro; os formulários sempre renderizam vazios e salvar em branco mantém o valor existente.
• A criptografia dos segredos armazenados depende da variável de ambiente CHINASKI_SECRET. Trocar essa variável torna valores criptografados previamente salvos impossíveis de descriptografar; salve-os novamente depois.

Redefinindo uma aba

Toda aba exceto Deploy, Permalinks e Workflow pode ser redefinida aos seus padrões a partir do controle de reset da seção. Redefinir apaga também as sobrescritas por idioma daquela seção; a tela de confirmação informa quantos valores de fato diferem dos padrões antes de você confirmar.

Nesta seção

• Configurações da Organização
• Configurações de Email
• Integração com Google Analytics
• Integração com Google Tag Manager
• Usuário do X (Twitter)
• Aviso de Cookies
• Chaves de API
• Permalinks
• Progressive Web App (PWA)
• Favicon