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 ont tous deux un support intégré pour écrire en Markdown, y compris des propriétés YAML pour les métadonnées des pages. Cependant, Astro a très peu de propriétés frontmatter réservées par rapport à Pelican. Même si beaucoup de vos propriétés frontmatter Pelican existantes ne seront pas “spéciales” dans Astro, vous pouvez continuer à utiliser vos fichiers Markdown et valeurs frontmatter existants.

Principales différences entre Pelican et Astro

Lorsque vous reconstruisez votre site Pélican dans Astro, vous remarquerez quelques différences importantes :

Pelican prend en charge l’écriture de contenu en Markdown et en texte reStructuré (.rst). Astro prend en charge les fichiers créer des pages à partir de Markdown et MDX, mais ne prend pas en charge le texte reStructuré.
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 construire des sites web riches en contenu, comme des blogs, et possède des fonctionnalités de blog intégrées que vous devriez construire 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 modèle de démarrage officiel Starlight, 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 de l’acheminement par fichier en copiant ces documents du dossier content/ de Pelican dans src/pages/ dans Astro. Vous pouvez consulter la structure du projet Astro pour savoir où les fichiers doivent être placés.

Pelican a peut-être pris en charge une grande partie de la mise en page de votre site et des métadonnées pour vous. Vous pouvez lire Construire des modèles Astro comme des enveloppes de page Markdown pour voir comment gérer vous-même les modèles dans Astro, y compris votre page <head>.

Comme Pelican, Astro dispose de nombreux plugins 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 Intégration 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 StackBlitz, CodeSandbox et Gitpod.