From 96ca3e2c50008f21e6d1ba10fe4056e2d58152de Mon Sep 17 00:00:00 2001 From: Ryan Wang Date: Mon, 30 Jan 2023 14:38:12 +0800 Subject: [PATCH] docs: update documentation for migrate from Halo 1.x (#171) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Halo 1.5 / 1.6 的迁移插件已经更新：https://github.com/halo-sigs/plugin-migrate/releases/tag/v1.1.0 同步修改使用文档。 Fixes https://github.com/halo-dev/docs/issues/170 /kind documentation ```release-note None ``` --- docs/getting-started/migrate-from-1.x.md | 11 +++++++---- .../version-2.0/getting-started/migrate-from-1.x.md | 4 ++++ .../version-2.1/getting-started/migrate-from-1.x.md | 11 +++++++---- 3 files changed, 18 insertions(+), 8 deletions(-) diff --git a/docs/getting-started/migrate-from-1.x.md b/docs/getting-started/migrate-from-1.x.md index 2e221b1..c2bb29d 100644 --- a/docs/getting-started/migrate-from-1.x.md +++ b/docs/getting-started/migrate-from-1.x.md @@ -7,14 +7,17 @@ description: 从 Halo 1.x 迁移的完整指南和注意事项 - Halo 版本必须为 1.5.x 或 1.6.x。如果不满足，需要先升级到 1.5.x 或 1.6.x 版本。 - Halo 2.0 不兼容 1.x 的主题，建议在升级前先查询你正在使用的主题是否已经支持 2.0。你可以访问 [halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo) 查阅目前支持的主题。 -- Halo 2.0 暂时没有 Markdown 编辑器，**在迁移之后会丢失 Markdown 编辑器的内容**，仅保留已渲染的 HTML 内容以供富文本编辑器使用。如果你对 Markdown 有强需求，建议先暂缓迁移。 +- Halo 2.0 目前没有内置 Markdown 编辑器，如果需要重新编辑迁移后的文章，需要额外安装 Markdown 编辑器插件。目前社区已经提供了以下插件： + - + - - 暂时不支持友情链接、日志、图库的数据迁移，如果你在 1.x 版本中使用了这些功能，建议先暂缓迁移。 -- Halo 2.0 的外置云存储目前仅有阿里云 OSS 的插件，如果你对其他外部云存储有强需求，建议先暂缓迁移。 +- Halo 2.0 不在内置外部云存储的支持。需要安装额外的插件，目前官方已提供： + - + - - 关于附件，目前仅支持将本地附件代理，不支持在后台管理，也不支持迁移外部云存储的附件。如果你对外部云存储的附件有强需求，建议先暂缓迁移。 - 在迁移过程中不会保留旧版本的用户数据，迁移完成之后，关于文章等数据的关联都将改为 Halo 2.0 的新用户。 -- 迁移插件目前仅支持 Chrome 浏览器，且必须要求站点是 HTTPS 协议（本地环境不受限制）。 - 为了防止直接升级 2.0 导致 1.x 的数据受到破坏，我们已经将工作目录由 `~/.halo` 变更为 `~/.halo2`。 -- 目前 Halo 2.0 仅提供 Docker 部署方式，没有提供可执行 JAR 包。 +- 目前 Halo 2.0 仅提供 Docker 部署方式，没有提供可执行 JAR 包，但可以自编译，请参考 [构建](../developer-guide/core/build.md) 文档 - 可以考虑先在本地运行一个 Halo 2.0，模拟一下导入，检查导入后是否满足要求。 如果遇到了迁移过程中的问题，也可以向我们提交 Issue: ，以上暂不支持的功能我们也会陆续完善。 diff --git a/versioned_docs/version-2.0/getting-started/migrate-from-1.x.md b/versioned_docs/version-2.0/getting-started/migrate-from-1.x.md index 2e221b1..ecce980 100644 --- a/versioned_docs/version-2.0/getting-started/migrate-from-1.x.md +++ b/versioned_docs/version-2.0/getting-started/migrate-from-1.x.md @@ -3,6 +3,10 @@ title: 从 Halo 1.x 迁移 description: 从 Halo 1.x 迁移的完整指南和注意事项 --- +:::warning 注意 +最新的迁移插件可能已经不适用于当前文档，建议更新 Halo 和所有插件到最新版本之后，按照最新的迁移文档进行迁移：[从 Halo 1.x 迁移](/getting-started/migrate-from-1.x) +::: + 因为 Halo 2.0 的底层架构变动，无法兼容 1.x 的数据，导致无法平滑升级，所以需要进行数据迁移。为此，我们提供了从 Halo 1.5 / 1.6 版本迁移的插件。在进行迁移之前，**有几点注意事项和要求，如果你目前无法满足，建议先暂缓迁移。** - Halo 版本必须为 1.5.x 或 1.6.x。如果不满足，需要先升级到 1.5.x 或 1.6.x 版本。 diff --git a/versioned_docs/version-2.1/getting-started/migrate-from-1.x.md b/versioned_docs/version-2.1/getting-started/migrate-from-1.x.md index 2e221b1..c2bb29d 100644 --- a/versioned_docs/version-2.1/getting-started/migrate-from-1.x.md +++ b/versioned_docs/version-2.1/getting-started/migrate-from-1.x.md @@ -7,14 +7,17 @@ description: 从 Halo 1.x 迁移的完整指南和注意事项 - Halo 版本必须为 1.5.x 或 1.6.x。如果不满足，需要先升级到 1.5.x 或 1.6.x 版本。 - Halo 2.0 不兼容 1.x 的主题，建议在升级前先查询你正在使用的主题是否已经支持 2.0。你可以访问 [halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo) 查阅目前支持的主题。 -- Halo 2.0 暂时没有 Markdown 编辑器，**在迁移之后会丢失 Markdown 编辑器的内容**，仅保留已渲染的 HTML 内容以供富文本编辑器使用。如果你对 Markdown 有强需求，建议先暂缓迁移。 +- Halo 2.0 目前没有内置 Markdown 编辑器，如果需要重新编辑迁移后的文章，需要额外安装 Markdown 编辑器插件。目前社区已经提供了以下插件： + - + - - 暂时不支持友情链接、日志、图库的数据迁移，如果你在 1.x 版本中使用了这些功能，建议先暂缓迁移。 -- Halo 2.0 的外置云存储目前仅有阿里云 OSS 的插件，如果你对其他外部云存储有强需求，建议先暂缓迁移。 +- Halo 2.0 不在内置外部云存储的支持。需要安装额外的插件，目前官方已提供： + - + - - 关于附件，目前仅支持将本地附件代理，不支持在后台管理，也不支持迁移外部云存储的附件。如果你对外部云存储的附件有强需求，建议先暂缓迁移。 - 在迁移过程中不会保留旧版本的用户数据，迁移完成之后，关于文章等数据的关联都将改为 Halo 2.0 的新用户。 -- 迁移插件目前仅支持 Chrome 浏览器，且必须要求站点是 HTTPS 协议（本地环境不受限制）。 - 为了防止直接升级 2.0 导致 1.x 的数据受到破坏，我们已经将工作目录由 `~/.halo` 变更为 `~/.halo2`。 -- 目前 Halo 2.0 仅提供 Docker 部署方式，没有提供可执行 JAR 包。 +- 目前 Halo 2.0 仅提供 Docker 部署方式，没有提供可执行 JAR 包，但可以自编译，请参考 [构建](../developer-guide/core/build.md) 文档 - 可以考虑先在本地运行一个 Halo 2.0，模拟一下导入，检查导入后是否满足要求。 如果遇到了迁移过程中的问题，也可以向我们提交 Issue: ，以上暂不支持的功能我们也会陆续完善。