HUGO 数据迁移指引
本指引提供了从 HUGO
文件迁移至 Halo 2.x
的方案。
注意事项
HUGO 是一个十分强大与灵活的静态站点生成器,但没有提供统一的导出格式。本插件无意实现一个完整的 HUGO 解析器,仅支持其基础功能。注意:
- 不支持本地附件文件(包括图片)迁移,引用的在线资源(例如外部图床)不受影响。
- 不支持 HUGO 的模板属性文件
_index.md
。 - 仅支持下列 matter:
title
,slug
,draft
,categories
,tags
,date
。 - 仅处理文档内容,不解析 HUGO 配置文件。
- 本插件使用独立的 markdown 解析器,渲染效果可能和 HUGO 以及 Halo 中安装的 markdown 编辑器不同。
迁移
- 请先手动将 HUGO 项目根目录下的
content
文件夹打包为zip
压缩包。注意不要上传整个 HUGO 目录。 - 点击左侧菜单的迁移进入迁移页面。
- 在选择渠道步骤中,选择 HUGO,点击下一步。
- 在导入数据步骤中,点击 选择文件 按钮,选择刚才打包的文件,之后点击下一步。
- 按提示配置内容类别映射。确认后将显示解析出的内容。点击下一步进入最终确认。
- 在待迁移数据步骤中,可以再次审查待迁移的数据,审查结束后点击 执行导入 后,耐心等待即可,数据迁移完成后会有弹窗进行提示。