从 Pelican 迁移

发布于 2024-06-05 21:19:56 字数 8980 浏览 0 评论 0 收藏 0

Pelican 是一个开源的使用 Python 构建的静态网站生成器。

Pelican 与 Astro 的主要相似点

Pelican 和 Astro 的一些相似点会帮助你完成迁移。

Pelican 和 Astro 都是静态网站生成器，尤其适合内容驱动的网站，例如博客。
Pelican 和 Astro 都内置支持 Markdown文档，包括页面元数据的 frontmatter YAML 属性。但是 Astro 中预留的 frontmatter 比 Pelican 少得多。尽管很多 Pelican 内生效的 frontmatter 属性在 Astro 中并不会生效，但你仍然可以使用使用 Markdown 和 frontmatter 。

当使用 Astro 重新构建 Pelican 网站时，你会注意到一些重要的差异。

Pelican 支持 Markdown 和 reStructured Text(.rst)。Astro 可以从 Markdown 和 MDX 文件创建页面，但是不支持 reStructured Text。
Pelican 使用 HTML 格式和 Jinja 语法创建模板，而Astro 语法是一个类似于 JSX 的 HTML 超集，也就是说任何的 HTML 都符合 Astro 语法规则。
Pelican 为构建内容丰富的网站而设计，例如博客，它的博客特性 Astro 是不提供的，你必须自己构建。但是，Astro 也会提供一些特性包括官方博客主题。

为了将 Pelican 文档转换成 Astro，你可以从我们的 Starlight 文档主题模板开始，或者从主题展示里面的社区主题开始。

你可以通过传入--template参数到create astro命令开启一个 Astro 项目，并选择我们提供的某个模板。或者，你也可以从一个 Astro Github 仓库开始你的项目。

npm create astro@latest -- --template starlight

pnpm create astro@latest --template starlight

yarn create astro --template starlight

导入你现有的 Markdown 文档创建 Markdown 页面。你可以将Pelican content/文件夹中的文档复制到 Astro 中的 src/pages/ 文件夹，从而开启基于文件的路由。你或许会想阅读 Astro 项目结构去了解什么文件应该放置于什么位置。

Pelican 会帮你处理网站的布局和元数据。你或许会想阅读创建 Astro 布局封装 Markdown 从而了解如何在 Astro 中自己管理模板，包括页面的<head>。

为了迁移其他类型的网站，例如一个作品集或者一个博客，请进入 astro.new 查看更多的网站模板，你会找到模板对应的 GitHub 仓库链接和在线开发环境链接(StackBlitz, CodeSandbox and Gitpod)。