Aller au contenu

Migration depuis Jekyll

Jekyll est un générateur de sites statiques basé sur Ruby.

Principales similitudes entre Jekyll et Astro

Titre de la section Principales similitudes entre Jekyll et Astro

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

  • Jekyll et Astro sont tous deux des générateurs de sites statiques, couramment utilisés pour créer des blogs.

  • Jekyll et Astro vous permettent tous deux de rédiger votre contenu en Markdown et en HTML. Jekyll et Astro fournissent tous deux des propriétés YAML spéciales pour la mise en page et les brouillons non publiés. Vous pouvez continuer à utiliser vos fichiers Markdown existants dans Astro.

  • Jekyll et Astro utilisent tous deux le routage par fichier pour créer des pages à partir de vos articles de blog. Astro fournit un répertoire spécial src/pages/ pour toutes les pages et tous les articles. Jekyll utilise un répertoire spécial similaire appelé _posts/ pour vos articles de blog en Markdown, mais les pages de votre site peuvent exister ailleurs. La création de nouveaux articles de blog devrait vous sembler familière.

Principales différences entre Jekyll et Astro

Titre de la section Principales différences entre Jekyll et Astro

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

Pour convertir un blog Jekyll en Astro, commencez par notre modèle de démarrage de thème de blog, ou explorez d’autres thèmes de blog communautaires dans notre vitrine de thèmes.

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

Fenêtre de terminal
npm create astro@latest -- --template blog

Apportez vos fichiers Markdown existants comme contenu pour créer des pages Markdown, en utilisant une mise en page Astro Markdown au lieu d’un modèle Liquid.

Une grande partie du contenu de vos pages HTML existantes peut être convertie en pages Astro, et vous pourrez également utiliser des variables, des expressions de type JSX et des importations de composants directement dans vos modèles HTML.

Astro n’a pas de propriété permalink qui accepte les espaces réservés. Vous pouvez avoir besoin d’en savoir plus sur le routage des pages d’Astro si vous voulez conserver votre structure d’URL existante. Vous pouvez également envisager de définir des redirections chez un hébergeur comme Netlify.

Pour convertir d’autres types de sites, tels qu’un site de portfolio ou de documentation, consultez les 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.

Plus de guides sur les migrations

Contribuer

Comment pouvons-nous vous aider ?

Créer une issue GitHub

Le moyen le plus rapide d'alerter notre équipe d'un problème.

Communauté