Migration depuis Pelican

Pelican est un générateur de sites statiques open-source construit en Python.

Principales similitudes entre Pelican et Astro

Pelican et Astro partagent certaines similitudes qui vous aideront à migrer votre projet :

Pelican et Astro sont tous deux des générateurs de sites statiques, idéalement adaptés aux sites web axés sur le contenu comme les blogs.
Pelican et Astro possèdent tous deux une prise en charge intégrée pour écrire en Markdown, y compris les propriétés YAML du frontmatter pour les métadonnées des pages. Cependant, Astro a très peu de propriétés de frontmatter réservées par rapport à Pelican. Même si beaucoup de propriétés existantes dans votre frontmatter Pelican ne seront pas « spéciales » dans Astro, vous pouvez continuer à utiliser vos fichiers Markdown et les valeurs du frontmatter existants.

Principales différences entre Pelican et Astro

Lorsque vous recréez votre site Pélican avec Astro, vous remarquerez quelques différences importantes :

Pelican prend en charge l’écriture de contenu en Markdown et en reStructuredText (.rst). Astro prend en charge les fichiers créer des pages à partir de Markdown et MDX, mais ne prend pas en charge reStructuredText.
Pelican utilise des fichiers HTML et la syntaxe Jinja pour la création de modèles. La syntaxe Astro est un ensemble de HTML semblable à JSX. Tout HTML valide est une syntaxe .astro valide.
Pelican a été conçu pour créer des sites web riches en contenu, comme des blogs, et possède des fonctionnalités de blog intégrées que vous aurez à créer vous-même dans Astro. Au lieu de cela, Astro offre certaines de ces fonctionnalités incluses dans un thème de blog officiel.

Passer de Pelican à Astro

Pour convertir un site de documentation Pelican en Astro, commencez par notre thème de documentation Starlight comme modèle de démarrage officiel, ou explorez d’autres thèmes communautaires dans notre vitrine.

Vous pouvez passer un argument --template à la commande create astro pour démarrer un nouveau projet Astro avec l’un de nos modèles officiels. Vous pouvez aussi démarrer un nouveau projet à partir de n’importe quel dépôt Astro existant sur GitHub.

npm create astro@latest -- --template starlight

pnpm create astro@latest --template starlight

yarn create astro --template starlight

Apportez vos fichiers de contenu Markdown existants en créant des pages en Markdown. Vous pouvez toujours profiter du routage par fichier en copiant ces documents du dossier content/ de Pelican dans src/pages/ dans Astro. Vous pouvez consulter la structure de projet d’Astro pour savoir où les fichiers doivent être placés.

Pelican a peut-être géré une grande partie de la mise en page et des métadonnées de votre site pour vous. Vous souhaiterez peut-être en savoir plus sur la création de mises en page Astro en tant qu’enveloppes de page Markdown pour voir comment gérer vous-même la création de modèles dans Astro, y compris la balise <head> votre page.

Comme Pelican, Astro dispose de nombreux modules d’extension qui étendent ses fonctionnalités. Explorez la liste officielle des intégrations pour ajouter des fonctionnalités telles que la prise en charge de MDX et trouvez des centaines d’autres intégrations gérées par la communauté dans le répertoire des intégrations Astro. Vous pouvez même utiliser l’API des intégrations d’Astro pour créer votre propre intégration personnalisée afin d’étendre les fonctionnalités de votre projet.

Pour convertir d’autres types de sites, comme un portfolio ou un blog, consultez d’autres modèles de départ officiels sur astro.new. Vous trouverez un lien vers le dépôt GitHub de chaque projet, ainsi que des liens en un clic pour ouvrir un projet fonctionnel dans les environnements de développement en ligne IDX, StackBlitz, CodeSandbox et Gitpod.