Aller au contenu

Migrer depuis Hugo

Hugo est un générateur de sites statiques open-source construit sur Go.

Principales similitudes entre Hugo et Astro

Titre de la section Principales similitudes entre Hugo et Astro

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

  • Hugo et Astro sont tous deux des générateurs de sites statiques modernes, idéalement adaptés aux sites web axés sur le contenu comme les blogs.

  • Hugo et Astro vous permettent tous deux de rédiger votre contenu en Markdown. Cependant, Hugo inclut plusieurs propriétés spéciales de frontmatter et vous permet d’écrire du frontmatter en YAML, TOML ou JSON. Même si beaucoup de vos propriétés Hugo frontmatter existantes ne seront pas “spéciales” dans Astro, vous pouvez continuer à utiliser vos fichiers Markdown existants et vos valeurs YAML frontmatter.

  • Hugo et Astro vous permettent tous deux d’améliorer votre site avec une variété d’intégrations et de paquets externes.

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

Pour convertir un blog Hugo 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 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 (ou MDX, avec notre intégration optionnelle) comme contenu à créer des pages Markdown ou MDX. Il se peut que vous deviez convertir votre frontmatter en YAML, car Astro n’autorise que le frontmatter YAML dans ces fichiers.

Pour continuer à utiliser du contenu dynamique tel que des variables, des expressions ou des composants d’interface utilisateur dans votre contenu Markdown, ajoutez l’intégration MDX facultative d’Astro et convertissez vos fichiers Markdown existants en pages MDX. MDX prend en charge le frontmatter YAML, vous pouvez donc conserver vos propriétés de frontmatter existantes. Mais vous devez remplacer toute syntaxe de shortcode par la syntaxe propre à MDX, qui autorise les expressions JSX et/ou les importations de composants.

Pour convertir d’autres types de sites, comme un portfolio ou un site de documentation, consultez les modèles de démarrage 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é