Référence
Matériel de référence exhaustif : les faits dont un développeur ou un opérateur a besoin, sans narration. Six documents dans cette section, tous construits de la même façon : chaque fait vérifié contre le code source à la version qu'ils décrivent.
Dans cette section
- Référence build.pl: le builder statique : garde-fous d'invocation, cycle de vie (staging → contrôles → manifest → promote), règles full vs incrémental, le promotion guard, les codes de sortie et le tableau des variables d'environnement.
- Référence cms.pl: l'application CMS : exigences de démarrage, la structure de dispatch admin/API, les tâches planifiées, et les helpers que les autres outils réutilisent.
- Variables d'environnement: chaque variable
CHINASKI_*, son défaut et son effet, y compris le trio requis (CHINASKI_SECRET,CHINASKI_DB,CHINASKI_OUTPUT) et les ensembles propres au MCP/form-suite. - Référence des réglages: chaque clé de réglage par onglet, avec les défauts, les règles de validation, et lesquels déclenchent un rebuild (plus lesquels ne peuvent pas être réinitialisés).
- Référence du schéma: chaque table et colonne de la base de données : ce que chacune stocke, les contraintes, et comment les tables se relient.
- Référence des templates: les variables que reçoivent chaque template de site/block, l'inventaire des partials, et les règles de sécurité.
Comment lire ces pages
Les pages de référence sont délibérément laconiques, des tableaux et des règles, pas de tutoriels. Si vous voulez l'histoire derrière un fait (pourquoi le promotion guard existe, pourquoi il n'y a pas de système de plugins), la section Philosophy couvre cela ; les sections Authoring/Admin couvrent les workflows.
Conventions
- Les faits sont énoncés comme des faits ; les cas limites dignes d'un signalement sont en ligne dans la rangée pertinente.
- Là où un même comportement possède à la fois un contrôle par champ de réglage et par variable d'environnement, les deux sont listés avec leur précédence (les variables env gagnent).
- Les nombres de la référence (limites, défauts, timeouts) sont vérifiés dans le code, quand la doc et le code venaient à se contredire, faites confiance au code, et déposez une note pour que les deux soient corrigés.
Également dans Référence
Référence de builder/build.pl : cycle de vie du build, variables d'environnement, garde-fous et réglages pour lancer le builder à la main.
Lancez le démon cms.pl en développement, en production et hors ligne : CHINASKI_SECRET, l'unité systemd et les outils en ligne de commande.
Référence des variables d'environnement de Chinaski : où les définir, le CHINASKI_SECRET obligatoire et les réglages facultatifs.
Tous les réglages de Chinaski par onglet, de General à Workflow : le rôle de chaque clé, le fonctionnement des sauvegardes et le rebuild déclenché.
Ce que contient la base de données de Chinaski, le fichier SQLite unique, et les comportements de suppression logique que tout admin doit connaître.
Référence des templates d'un thème Chinaski : les fichiers .tt requis et facultatifs, les variables reçues et l'emplacement des thèmes.