Import et export

Déplacer du contenu vers et depuis Chinaski est un ensemble d'outils concrets : un importeur Markdown pour les fichiers avec front matter, un import/export JSON/CSV pour le contenu structuré, la création en masse, et une file de jobs asynchrones pour les très grosses opérations. Cette page parcourt chacun à la suite.

Importer des fichiers Markdown

Si votre contenu existe déjà sous forme de fichiers .md (d'un autre CMS, d'un site statique, ou d'un outil d'écriture), l'import Markdown l'incorpore comme brouillons éditables :

Choisissez le type de contenu cible (pages ou posts) et la langue, puis téléchargez jusqu'à 100 fichiers en un seul lot (taille totale jusqu'à 40 MiB).
Chaque fichier peut porter un bloc de front matter YAML en tête avec titre, slug, langue, catégorie et méta description. Le front matter est facultatif ; en son absence, l'importeur prend le titre du premier H1 du document (en le retirant du corps pour éviter un doublement de titre) ou, à défaut, du nom du fichier.
Tout est converti en HTML à l'import, et tout H1 de premier niveau restant dans le corps est rétrogradé en H2 pour que la structure de la page reste valide dans le système de titres de l'éditeur.
Tout est importé non publié : passez en revue l'écran de résultats (il liste les succès/erreurs par fichier), puis publiez quand vous êtes satisfait.
Les collisions de slug sont gérées automatiquement (my-page-2, etc.) ; les conflits à l'intérieur d'un lot n'écrasent jamais silencieusement.
Le front matter doit être des lignes clés/valeurs plates : une liste imbriquée sous title: est rejetée avec une erreur spécifique nommant le champ.
Un front matter malformé fait échouer uniquement ce fichier ; le reste du lot continue.
Si le serveur n'a pas les modules optionnels du pipeline Markdown, le formulaire d'import vous le dit avant que vous ne sélectionniez des fichiers (un admin peut les installer).

Imports structurés (JSON)

Pour une migration produite par machine (depuis un export, un script personnalisé, ou l'API), utilisez les imports JSON :

Chaque zone de contenu que vous pouvez exporter (pages, posts, catégories, nav, documents, redirects, média et plus) accepte un fichier tableau d'objets avec les champs de cette entité.
Jusqu'à 5 000 lignes par import et un fichier de 4 MiB.
Une étape d'aperçu montre les résultats par ligne avant toute écriture.
Lors de l'import réel, vous pouvez choisir de mettre à jour les éléments existants au lieu de seulement en créer de nouveaux : le clétage est par entité (pages clétées sur slug+langue, catégories sur nom+langue et slug+langue, etc.).
Les lignes sont validées par rapport aux langues du site et à vos propres permissions par langue avant insertion.

Création en masse à partir d'une liste

Pour créer rapidement de nombreux éléments courts (un lot de pages simples), l'écran de création en masse accepte une liste collée de titres/contenus et les crée tous, avec des suffixes de collision de slug appliqués de la même manière que l'importeur Markdown.

Exporter votre contenu

Champs complets, JSON ou CSV : la liste des pages et la liste des posts proposent chacune un export JSON (l'enregistrement de contenu complet, corps, champs SEO, planification, clés de traduction) et CSV ; tous deux peuvent être filtrés par langue et statut publié/brouillon, et des éléments individuels peuvent être exportés seuls.
Exports auxiliaires : catégories, navigation, métadonnées de documents, redirects et métadonnées de média ont chacun leur export ; utilisateurs, journal d'audit et votre calendrier de planification offrent des téléchargements CSV et ics le cas échéant.
Les fichiers CSV portent une marque d'ordre des octets UTF-8, ils s'ouvrent donc proprement dans Excel.
Les exports n'incluent que ce que votre compte a le droit de gérer ; les éditeurs exportent leur propre périmètre de contenu.

Tous ces exports décrivent des métadonnées et du texte. Les fichiers média, les fichiers de documents eux-mêmes, et la base de données dans son intégralité sont couverts par les sauvegardes, voir Backup & Recovery.

Migrer en toute sécurité

Exportez depuis la source ancienne (JSON d'une instance Chinaski antérieure ou CSV d'un tableur).
Importez via la route correspondante avec l'aperçu activé ; lisez les résultats par ligne.
Lancez l'import réel avec la mise à jour des existants activée si vous relancez après correction de problèmes.
Tout aboutit en contenu : les imports ne suppriment jamais rien, donc des lignes défectueuses ne peuvent jamais effacer ce qui existe déjà ; vous nettoyez manuellement.
Reconstruisez le site après un import important (les imports peuvent le déclencher ; les très gros lots peuvent s'exécuter comme jobs d'arrière-plan avec suivi de progression via l'API).

Pour les très grosses opérations

L'API REST accepte des jobs par lots : soumettez la liste d'éléments, puis interrogez le statut du job (progression, erreurs, résultats) plutôt que de garder un navigateur ouvert. Le serveur MCP fourni expose ces opérations comme outils pour le travail par lots assisté par IA.

À quoi ressemblent l'entrée et la sortie

Tout traverse dans le format JSON propre de Chinaski (ou CSV columnaire) ; il n'y a pas d'importeur style WordPress WXR/dialecte propriétaire : JSON en entrée, JSON en sortie, la même forme à l'export qu'à l'import. En pratique : votre contenu n'est jamais piégé ; sortez le JSON, transformez-le comme bon vous semble, ramenez-le, ou sauvegardez simplement l'instance entière.