Glossaire
Courtes définitions des termes que vous rencontrerez en lisant cette documentation. Les entrées qui disposent d'une page de sujet plus approfondie la nomment à la fin.
instance
Une copie en cours d'exécution de Chinaski servant un site : son propre service systemd, son propre fichier de base de données SQLite, ses propres réglages. Plusieurs instances (par client, par étape) peuvent partager un serveur via le modèle d'unités par instance (voir *Quickstart* et *The Database*).
CMS
L'application d'administration privée où vous rédigez le contenu. Elle stocke tout dans SQLite et, en production, ne se lie qu'à une adresse de loopback, si bien que les visiteurs ne l'atteignent jamais.
builder
Le processus séparé qui transforme votre base de données de contenu en site statique : il lit la base de données, rend vos gabarits et écrit du HTML simple sur disque. Les builds sont explicites : tableau de bord, webhook, API ou ligne de commande, jamais des effets de bord automatiques.
staging et live
Chaque build est écrit dans un répertoire de staging à côté de la sortie, puis basculé dans la sortie live seulement quand le build est terminé et a passé ses contrôles de sécurité. Un build échoué laisse le site précédent servir sans être touché.
block
Un fragment réutilisable de contenu structuré, intégré dans n'importe quelle page ou billet avec {{block:name}}. Les types simples prennent des champs à plat ; les types structurés stockent des lignes répétées en JSON avec un éditeur de lignes. Voir *Blocks*.
stack
Une séquence de blocs traitée comme une seule unité, duplicable, exportable, avec historique de révisions et diffs. Conçue pour les grandes sections qui se répètent d'une page à l'autre.
snippet
HTML/JavaScript/CSS brut injecté dans le <head> ou le <body> des pages construites, pour des tags d'analytique, des jetons de vérification, des styles personnalisés. Les snippets peuvent être globaux (chaque page) ou assignés à des pages et billets individuels. Voir *Snippets*.
slot
Un emplacement de menu nommé dans un thème (par exemple header ou footer), découvert à partir des marqueurs d'espace de travail déclarés par vos gabarits, puis proposé dans l'administration de Navigation. Voir *Navigation* et la référence *Themes*.
theme
Le jeu de gabarits qui rend votre site : un thème actif par instance. Les thèmes fournissent les gabarits de page, de billet et de listing, et exposent les types de blocs et les réglages du site comme variables de gabarit (voir la doc intégrée *Themes*).
media
Images et fichiers envoyés avec leurs métadonnées (texte alternatif, légendes, dimensions). Le dossier média est synchronisé dans l'arborescence de sortie de chaque langue au moment du build.
air-gap mode
L'état de déploiement sans réseau sortant. Son activation affiche une bannière dans la barre latérale et change le comportement là où les connexions comptent : le code des snippets externes est retiré, les restaurations de sauvegardes distantes sont désactivées, et les intégrations qui communiquent vers l'extérieur sont indisponibles. L'installation hors ligne est également prise en charge via un installateur fourni.
render cache et dirty set
Comment les builds restent rapides : le contenu inchangé est reconnu et sauté (pas de re-rendu), tandis que les éléments édités, les transitions programmées depuis le dernier build et les pages dépendant de blocs ou de stacks modifiés sont reconstruits.
build fingerprint
Un hash de la configuration affectant le build et des gabarits du thème. Quand quelque chose de global change (un réglage, le thème) l'empreinte diverge et le build suivant retombe à un rebuild complet pour ne rien manquer.
promotion guard et builds bloqués
Le contrôle « toujours en ligne » entre un build terminé et la publication : un build qui ferait chuter une grande part des pages ou exploser les liens cassés est *bloqué*, et le site précédent continue de servir. Un « Promote anyway » explicite vous permet de le contourner pour un seul build (voir *Build Failures*).
redirect pattern
Une redirection dont l'ancien slug se termine par *, correspondant à tout chemin sous ce préfixe, avec $1 substituant le suffixe correspondant dans la destination. Les redirections par motif sont servies comme pages de redirection plutôt que comme règles de configuration serveur.
instance secret (CHINASKI_SECRET)
La clé aléatoire de 32 octets ou plus, requise au démarrage : elle signe les cookies de session et chiffre les identifiants stockés. Elle est exclue des exports de réglages et ne quitte jamais votre serveur.
placeholder account et /setup
Les installations neuves démarrent avec un mot de passe administrateur de remplacement. Chaque requête d'administration redirige vers /setup tant qu'un vrai mot de passe n'est pas défini, après quoi la page de configuration disparaît (404). Réinitialiser un mot de passe administrateur réarme ce même flux.
manager
Le Chinaski Manager (github.com/bigjohncobb/chinaski-manager) : un panneau de contrôle séparé et livré, pour provisionner et piloter de nombreuses instances CMS sur un seul serveur : tenants, cycle de vie des instances (build/déploiement/retour arrière/démarrage/arrêt), rattachement de domaines avec régénération automatique du serveur web, sauvegardes par instance et du plan de contrôle, et contrôles de santé. Ses « tenants » groupent les instances au niveau du manager ; il ne réunit pas plusieurs sites dans une seule base de données (voir *Instances*).