Skip to content

HUGO 数据迁移指引

本指引提供了从 HUGO 文件迁移至 Halo 2.x 的方案。

注意事项

HUGO 是一个十分强大与灵活的静态站点生成器,但没有提供统一的导出格式。本插件无意实现一个完整的 HUGO 解析器,仅支持其基础功能。注意:

  1. 不支持本地附件文件(包括图片)迁移,引用的在线资源(例如外部图床)不受影响。
  2. 不支持 HUGO 的模板属性文件 _index.md
  3. 仅支持下列 matter: title, slug, draft, categories, tags, date
  4. 仅处理文档内容,不解析 HUGO 配置文件。
  5. 本插件使用独立的 markdown 解析器,渲染效果可能和 HUGO 以及 Halo 中安装的 markdown 编辑器不同。

迁移

  1. 请先手动将 HUGO 项目根目录下的 content 文件夹打包为 zip 压缩包。注意不要上传整个 HUGO 目录。
  2. 点击左侧菜单的迁移进入迁移页面。
  3. 在选择渠道步骤中,选择 HUGO,点击下一步。
  4. 在导入数据步骤中,点击 选择文件 按钮,选择刚才打包的文件,之后点击下一步。
  5. 按提示配置内容类别映射。确认后将显示解析出的内容。点击下一步进入最终确认。
  6. 在待迁移数据步骤中,可以再次审查待迁移的数据,审查结束后点击 执行导入 后,耐心等待即可,数据迁移完成后会有弹窗进行提示。