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. 在待迁移数据步骤中,可以再次审查待迁移的数据,审查结束后点击 执行导入 后,耐心等待即可,数据迁移完成后会有弹窗进行提示。