Snippets
Un snippet est un fragment de code brut (HTML, JavaScript, CSS) que Chinaski injecte dans le head ou le body de vos pages construites. C'est le bon outil pour les trackers d'analytique, les balises de vérification, les styles personnalisés et les petits scripts. (Pour du contenu visible et incorporable, utilisez plutôt des blocks.)
Head ou body
Chaque snippet a une position : les snippets head sont injectés avant le </head> fermant de chaque page construite ; les snippets body vont avant </body>. L'injection cherche la balise correspondante dernière dans chaque document, pour que des templates inhabituels ne puissent pas déplacer le code.
Snippets globaux
Les snippets peuvent être globaux : ceux-là sont injectés automatiquement dans chaque page, post et listing de blog construit ; ils n'exigent pas d'affectation par élément. Les snippets non globaux sont attachés à des pages ou posts spécifiques depuis l'éditeur de cette page ou de ce post (ils y apparaissent comme entrées attribuables ; les globaux n'y apparaissent volontairement pas). Un snippet peut cibler une langue, ou être laissé sans langue pour injecter partout. Sur une page donnée, les deux types se combinent : les ciblés plus les sans langue, dédupliqués pour qu'un snippet ne puisse pas être ajouté deux fois à la même page par les deux routes.
Ordre et répétition
Les snippets head viennent toujours avant les snippets body. À l'intérieur de chaque groupe, les snippets globaux sont injectés avant ceux affectés à une page ou un post. Le même code n'est jamais injecté deux fois sur la même page même si un snippet est à la fois global et affecté.
Périmètre de langue
Chaque snippet peut être limité à une seule langue. Quand vous laissez la langue vide, il s'applique à travers toutes les langues. Les snippets non globaux affectés à une page ou un post suivent la langue de cet élément.
Instances air-gapped
En mode air-gap, les snippets contenant des références externes (scripts, feuilles de style, iframes, ou images pointant hors du serveur) sont retirés à l'injection, gardant le site construit entièrement opérable hors ligne.
Snippets sensibles à la confidentialité
Un marqueur désigne un snippet comme contenant du code de suivi ou d'analytique. Les snippets marqués :
- obtiennent un badge « Sensitive » dans la liste des snippets, pour que les revoyeurs puissent les repérer ;
- sont toujours enregistrés dans l'historique des révisions, pour que les modifications les concernant laissent une piste d'audit.
Édition et révisions
L'écran Snippets liste chaque snippet avec les badges Global / Par page et Sensitive. Chaque snippet garde des révisions : restaurer une révision antérieure restaure le code tel qu'il était alors. La suppression définitive d'un snippet exige une confirmation explicite, et un flux de suppression avec restauration existe à ses côtés.
Import et export
Les snippets prennent en charge l'export et l'import JSON et CSV, individuellement ou en masse, la même mécanique d'import/export que les blocks, donc vous pouvez les déplacer entre instances sans les retaper.