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 AstroJekyll 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 AstroLorsque vous reconstruisez votre site Jekyll dans Astro, vous remarquerez quelques différences importantes :
-
Jekyll étant avant tout une plate-forme de blogs, plusieurs fonctionnalités de blog sont intégrées, mais vous devrez peut-être les créer vous-même dans Astro. Vous pouvez également choisir un thème de modèle de démarrage de blog qui inclut ces fonctionnalités. Par exemple, Jekyll dispose d’un support intégré pour les tags et les catégories que vous trouverez dans plusieurs thèmes de blog Astro, mais qui n’est pas inclus dans un projet Astro minimal.
-
Jekyll utilise les modèles Liquid pour les éléments de mise en page réutilisables et la création de modèles. Astro utilise des fichiers JSX
.astropour les modèles et les composants. Tout fichier.astropeut être un composant, une mise en page ou une page entière, et peut importer et afficher n’importe quel autre composant Astro. Vous pouvez également construire en utilisant d’autres composants de framework d’interface utilisateur (par exemple React, Svelte, Vue, Solid) ainsi que du contenu ou des métadonnées provenant d’autres fichiers de votre projet, comme Markdown ou MDX.
Passer de Jekyll à Astro
Titre de la section Passer de Jekyll à AstroPour 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.
npm create astro@latest -- --template blogpnpm create astro@latest --template blogyarn create astro --template blogApportez 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.
