Comment exporter les contenus EmDash en CSV ou JSON
Choisissez le bon format et la bonne version de contenu, et distinguez export de collection et sauvegarde complète.
Choisissez l’export selon le besoin
Utilisez le CSV pour relire des lignes dans un tableur. Choisissez le JSON quand la préservation des valeurs stockées est prioritaire. Le plugin Import/Export de Sneaps propose les deux formats depuis l’administration.
Commencez par préciser l’objectif : relecture éditoriale, corrections en masse, transfert vers un autre projet ou copie avant un import. Ce choix détermine la collection, le statut de publication et la version à inclure. Un fichier apparemment complet dans un tableur peut ne pas contenir les modifications non publiées que vous vouliez conserver.
Sélectionnez les entrées et leur version
Ouvrez Import/Export, passez sur Export et sélectionnez une collection. Vous pouvez choisir toutes les entrées, les entrées publiées ou les brouillons, puis Latest ou Published only. Ce sont deux décisions distinctes : statut de publication et version du contenu ne sont pas interchangeables.
Latest correspond à ce qui apparaît dans l’éditeur, y compris les modifications non publiées. Published only correspond à la version en ligne. Pour une copie avant modification, Latest est généralement la version à examiner. Pour un audit des contenus visibles, Published only peut être plus pertinent. Nommez le fichier avec la collection, la date et la version.
Le CSV est pratique, mais transforme les valeurs
Le CSV est un format texte. Le plugin convertit le texte riche en Markdown et les listes ou objets en texte JSON. Un tableur devient pratique pour la relecture, mais vérifiez son traitement des dates, nombres, encodages et zéros initiaux à l’ouverture et à l’enregistrement.
L’export protège aussi contre les formules de tableur en ajoutant une apostrophe à certaines cellules. Ne retirez pas ces caractères systématiquement : ils sont intentionnels. L’importeur gère cette protection lors de la réimportation. Gardez un export original intact et modifiez une copie de travail.
Le JSON préserve la structure, pas tout le site
Le JSON conserve les valeurs sous leur forme stockée. Il convient à l’examen de champs structurés et aux transferts de données. Il est moins confortable pour une relecture dans un tableur, mais évite la conversion CSV du texte riche et des objets.
Aucun des deux formats ne constitue une sauvegarde complète d’EmDash. Les données de collection ne recréent pas les templates Astro, la configuration, les secrets, les comptes ou le stockage média. Distinguez aussi export et prise en charge à l’import : un export JSON peut contenir des valeurs de champs que ce plugin ne sait pas encore importer. Gardez une sauvegarde de base et de médias distincte.
Réimportez sans écraser la mauvaise version
Avant de réimporter un fichier, vérifiez son origine et sa version. Réimporter un export Published only peut remplacer des modifications non publiées récentes par l’ancien texte en ligne. Lisez l’aperçu plutôt que de considérer un export comme inoffensif à réappliquer.
Testez quelques entrées, conservez leurs IDs ou slugs et décidez si vous voulez créer, modifier ou les deux. Contrôlez locale et publication. Médias, références, repeaters et blocks exigent un traitement séparé dans cette version. Un parcours reproductible conserve le fichier utilisé et contrôle le résultat enregistré.
Préparer un import CSVGardez des exports faciles à contrôler
La limite actuelle est de 20 000 entrées par export. Pour un projet volumineux, organisez les exports par collection et vérifiez les volumes au lieu de considérer un téléchargement réussi comme la preuve que tout est présent. Un modèle vide fournit les noms de colonnes pour préparer un import.
Conservez les exports dans un emplacement privé adapté : ils peuvent contenir des textes non publiés ou d’autres informations internes. Le plugin traite les données sur votre propre site, sans analytics externe ni service de stockage séparé. Une fois le fichier téléchargé, sa gestion vous appartient.