Démarrage

Tout ce qu'il faut pour aller de zéro à une page publiée : ce qu'est Chinaski, de quelle machine il a besoin, comment l'installation fonctionne, et les premières choses à cliquer une fois dans l'administration. Chaque section est courte et visée à l'étape qu'elle couvre ; la référence approfondie vit dans les pages liées.

Le chemin de lecture

1. Qu'est-ce que Chinaski: la version en un paragraphe : un CMS auto-hébergé + builder de site statique. Le contenu dans SQLite, l'administration en Perl, le site public en HTML simple servi par un serveur web.
2. Comment ça marche: le modèle à deux programmes (application CMS + builder statique), pourquoi les builds sont explicites, et pourquoi le serveur web ne parle jamais au CMS dans le chemin public.
3. Prérequis: la liste honnête : un serveur Debian/Ubuntu, Perl 5.26+, SQLite ; des conseils de dimensionnement et les deux chemins d'installation (one-liner en ligne ou bundle hors ligne).
4. Installation: les vraies étapes d'installation.
5. Quickstart: le chemin de cinq minutes : installer, changer le mot de passe de configuration, créer une page, builder, publier.
6. Visite de l'administration: une carte de l'administration : où vivent les pages, billets, blocs, stacks, formulaires, médias, documents, réglages et écrans de santé.
7. Votre première page: le parcours d'une liste de pages vide à une page publiée sur le site construit (brouillon → publier → builder → vérifier).
8. Glossaire: le vocabulaire (blocs, stacks, snippets, promotion guard, corbeille vs suppression) pour que le reste de la doc se lise plus vite.

Les trois décisions avant de commencer

Quelques minutes de choix économisent du retravail ensuite. Ce sont les seules décisions de configuration qui façonnent réellement une nouvelle instance :

• Nom d'instance: un serveur peut exécuter plusieurs instances Chinaski côte à côte (chinaski@1, chinaski@prod, ...). Le nom apparaît dans les chemins d'installation, les noms de services et les cibles de sauvegarde pour toujours.
• Langues: la liste de langues configurée pilote les formes d'URL (path vs none vs subdomain) et les arborescences par langue. Posez le jeu de langues avant l'import de contenu : chaque ligne de contenu appartient à exactement une langue.
• Hors ligne ou connecté: le commutateur air-gap est activé par défaut dans les installations neuves. Décidez avant le premier démarrage si l'instance est censée atteindre Internet (e-mail, webhooks, vérifications de mise à jour, Spaces) ou ne devrait jamais le faire ; le mode air-gap est livré activé par défaut pour une raison, et le désactiver est un choix délibéré.

Ce que « installé » signifie ici

Chinaski est auto-hébergé par conception : vous possédez le serveur, la base de données et les sauvegardes. L'installateur fait le gros du travail (paquets système, dépendances, un utilisateur système chinaski, une base de données SQLite initialisée, un fichier env avec un secret généré et une unité systemd), et la première requête vous amène sur une page de configuration obligatoire où vous remplacez le mot de passe administrateur de remplacement (vérifié : 12 caractères ou plus avec majuscules, minuscules et chiffres). Après cela, l'interface d'administration est à vous ; rien ne téléphone à la maison, et aucune autre étape d'installation n'est requise.

Où la documentation continue

• Concepts: l'architecture et le modèle de contenu derrière le builder.
• Authoring: le travail de contenu quotidien : pages, billets, blocs, stacks, formulaires, médias, documents.
• Deploy & Backup: servir le site public (nginx/Caddy), le garder à jour, et le garder récupérable.
• Troubleshooting & API: références opérationnelles quand quelque chose ne s'aligne pas, et l'interface machine pour les scripts et les outils IA.