Guides & Recettes

Des parcours pas à pas pour des objectifs courants, écrits comme des recettes « atteignez votre objectif » plutôt que comme de la documentation de fonctionnalités. Chaque guide existe comme un parcours complet ; les sous-pages liées couvrent les références sous-jacentes.

Migration

• Migrer depuis WordPress: les chemins vérifiés qui fonctionnent aujourd'hui : import Markdown-avec-front-matter, allers-retours JSON/CSV, ou points de terminaison en masse de l'API REST ; re-téléversement des médias ; gestion de l'export de redirections ; la liste de ce qui ne migre pas automatiquement.

Multilingue

• Mettre en place un site multilingue: l'ordre réel des décisions : langues → mode URL → permaliens → menus/textes par langue, avec les règles de suppression de langue.

Déploiement

• Domaine personnalisé & TLS: pointer le DNS, servir le TLS (automatique sur Caddy ; certbot sur nginx), et faire correspondre le proxy au bind du CMS.
• Déployer sur Caddy: le Caddyfile livré adapté par instance, y compris l'inclusion des redirections et la politique de cache.
• Déployer sur nginx: les trois placeholders, les deux routes à proxifier impérativement, la synchronisation des roots.
• Déployer sur Netlify: publier la sortie statique sur Netlify, avec la mise en garde _redirects.

Recettes de contenu

• Mettre en place un blog: les réglages de publication à définir avant le premier post (permaliens, posts par page, flux).
• Ajouter un formulaire de contact: création du formulaire → intégration (ou URL autonome) → SMTP (et éventuellement Turnstile) → tests des soumissions ; les réglages e-mail/webhook vivent sur les pages des formulaires.
• Construire un thème de zéro: la route recommandée (cloner, puis personnaliser, puis activer) et où vit la boîte à outils d'authoring.

Identité

• Mettre en place le SSO: placer un fournisseur d'identité OAuth/OIDC devant la connexion admin, les champs à configurer, et le comportement des nouveaux comptes.

Ce que les guides supposent

• Getting Started est fait: l'instance est installée, le mot de passe de configuration changé, et l'admin joignable.
• Les guides complètent, ne remplacent pas, la référence : chaque étape pointe vers la page de référence qui documente les valeurs qu'elle définit. Quand un guide et une référence se contredisent un jour, la référence fait foi.