Référence des réglages

Chinaski stocke la configuration de son site comme des réglages : des paires clé/valeur que vous éditez sous Settings dans la zone admin (/admin/settings). Chaque sauvegarde est snapshottée, de sorte que vous pouvez voir et revisiter ce qui a changé sur l'onglet History, et l'app journalise chaque sauvegarde.

Les réglages sont organisés en onglets : General, Organization, Integrations, Security, Email, PWA, Deploy, Backups, Permalinks et Workflow (plus API Keys et Environment, qui sont des fonctionnalités entières avec leurs propres pages). Chaque onglet se sauvegarde indépendamment (seul l'onglet que vous soumettez est écrit) et une sauvegarde déclenche automatiquement un rebuild du site lorsque les valeurs modifiées affectent votre sortie publique.

General

• Nom du site : montré dans les titres du navigateur et les e-mails sortants.
• Tagline : utilisée dans les méta descriptions, les résumés du feed RSS et le sous-titre de page par défaut.
• Copyright du footer : ajouté à l'année © dans le pied de page. Laissez vide pour omettre.
• Noindex : interdit l'indexation par robots.txt et ajoute noindex à chaque page.
• Minifier le HTML : compacte les blancs dans le HTML construit. Activé par défaut ; désactivez pour conserver l'espacement d'origine pendant le débogage.
• Image par défaut du site : utilisée comme fallback og:image sur les pages et posts sans image à eux. Laissez vide pour omettre.
• Langues actives : codes ISO 639-1 séparés par des virgules (ex. en,es,pt). Les codes sont validés à la sauvegarde. Vous ne pouvez pas retirer une langue qui a encore des pages, des posts ou des blocks ; supprimez ou réassignez d'abord ce contenu. Sauvegardez ici avant de changer la langue par défaut.
• Langue par défaut : langue de repli pour le build statique ; doit être présente dans Langues actives. Ramenée silencieusement à la liste active si non.
• Fuseau horaire du site : un nom IANA (ex. UTC, America/New_York). Les dates de publication planifiée sont interprétées dans ce fuseau. Les valeurs invalides retombent sur UTC à la sauvegarde.
• URL du site : utilisée pour les URL absolues dans sitemap.xml et le RSS. Incluez le protocole ; pas de slash final (un est retiré à la sauvegarde).
• Posts par page : nombre de posts sur l'index du blog et les archives de catégories. Borné à la plage de 1 à 100.
• Préfixe d'URL de base : préfixe pour les liens du build statique (ex. /prefix) ; laissez vide pour un root-relative. Une variable d'environnement CHINASKI_URL_BASE l'outrepasse.
• URL de base du CMS : URL publique de ce CMS. Permet au shortcode [form:slug​] d'intégrer un formulaire en direct quand le formulaire ne fait pas partie du build statique. Une variable d'environnement CHINASKI_CMS_URL l'outrepasse.
• Titre de l'index du blog : en-tête et titre de page pour la liste du blog ; vide utilise « Blog ». Chaque langue configurée peut avoir son propre override.

Integrations

• URL du webhook de build / URL du webhook de publication / Secret de webhook : notifications webhook sortantes. L'URL doit être une adresse http(s) publique. Le secret est stocké chiffré ; laissez vide pour garder la valeur actuelle.
• GA4 ID / GTM ID : snippets d'analytics. Tous deux sont retirés des pages construites en mode air-gap.
• Twitter site.
• Cookie notice : interrupteur d'activation, texte de l'avis, URL de la politique de cookies, et libellés des boutons accepter/refuser. Chaque langue configurée peut outrepasser le texte de l'avis et les libellés.

Security

Les champs Turnstile et SSO n'apparaissent que lorsque le mode air-gap est désactivé.

• Contact sécurité : doit être une adresse mailto: ou une URL https://, sinon la sauvegarde est rejetée.
• URL de la politique de sécurité.
• Turnstile site key / secret key : Cloudflare Turnstile pour les pages de connexion et de formulaire. Le secret est stocké chiffré ; laissez vide pour garder la valeur actuelle.
• Seuil d'échecs : déclenche une alerte dans le journal d'événements lorsque les échecs d'authentification journalisés (tentatives bloquées incluses) des 10 dernières minutes atteignent ce compte. Défaut 20. C'est uniquement un seuil d'alerte ; le lockout de connexion lui-même est fixe : 60 secondes après 5 échecs consécutifs, 5 minutes après 10, et 30 minutes après 20, par IP.
• Rate limit des clés API : requêtes par minute ; de 1 à 10000, défaut 100.
• Auto-inscription : autoriser les inscriptions depuis la page de connexion. Désactivée par défaut.
• Expiration des mots de passe : jours avant expiration des mots de passe ; 0 désactive l'expiration.
• SSO (OAuth) : interrupteur d'activation plus client ID, client secret, URL d'autorisation, URL de token et URL userinfo. Le client secret est stocké chiffré ; laissez vide pour le garder.

Email

• SMTP host, port, encryption, username : choisissez l'encryption parmi STARTTLS, SSL ou aucune (STARTTLS est le défaut ; les choix invalides y sont réinitialisés à la sauvegarde).
• Adresse From : d'où sont envoyés les e-mails de confirmation.
• Mot de passe SMTP : stocké chiffré. Laissez vide pour garder le mot de passe existant ; utilisez un mot de passe d'application.
• E-mail de notification de build : reçoit un message quand un build réussit ou échoue. Laissez vide pour désactiver.

PWA

• Activer la PWA : génère un manifest, un service worker et une page de fallback hors ligne au moment du build.
• Nom court : libellé de l'icône de l'écran d'accueil (environ 16 caractères au plus) ; par défaut le nom du site.
• Couleur de thème / couleur de fond : valeurs hex CSS contrôlant le chrome du navigateur et le splash screen.
• Mode d'affichage : standalone, minimal-ui, fullscreen ou browser.
• Titre / message hors ligne : contenu de la page de fallback hors ligne.

Deploy

• Deploy SSH/rsync : interrupteur d'activation plus host, utilisateur, chemin distant et chemin de clé SSH.
• Deploy S3 : interrupteur d'activation plus bucket, endpoint, région, access key et secret key. La secret key est stockée chiffrée ; laissez vide pour la garder.

Les deploys ne s'exécutent jamais en mode air-gap, indépendamment de ces réglages.

Backups

• DigitalOcean Spaces : endpoint, bucket, région (nyc3 par défaut), access key et secret key. La secret key est stockée chiffrée ; laissez vide pour la garder. Changer uniquement les credentials Spaces ne déclenche pas de rebuild.
• Schedule : fréquence de backup (off par défaut) et heure du jour (02:00 par défaut).
• Vérifier chaque backup après création : activé sauf désactivation explicite de votre part.
• Rétention locale : garder les N derniers backups locaux et/ou garder les backups locaux N jours ; 0 signifie illimité.

Permalinks

• Préfixe d'URL des posts : blog par défaut. Seules les lettres, les chiffres et les tirets survivent à une sauvegarde ; une valeur vide revient à blog. Quand vous le changez, l'ancien préfixe est mémorisé pour que les anciennes URL se redirigent automatiquement après le prochain rebuild.
• Mode d'URL de langue : comment le code de langue apparaît dans les URL : path, none ou subdomain. Il suit votre nombre de langues : un site monolingue est forcé à none, un site multilingue ne peut jamais être none. Par défaut path.
• Redirect d'accueil : où la racine du domaine (/) se redirige, blog par défaut. Rebuild requis après changement.
• Chaque langue configurée peut aussi définir son propre préfixe d'URL de posts ; effacer un override fait retomber cette langue sur le défaut.

Sauvegarder les permalinks déclenche toujours un rebuild.

Workflow

• Require approval : quand activé, les changements de contenu des utilisateurs non admin attendent l'approbation admin avant d'aller en ligne.
• E-mail de notification de review : reçoit les notifications des événements du workflow de review.
• Promotion guard : compare chaque build à la dernière promotion propre et peut refuser de promouvoir un build dégradé :
  • Mode : warn (défaut : loguer le problème et promouvoir quand même), enforce (écarter le staging, continuer à servir le build précédent, et faire échouer le build), ou off. Un build bloqué peut être promu manuellement avec « Promote anyway » dans le dashboard ou le flag de force.
  • Seuil de chute du nombre de pages : pourcentage de chute maximal autorisé ; défaut 80.
  • Max de liens cassés : augmentation autorisée par rapport au dernier build propre ; défaut 25.
  • Max de blocks non résolus : un compte absolu. Cette porte est non configurée tant que vous n'entrez pas un nombre (0 inclus) ; effacer le champ la désactive à nouveau.
  • Max d'augmentation des problèmes d'accessibilité : augmentation autorisée par rapport au dernier build propre ; défaut 10.
  • Forcer au-delà du guard ne met jamais à jour les baselines de qualité : le prochain build normal compare toujours à la dernière promotion propre.

Secrets et notes de sécurité

• Le mot de passe SMTP, le secret de webhook, la secret key S3 de deploy, la secret key Turnstile, le client secret OAuth et la secret key Spaces sont stockés chiffrés au repos et ne sont jamais renvoyés à votre navigateur ni à l'API en clair : les formulaires se rendent toujours vides et sauvegarder du vide garde la valeur existante.
• Le chiffrement des secrets stockés dépend de la variable d'environnement CHINASKI_SECRET. Faire tourner cette variable rend indéchiffrables les valeurs chiffrées précédemment sauvegardées ; re-sauvegardez-les ensuite.

Réinitialiser un onglet

Chaque onglet sauf Deploy, Permalinks et Workflow peut être réinitialisé à ses défauts depuis le contrôle de réinitialisation de sa section. Réinitialiser efface aussi les overrides par langue de cette section ; l'écran de confirmation vous dit combien de valeurs diffèrent réellement des défauts avant que vous ne validiez.

Dans cette section

• Réglages d'organisation
• Réglages e-mail
• Intégration Google Analytics
• Intégration Google Tag Manager
• Handle X (Twitter)
• Avis sur les cookies
• Clés API
• Permaliens
• Progressive Web App (PWA)
• Favicon