Snippets

Um snippet é um fragmento de código bruto. HTML, JavaScript, CSS, que o Chinaski injeta no head ou body das suas páginas construídas. É a ferramenta certa para rastreadores de analytics, tags de verificação, estilos personalizados e scripts pequenos. (Para conteúdo visível e incorporável, use blocks em vez disso.)

Head ou body

Todo snippet tem uma posição: snippets head são injetados antes do </head> de fechamento de cada página construída; snippets body vão antes de </body>. A injeção procura a última tag correspondente em cada documento, então templates incomuns não conseguem deslocar o código.

Snippets globais

Snippets podem ser globais: esses são injetados automaticamente em toda página, post e listagem de blog que for construída; eles não precisam de atribuição por item. Snippets não globais são anexados a páginas ou posts específicos a partir do editor daquela página ou post (eles aparecem ali como entradas atribuíveis, os globais intencionalmente não aparecem nessas listas).

Um snippet pode ter como alvo um idioma, ou ficar sem idioma para ser injetado em todo lugar. Em qualquer página ambos os tipos se combinam: os direcionados mais os sem idioma, com deduplicação para que um snippet não possa ser adicionado duas vezes à mesma página por ambas as rotas.

Ordem e repetição

Snippets de head sempre vêm antes dos snippets de body. Dentro de cada grupo, os snippets globais são injetados antes dos atribuídos a páginas ou posts. O mesmo código nunca é injetado duas vezes na mesma página, mesmo que um snippet seja tanto global quanto atribuído.

Escopo por idioma

Cada snippet pode ser limitado a um idioma. Quando você deixa o idioma vazio, ele se aplica a todos os idiomas. Snippets não globais atribuídos a uma página ou post viajam junto com o idioma daquele item.

Instâncias air-gapped

No modo air-gap, snippets contendo referências externas (scripts, stylesheets, iframes ou imagens apontando para fora do servidor) são removidos na injeção, mantendo o site construído totalmente operável offline.

Snippets sensíveis à privacidade

Há um sinalizador que marca um snippet como contendo código de rastreamento ou analytics. Snippets sinalizados:

• recebem um badge "Sensitive" na lista de snippets, para que revisores possam identificá-los;
• são sempre registrados no histórico de revisões, então alterações neles deixam um rastro de auditoria.

Edição e revisões

A tela Snippets lista cada snippet com os badges Global / Por página e Sensitive. Cada snippet mantém revisões: restaurar uma revisão anterior restaura o código como ele era então. Excluir permanentemente um snippet exige uma confirmação explícita, e existe um fluxo de exclusão com restauração ao lado dele.

Importação e exportação

Snippets suportam exportação e importação em JSON e CSV, individualmente ou em lote, a mesma maquinaria de importação/exportação dos blocks, para que você possa movê-los entre instâncias sem redigitar.