Skip to content

从雨果迁移

雨果 是一个基于 Go 构建的开源静态站点生成器。

¥Hugo is an open-source static site generator built on Go.

Hugo 和 Astro 之间的主要相似之处

Section titled Hugo 和 Astro 之间的主要相似之处

¥Key Similarities between Hugo and Astro

Hugo 和 Astro 有一些相似之处,可以帮助你迁移项目:

¥Hugo and Astro share some similarities that will help you migrate your project:

  • Hugo 和 Astro 都是现代静态站点生成器,非常适合 内容驱动的网站 之类的博客。

  • Hugo 和 Astro 都可以让你 在 Markdown 中创作你的内容。但是,Hugo 包含几个特殊的 frontmatter 属性,并允许你用 YAML、TOML 或 JSON 编写 frontmatter。即使许多现有的 Hugo frontmatter 属性在 Astro 中不会是 “special”,你也可以继续使用现有的 Markdown 文件和 YAML frontmatter 值。

  • Hugo 和 Astro 都允许你使用各种 集成和外部包 来增强你的网站。

Hugo 和 Astro 之间的主要区别

Section titled Hugo 和 Astro 之间的主要区别

¥Key Differences between Hugo and Astro

当你在 Astro 中重建 Hugo 站点时,你会注意到一些重要的差异:

¥When you rebuild your Hugo site in Astro, you will notice some important differences:

¥Switch from Hugo to Astro

要将 Hugo 博客转换为 Astro,请从我们的博客主题入门模板开始,或者在我们的 主题展示 中探索更多社区博客主题。

¥To convert a Hugo blog to Astro, start with our blog theme starter template, or explore more community blog themes in our theme showcase.

你可以将 --template 参数传递给 create astro 命令,以使用我们的官方启动器之一启动一个新的 Astro 项目。或者,你可以 从 GitHub 上任何现有的 Astro 存储库启动一个新项目

¥You can pass a --template argument to the create astro command to start a new Astro project with one of our official starters. Or, you can start a new project from any existing Astro repository on GitHub.

Terminal window
npm create astro@latest -- --template blog

将你现有的 Markdown(或 MDX,带有我们的可选集成)文件作为内容添加到 创建 Markdown 或 MDX 页面。你可能需要将 frontmatter 转换为 YAML,因为 Astro 只允许在这些文件中使用 YAML frontmatter。

¥Bring your existing Markdown (or MDX, with our optional integration) files as content to create Markdown or MDX pages. You may need to convert your frontmatter to YAML, since Astro only allows YAML frontmatter in these files.

要继续在 Markdown 内容中使用动态内容,例如变量、表达式或 UI 组件,请添加 Astro 的可选 MDX 集成,并将现有 Markdown 文件转换为 MDX 页面。MDX 支持 YAML frontmatter,因此你可以保留现有的 frontmatter 属性。但是,你必须将任何短代码语法替换为 MDX 自己的语法,它允许 JSX 表达式和/或组件导入。

¥To continue to use dynamic content such as variables, expressions or UI components within your Markdown content, add Astro’s optional MDX integration and convert your existing Markdown files to MDX pages. MDX supports YAML frontmatter, so you can keep your existing frontmatter properties. But, you must replace any shortcode syntax with MDX’s own syntax, which allows JSX expressions and/or component imports.

要转换其他类型的网站,例如作品集或文档网站,请参阅 astro.new 上的更多官方入门模板。你将找到每个项目的 GitHub 存储库的链接,以及用于在 StackBlitz、CodeSandbox 和 Gitpod 在线开发环境中打开工作项目的一键链接。

¥To convert other types of sites, such as a portfolio or documentation site, see more official starter templates on astro.new. You’ll find a link to each project’s GitHub repository, as well as one-click links to open a working project in StackBlitz, CodeSandbox and Gitpod online development environments.

¥Community Resources

More migration guides

Astro 中文网 - 粤ICP备13048890号