Aller au contenu
EN/FR
Contact
Tous les articles
Guides pratiquessneaps

Comment importer un fichier CSV dans EmDash

Préparez une collection, vérifiez un import CSV et mettez à jour vos contenus avec le plugin gratuit Import/Export de Sneaps.

Commencez par la collection, pas le tableau

Vous pouvez importer des contenus CSV dans EmDash avec @sneaps/import-export. Installez le plugin natif, choisissez une collection, chargez le fichier puis vérifiez l’aperçu avant d’enregistrer. L’import transfère des entrées dans une structure existante ; il ne crée pas les templates de pages.

Avant de préparer des centaines de lignes, décidez où vont les contenus. Une collection d’articles peut prévoir un titre, un slug, un extrait et un corps de texte. Vérifiez les champs obligatoires et leurs noms réels. Les exemples utilisent des noms indicatifs : le schéma de votre collection fait référence.

Installez le plugin natif Import/Export

Ajoutez le package au projet, puis enregistrez importExport() dans la configuration EmDash existante de votre fichier astro.config.mjs. Conservez vos autres intégrations et plugins. Recompilez et déployez après avoir modifié la configuration.

Une entrée Import/Export apparaît alors dans la barre latérale de l’administration. Ce parcours concerne les administrateurs disposant des autorisations d’import et de gestion des contenus nécessaires. L’installation passe par npm, et non par le registre des plugins sandboxés.

pnpm add @sneaps/import-export

// astro.config.mjs
import { defineConfig } from "astro/config";
import emdash from "emdash/astro";
import { importExport } from "@sneaps/import-export";

export default defineConfig({
  integrations: [
    emdash({
      plugins: [importExport()],
      // Preserve your other EmDash settings and plugins.
    }),
  ],
});

Préparez un petit CSV adapté aux champs

Utilisez une ligne d’en-tête avec des noms uniques et un encodage UTF-8. Nommez les colonnes d’après les champs de la collection ; utilisez slug ou id pour identifier les entrées existantes. Exporter un modèle vide depuis le plugin constitue un bon point de départ : il fournit les colonnes de la collection.

Commencez par deux ou trois lignes représentatives. Incluez un titre accentué, de la ponctuation et un texte riche si vos données en contiennent. Une virgule dans une valeur nécessite les guillemets CSV. Gardez les slugs cohérents entre les imports pour qu’une correction éditoriale ne crée pas une nouvelle entrée.

title,slug,excerpt
"A practical guide",practical-guide,"An introduction, with a comma"
"Second article",second-article,"Another example"

Lisez l’aperçu avant de lancer

Ouvrez l’onglet Import, sélectionnez la collection et chargez le fichier. Vérifiez le format détecté, les correspondances de champs, le nombre de créations et de modifications et les avertissements. Rien n’est enregistré à cette étape. Choisissez le format de texte riche pour les colonnes concernées et examinez les premières lignes.

Cette version n’importe pas les champs image, fichier, référence, repeater ou blocks. Traitez-les séparément au lieu de supposer qu’une URL de média deviendra une image téléchargée. Si un champ obligatoire manque, corrigez le fichier ou les correspondances avant de poursuivre.

Choisissez comment enregistrer les entrées

Pour un premier test, enregistrer en brouillon facilite la relecture. Choisissez si l’import doit créer et modifier des entrées ou uniquement créer. Le plugin cherche une correspondance par id, puis par slug, en tenant compte de la locale lorsqu’elle est fournie.

Une cellule CSV vide signifie absence de valeur ; elle ne vide pas un champ existant lors d’une modification. Si vous voulez supprimer le contenu d’un champ, vérifiez-le dans EmDash plutôt que de compter sur une cellule vide. Exportez les contenus existants avant une modification en masse pour comparer le résultat avec l’état précédent.

Lancez l’import et contrôlez le résultat

Gardez l’onglet ouvert pendant l’import. Examinez les lignes en échec et téléchargez leur rapport d’erreur. Vérifiez le nombre d’entrées, quelques enregistrements, le rendu du texte riche et les pages réelles avant publication. Un enregistrement réussi n’est qu’une partie du transfert.

Les limites documentées sont de 8 Mio et 5 000 lignes par import. Découpez les jeux plus volumineux en lots clairement nommés et testez le premier avant de continuer. Si un slug appartient à une entrée dans la corbeille, résolvez le conflit avant de réessayer. Le guide d’export complète ce parcours.

Guide d’export CSV / JSON

Sources et documentation

Consulter la roadmap

À lire aussi

Guides pratiques

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.

Lire l’article
Guides pratiques

Comment générer une image de couverture IA dans EmDash

Un parcours éditorial avec Image Generator : choisir une direction, générer une couverture et la vérifier avant publication.

Lire l’article
Guides pratiques

Installer un plugin EmDash : npm ou registre ?

Comprenez les modes d’installation, vérifiez les prérequis et installez le bon plugin pour votre projet EmDash.

Lire l’article
Guides pratiques

Migrer de Webflow vers EmDash : les points SEO à vérifier

Préparez les URL, contenus, médias et redirections avant de basculer votre site Webflow vers Astro et EmDash.

Lire l’article
Guides pratiques

EmDash vs Webflow : lequel choisir pour un site de contenu ?

Comparez édition, contrôle du frontend, maintenance et migration avant de choisir le CMS de votre prochain site.

Lire l’article
Lancement produit

Import/Export pour EmDash est disponible.

Notre deuxième plugin est sur npm : un outil natif gratuit pour transférer les contenus de vos collections en CSV et JSON.

Lire l’article
Dans les coulisses

Petits plugins. Une grande idée.

Pourquoi nous créons des outils ciblés pour les besoins quotidiens des sites EmDash.

Lire l’article
Notes produit

Une couverture qui commence par vos mots.

Découvrez Image Generator, le premier plugin sneaps publié pour EmDash.

Lire l’article
Roadmap

Une roadmap pensée pour les sorties utiles.

Comment nous organisons le catalogue, des intégrations rapides aux outils natifs plus ambitieux.

Lire l’article