Importer un site existant

menestrel import migre un site Astro déjà en place. Il scanne src/content/ et src/data/, mappe chaque fichier sur ton schéma, envoie les images une seule fois par contenu identique, puis crée et publie les entrées. Les slugs sont verrouillés : les URLs de production ne bougent pas.

Note

L’import mappe vers un schéma existant, il ne le génère pas. Décris tes collections dans cms.config.ts et fais relire ce schéma en revue avant l’import : c’est la source de vérité.

1. Décrire le schéma

   Le squelette produit par menestrel init est un bon point de départ. Ajuste les champs pour qu’ils collent à ton frontmatter et à tes fichiers JSON.

2. Prévisualiser sans rien écrire

   --dry-run scanne, mappe et compte les dégradations sans toucher au serveur ni aux médias.

   npx menestrel import --dry-run

3. Lancer l’import

   npx menestrel import --yes

   L’import est reprenable : si le process est interrompu, relance-le, les entrées déjà créées sont sautées et les images déjà envoyées ne repartent pas.

Ce qui est repris, ce qui ne l’est pas

• Le corps Markdown devient un champ richtext ; un titre de niveau 1 ou un tableau sont signalés puis dégradés, jamais perdus en silence.
• Les images relatives et celles de /public sont envoyées et dédupliquées par empreinte ; l’alt du Markdown est conservé.
• L’import est monolingue (locale par défaut). Après l’import, l’admin est la seule source de vérité : les fichiers source ne sont jamais ré-importés.

Une fois le site migré, menestrel export reste disponible à tout moment pour ressortir tes contenus en Markdown et JSON. Voir la référence CLI.