halo/docs
1
0
Fork 0
mirror of https://github.com/halo-dev/docs.git synced 2025-10-15 22:59:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: update halo official website url (#433)

Browse Source 
更新 Halo 官网的地址。

```release-note
None
```
This commit is contained in:
Ryan Wang
2024-10-15 14:31:21 +08:00
committed by GitHub
parent afef951e88
commit 5ce83249d2
49 changed files with 164 additions and 164 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/developer-guide/core/code-style.md
View File

@@ -23,7 +23,7 @@ Halo 添加了 checkstyle 插件，来保证每位提交者代码的风格保持
- 导入 checkstyle.xm 配置：
![image.png](https://halo.run/upload/2020/2/image-0c7a018e73f74634a534fa3ba8806628.png)
![image.png](https://www.halo.run/upload/2020/2/image-0c7a018e73f74634a534fa3ba8806628.png)
- 选择 `./config/checkstyle/checkstyle.xml` 配置文件，点击确定即可。

4
docs/developer-guide/plugin/examples/todolist.md
View File

@@ -33,8 +33,8 @@ description: 这个例子展示了如何开发 Todo List 插件
requires: ">=2.0.0"
author:
name: halo-dev
website: https://halo.run
logo: https://halo.run/logo
website: https://www.halo.run
logo: https://www.halo.run/logo
homepage: https://github.com/halo-dev/plugin-starter#readme
repo: https://github.com/halo-dev/plugin-starter
issues: https://github.com/halo-dev/plugin-starter/issues

26
docs/getting-started/migrate-from-1.x.md
View File

@@ -6,17 +6,17 @@ description: 从 Halo 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 版本。
- Halo 2.0 不兼容 1.x 的主题，建议在升级前先查询你正在使用的主题是否已经支持 2.0。你可以访问 [halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo) 或 [应用市场](https://halo.run/store/apps?type=THEME) 查阅目前支持的主题。
- Halo 2.0 不兼容 1.x 的主题，建议在升级前先查询你正在使用的主题是否已经支持 2.0。你可以访问 [halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo) 或 [应用市场](https://www.halo.run/store/apps?type=THEME) 查阅目前支持的主题。
- Halo 2.0 目前没有内置 Markdown 编辑器，如果需要重新编辑迁移后的文章，需要额外安装 Markdown 编辑器插件。目前社区已经提供了以下插件：
- StackEdit：[https://halo.run/store/apps/app-hDXMG](https://halo.run/store/apps/app-hDXMG)
- ByteMD：[https://halo.run/store/apps/app-HTyhC](https://halo.run/store/apps/app-HTyhC)
- StackEdit：[https://www.halo.run/store/apps/app-hDXMG](https://www.halo.run/store/apps/app-hDXMG)
- ByteMD：[https://www.halo.run/store/apps/app-HTyhC](https://www.halo.run/store/apps/app-HTyhC)
- Halo 2.0 不再内置友情链接、日志、图库等模块，需要安装额外的插件，目前官方已提供：
- 链接管理：[https://halo.run/store/apps/app-hfbQg](https://halo.run/store/apps/app-hfbQg)
- 图库：[https://halo.run/store/apps/app-BmQJW](https://halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://halo.run/store/apps/app-SnwWD](https://halo.run/store/apps/app-SnwWD)
- 链接管理：[https://www.halo.run/store/apps/app-hfbQg](https://www.halo.run/store/apps/app-hfbQg)
- 图库：[https://www.halo.run/store/apps/app-BmQJW](https://www.halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://www.halo.run/store/apps/app-SnwWD](https://www.halo.run/store/apps/app-SnwWD)
- Halo 2.0 不再内置外部云存储的支持。需要安装额外的插件，目前官方已提供：
- S3（兼容国内主流的云存储）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
- 阿里云 OSS：[https://halo.run/store/apps/app-wCJCD](https://halo.run/store/apps/app-wCJCD)
- S3（兼容国内主流的云存储）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
- 阿里云 OSS：[https://www.halo.run/store/apps/app-wCJCD](https://www.halo.run/store/apps/app-wCJCD)
- 在迁移过程中不会保留旧版本的用户数据，迁移完成之后，关于文章等数据的关联都将改为 Halo 2.0 的新用户。
- 为了防止直接升级 2.0 导致 1.x 的数据受到破坏，我们已经将工作目录由 `~/.halo` 变更为 `~/.halo2`。
- 目前 Halo 2.0 仅提供 Docker 部署方式，没有提供可执行 JAR 包，但可以自编译，请参考 [构建](../developer-guide/core/build.md) 文档
@@ -54,11 +54,11 @@ description: 从 Halo 1.x 迁移的完整指南和注意事项
在迁移过程中，需要提前安装必要的插件：
- 站点迁移：[https://halo.run/store/apps/app-TlUBt](https://halo.run/store/apps/app-TlUBt)
- 链接管理：[https://halo.run/store/apps/app-hfbQg](https://halo.run/store/apps/app-hfbQg)
- 图库：[https://halo.run/store/apps/app-BmQJW](https://halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://halo.run/store/apps/app-SnwWD](https://halo.run/store/apps/app-SnwWD)
- S3（如果需要迁移存在云存储的附件，需要安装）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
- 站点迁移：[https://www.halo.run/store/apps/app-TlUBt](https://www.halo.run/store/apps/app-TlUBt)
- 链接管理：[https://www.halo.run/store/apps/app-hfbQg](https://www.halo.run/store/apps/app-hfbQg)
- 图库：[https://www.halo.run/store/apps/app-BmQJW](https://www.halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://www.halo.run/store/apps/app-SnwWD](https://www.halo.run/store/apps/app-SnwWD)
- S3（如果需要迁移存在云存储的附件，需要安装）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
## 配置存储策略

6
docs/intro.md
View File

@@ -8,8 +8,8 @@ slug: /
---
<p align="center">
<a href="https://halo.run" target="_blank" rel="noopener noreferrer">
<img width="100" src="https://halo.run/logo" alt="Halo logo" />
<a href="https://www.halo.run" target="_blank" rel="noopener noreferrer">
<img width="100" src="https://www.halo.run/logo" alt="Halo logo" />
</a>
</p>
@@ -22,7 +22,7 @@ slug: /
<a href="https://github.com/halo-dev/halo/actions"><img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/halo-dev/halo/halo.yaml?branch=main&style=flat-square" /></a>
<a href="https://codecov.io/gh/halo-dev/halo"><img alt="Codecov percentage" src="https://img.shields.io/codecov/c/github/halo-dev/halo/main?style=flat-square&token=YsRUg9fall"/></a>
<br />
<a href="https://halo.run">官网</a>
<a href="https://www.halo.run">官网</a>
<a href="https://docs.halo.run">文档</a>
<a href="https://bbs.halo.run">社区</a>
<a href="https://gitee.com/halo-dev">Gitee</a>

6
docs/user-guide/attachments.md
View File

@@ -12,8 +12,8 @@ Halo 默认提供了本地的存储策略类型，你还可以通过安装插件
:::info
目前 Halo 官方维护了两个存储策略插件，可以根据需要选择安装：
1. 阿里云 OSS：[https://halo.run/store/apps/app-wCJCD](https://halo.run/store/apps/app-wCJCD)
2. Amazon S3 协议（主流云存储厂商均支持）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
1. 阿里云 OSS：[https://www.halo.run/store/apps/app-wCJCD](https://www.halo.run/store/apps/app-wCJCD)
2. Amazon S3 协议（主流云存储厂商均支持）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
:::
你可以点击附件页面右上角的 `存储策略` 按钮对存储策略进行管理。
@@ -24,7 +24,7 @@ Halo 默认提供了本地的存储策略类型，你还可以通过安装插件
![添加存储策略](/img/user-guide/attachments/attachment-policy-add.png)
添加时首先需要选择一种存储策略类型，系统内置的存储策略为本地存储，图中的 `S3 Object Storage` 由[对象存储（Amazon S3 协议）](https://halo.run/store/apps/app-Qxhpp)提供，此文档以本地存储为例。
添加时首先需要选择一种存储策略类型，系统内置的存储策略为本地存储，图中的 `S3 Object Storage` 由[对象存储（Amazon S3 协议）](https://www.halo.run/store/apps/app-Qxhpp)提供，此文档以本地存储为例。
![添加本地存储策略](/img/user-guide/attachments/attachment-policy-add-local.png)

2
docs/user-guide/common.md
View File

@@ -62,6 +62,6 @@ Halo 作为一款好用又强大的开源建站工具，配合上不同的模板
:::info
目前有两个官方渠道可以获取主题和插件：
- 应用市场：[https://halo.run/store/apps](https://halo.run/store/apps)
- 应用市场：[https://www.halo.run/store/apps](https://www.halo.run/store/apps)
- Awesome Halo：[https://github.com/halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo)
:::

4
docs/user-guide/posts.md
View File

@@ -21,8 +21,8 @@ description: 文章管理相关功能说明
:::info
Halo 支持通过插件来拓展文章编辑器，目前 Halo 官方维护了另外两款编辑器插件，可以按需安装使用：
1. StackEdit：[https://halo.run/store/apps/app-hDXMG](https://halo.run/store/apps/app-hDXMG)
2. ByteMD：[https://halo.run/store/apps/app-HTyhC](https://halo.run/store/apps/app-HTyhC)
1. StackEdit：[https://www.halo.run/store/apps/app-hDXMG](https://www.halo.run/store/apps/app-hDXMG)
2. ByteMD：[https://www.halo.run/store/apps/app-HTyhC](https://www.halo.run/store/apps/app-HTyhC)
:::
## 文章设置

4
docs/user-guide/users.md
View File

@@ -104,7 +104,7 @@ Halo 提供了全新创建和基于已有角色创建两种角色创建方式。
:::info
目前 Halo 官方提供的身份认证插件：
- OAuth2 认证：[https://halo.run/store/apps/app-ESVDK](https://halo.run/store/apps/app-ESVDK)
- OAuth2 认证：[https://www.halo.run/store/apps/app-ESVDK](https://www.halo.run/store/apps/app-ESVDK)
:::
你可以在用户管理界面的右上角点击 `身份认证` 按钮，进入身份认证管理页面。
@@ -115,4 +115,4 @@ Halo 提供了全新创建和基于已有角色创建两种角色创建方式。
![身份认证方式](/img/user-guide/users/auth-providers.png)
> 这里是安装了 [OAuth2 认证](https://halo.run/store/apps/app-ESVDK) 插件，提供了 `GitHub`、`GitLab`、`Gitee` 三种 OAuth2 认证方式。
> 这里是安装了 [OAuth2 认证](https://www.halo.run/store/apps/app-ESVDK) 插件，提供了 `GitHub`、`GitLab`、`Gitee` 三种 OAuth2 认证方式。

4
docusaurus.config.js
View File

@@ -67,7 +67,7 @@ const config = {
title: "Halo 文档",
logo: {
alt: "Halo Logo",
src: "https://halo.run/upload/2021/03/Adaptive256-463ca9b92e2d40268431018c07735842.png",
src: "https://www.halo.run/upload/2021/03/Adaptive256-463ca9b92e2d40268431018c07735842.png",
},
items: [
{
@@ -109,7 +109,7 @@ const config = {
],
},
{
href: "https://halo.run",
href: "https://www.halo.run",
label: "官网",
position: "right",
},

2
versioned_docs/version-2.16/developer-guide/core/code-style.md
View File

@@ -23,7 +23,7 @@ Halo 添加了 checkstyle 插件，来保证每位提交者代码的风格保持
- 导入 checkstyle.xm 配置：
![image.png](https://halo.run/upload/2020/2/image-0c7a018e73f74634a534fa3ba8806628.png)
![image.png](https://www.halo.run/upload/2020/2/image-0c7a018e73f74634a534fa3ba8806628.png)
- 选择 `./config/checkstyle/checkstyle.xml` 配置文件，点击确定即可。

4
versioned_docs/version-2.16/developer-guide/plugin/examples/todolist.md
View File

@@ -33,8 +33,8 @@ description: 这个例子展示了如何开发 Todo List 插件
requires: ">=2.0.0"
author:
name: halo-dev
website: https://halo.run
logo: https://halo.run/logo
website: https://www.halo.run
logo: https://www.halo.run/logo
homepage: https://github.com/halo-dev/plugin-starter#readme
repo: https://github.com/halo-dev/plugin-starter
issues: https://github.com/halo-dev/plugin-starter/issues

26
versioned_docs/version-2.16/getting-started/migrate-from-1.x.md
View File

@@ -6,17 +6,17 @@ description: 从 Halo 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 版本。
- Halo 2.0 不兼容 1.x 的主题，建议在升级前先查询你正在使用的主题是否已经支持 2.0。你可以访问 [halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo) 或 [应用市场](https://halo.run/store/apps?type=THEME) 查阅目前支持的主题。
- Halo 2.0 不兼容 1.x 的主题，建议在升级前先查询你正在使用的主题是否已经支持 2.0。你可以访问 [halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo) 或 [应用市场](https://www.halo.run/store/apps?type=THEME) 查阅目前支持的主题。
- Halo 2.0 目前没有内置 Markdown 编辑器，如果需要重新编辑迁移后的文章，需要额外安装 Markdown 编辑器插件。目前社区已经提供了以下插件：
- StackEdit：[https://halo.run/store/apps/app-hDXMG](https://halo.run/store/apps/app-hDXMG)
- ByteMD：[https://halo.run/store/apps/app-HTyhC](https://halo.run/store/apps/app-HTyhC)
- StackEdit：[https://www.halo.run/store/apps/app-hDXMG](https://www.halo.run/store/apps/app-hDXMG)
- ByteMD：[https://www.halo.run/store/apps/app-HTyhC](https://www.halo.run/store/apps/app-HTyhC)
- Halo 2.0 不再内置友情链接、日志、图库等模块，需要安装额外的插件，目前官方已提供：
- 链接管理：[https://halo.run/store/apps/app-hfbQg](https://halo.run/store/apps/app-hfbQg)
- 图库：[https://halo.run/store/apps/app-BmQJW](https://halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://halo.run/store/apps/app-SnwWD](https://halo.run/store/apps/app-SnwWD)
- 链接管理：[https://www.halo.run/store/apps/app-hfbQg](https://www.halo.run/store/apps/app-hfbQg)
- 图库：[https://www.halo.run/store/apps/app-BmQJW](https://www.halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://www.halo.run/store/apps/app-SnwWD](https://www.halo.run/store/apps/app-SnwWD)
- Halo 2.0 不再内置外部云存储的支持。需要安装额外的插件，目前官方已提供：
- S3（兼容国内主流的云存储）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
- 阿里云 OSS：[https://halo.run/store/apps/app-wCJCD](https://halo.run/store/apps/app-wCJCD)
- S3（兼容国内主流的云存储）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
- 阿里云 OSS：[https://www.halo.run/store/apps/app-wCJCD](https://www.halo.run/store/apps/app-wCJCD)
- 在迁移过程中不会保留旧版本的用户数据，迁移完成之后，关于文章等数据的关联都将改为 Halo 2.0 的新用户。
- 为了防止直接升级 2.0 导致 1.x 的数据受到破坏，我们已经将工作目录由 `~/.halo` 变更为 `~/.halo2`。
- 目前 Halo 2.0 仅提供 Docker 部署方式，没有提供可执行 JAR 包，但可以自编译，请参考 [构建](../developer-guide/core/build.md) 文档
@@ -54,11 +54,11 @@ description: 从 Halo 1.x 迁移的完整指南和注意事项
在迁移过程中，需要提前安装必要的插件：
- 站点迁移：[https://halo.run/store/apps/app-TlUBt](https://halo.run/store/apps/app-TlUBt)
- 链接管理：[https://halo.run/store/apps/app-hfbQg](https://halo.run/store/apps/app-hfbQg)
- 图库：[https://halo.run/store/apps/app-BmQJW](https://halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://halo.run/store/apps/app-SnwWD](https://halo.run/store/apps/app-SnwWD)
- S3（如果需要迁移存在云存储的附件，需要安装）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
- 站点迁移：[https://www.halo.run/store/apps/app-TlUBt](https://www.halo.run/store/apps/app-TlUBt)
- 链接管理：[https://www.halo.run/store/apps/app-hfbQg](https://www.halo.run/store/apps/app-hfbQg)
- 图库：[https://www.halo.run/store/apps/app-BmQJW](https://www.halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://www.halo.run/store/apps/app-SnwWD](https://www.halo.run/store/apps/app-SnwWD)
- S3（如果需要迁移存在云存储的附件，需要安装）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
## 配置存储策略

6
versioned_docs/version-2.16/intro.md
View File

@@ -8,8 +8,8 @@ slug: /
---
<p align="center">
<a href="https://halo.run" target="_blank" rel="noopener noreferrer">
<img width="100" src="https://halo.run/logo" alt="Halo logo" />
<a href="https://www.halo.run" target="_blank" rel="noopener noreferrer">
<img width="100" src="https://www.halo.run/logo" alt="Halo logo" />
</a>
</p>
@@ -22,7 +22,7 @@ slug: /
<a href="https://github.com/halo-dev/halo/actions"><img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/halo-dev/halo/halo.yaml?branch=main&style=flat-square" /></a>
<a href="https://codecov.io/gh/halo-dev/halo"><img alt="Codecov percentage" src="https://img.shields.io/codecov/c/github/halo-dev/halo/main?style=flat-square&token=YsRUg9fall"/></a>
<br />
<a href="https://halo.run">官网</a>
<a href="https://www.halo.run">官网</a>
<a href="https://docs.halo.run">文档</a>
<a href="https://bbs.halo.run">社区</a>
<a href="https://gitee.com/halo-dev">Gitee</a>

6
versioned_docs/version-2.16/user-guide/attachments.md
View File

@@ -12,8 +12,8 @@ Halo 默认提供了本地的存储策略类型，你还可以通过安装插件
:::info
目前 Halo 官方维护了两个存储策略插件，可以根据需要选择安装：
1. 阿里云 OSS：[https://halo.run/store/apps/app-wCJCD](https://halo.run/store/apps/app-wCJCD)
2. Amazon S3 协议（主流云存储厂商均支持）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
1. 阿里云 OSS：[https://www.halo.run/store/apps/app-wCJCD](https://www.halo.run/store/apps/app-wCJCD)
2. Amazon S3 协议（主流云存储厂商均支持）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
:::
你可以点击附件页面右上角的 `存储策略` 按钮对存储策略进行管理。
@@ -24,7 +24,7 @@ Halo 默认提供了本地的存储策略类型，你还可以通过安装插件
![添加存储策略](/img/user-guide/attachments/attachment-policy-add.png)
添加时首先需要选择一种存储策略类型，系统内置的存储策略为本地存储，图中的 `S3 Object Storage` 由[对象存储（Amazon S3 协议）](https://halo.run/store/apps/app-Qxhpp)提供，此文档以本地存储为例。
添加时首先需要选择一种存储策略类型，系统内置的存储策略为本地存储，图中的 `S3 Object Storage` 由[对象存储（Amazon S3 协议）](https://www.halo.run/store/apps/app-Qxhpp)提供，此文档以本地存储为例。
![添加本地存储策略](/img/user-guide/attachments/attachment-policy-add-local.png)

2
versioned_docs/version-2.16/user-guide/common.md
View File

@@ -62,6 +62,6 @@ Halo 作为一款好用又强大的开源建站工具，配合上不同的模板
:::info
目前有两个官方渠道可以获取主题和插件：
- 应用市场：[https://halo.run/store/apps](https://halo.run/store/apps)
- 应用市场：[https://www.halo.run/store/apps](https://www.halo.run/store/apps)
- Awesome Halo：[https://github.com/halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo)
:::

4
versioned_docs/version-2.16/user-guide/posts.md
View File

@@ -21,8 +21,8 @@ description: 文章管理相关功能说明
:::info
Halo 支持通过插件来拓展文章编辑器，目前 Halo 官方维护了另外两款编辑器插件，可以按需安装使用：
1. StackEdit：[https://halo.run/store/apps/app-hDXMG](https://halo.run/store/apps/app-hDXMG)
2. ByteMD：[https://halo.run/store/apps/app-HTyhC](https://halo.run/store/apps/app-HTyhC)
1. StackEdit：[https://www.halo.run/store/apps/app-hDXMG](https://www.halo.run/store/apps/app-hDXMG)
2. ByteMD：[https://www.halo.run/store/apps/app-HTyhC](https://www.halo.run/store/apps/app-HTyhC)
:::
## 文章设置

4
versioned_docs/version-2.16/user-guide/users.md
View File

@@ -104,7 +104,7 @@ Halo 提供了全新创建和基于已有角色创建两种角色创建方式。
:::info
目前 Halo 官方提供的身份认证插件：
- OAuth2 认证：[https://halo.run/store/apps/app-ESVDK](https://halo.run/store/apps/app-ESVDK)
- OAuth2 认证：[https://www.halo.run/store/apps/app-ESVDK](https://www.halo.run/store/apps/app-ESVDK)
:::
你可以在用户管理界面的右上角点击 `身份认证` 按钮，进入身份认证管理页面。
@@ -115,4 +115,4 @@ Halo 提供了全新创建和基于已有角色创建两种角色创建方式。
![身份认证方式](/img/user-guide/users/auth-providers.png)
> 这里是安装了 [OAuth2 认证](https://halo.run/store/apps/app-ESVDK) 插件，提供了 `GitHub`、`GitLab`、`Gitee` 三种 OAuth2 认证方式。
> 这里是安装了 [OAuth2 认证](https://www.halo.run/store/apps/app-ESVDK) 插件，提供了 `GitHub`、`GitLab`、`Gitee` 三种 OAuth2 认证方式。

2
versioned_docs/version-2.17/developer-guide/core/code-style.md
View File

@@ -23,7 +23,7 @@ Halo 添加了 checkstyle 插件，来保证每位提交者代码的风格保持
- 导入 checkstyle.xm 配置：
![image.png](https://halo.run/upload/2020/2/image-0c7a018e73f74634a534fa3ba8806628.png)
![image.png](https://www.halo.run/upload/2020/2/image-0c7a018e73f74634a534fa3ba8806628.png)
- 选择 `./config/checkstyle/checkstyle.xml` 配置文件，点击确定即可。

4
versioned_docs/version-2.17/developer-guide/plugin/examples/todolist.md
View File

@@ -33,8 +33,8 @@ description: 这个例子展示了如何开发 Todo List 插件
requires: ">=2.0.0"
author:
name: halo-dev
website: https://halo.run
logo: https://halo.run/logo
website: https://www.halo.run
logo: https://www.halo.run/logo
homepage: https://github.com/halo-dev/plugin-starter#readme
repo: https://github.com/halo-dev/plugin-starter
issues: https://github.com/halo-dev/plugin-starter/issues

26
versioned_docs/version-2.17/getting-started/migrate-from-1.x.md
View File

@@ -6,17 +6,17 @@ description: 从 Halo 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 版本。
- Halo 2.0 不兼容 1.x 的主题，建议在升级前先查询你正在使用的主题是否已经支持 2.0。你可以访问 [halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo) 或 [应用市场](https://halo.run/store/apps?type=THEME) 查阅目前支持的主题。
- Halo 2.0 不兼容 1.x 的主题，建议在升级前先查询你正在使用的主题是否已经支持 2.0。你可以访问 [halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo) 或 [应用市场](https://www.halo.run/store/apps?type=THEME) 查阅目前支持的主题。
- Halo 2.0 目前没有内置 Markdown 编辑器，如果需要重新编辑迁移后的文章，需要额外安装 Markdown 编辑器插件。目前社区已经提供了以下插件：
- StackEdit：[https://halo.run/store/apps/app-hDXMG](https://halo.run/store/apps/app-hDXMG)
- ByteMD：[https://halo.run/store/apps/app-HTyhC](https://halo.run/store/apps/app-HTyhC)
- StackEdit：[https://www.halo.run/store/apps/app-hDXMG](https://www.halo.run/store/apps/app-hDXMG)
- ByteMD：[https://www.halo.run/store/apps/app-HTyhC](https://www.halo.run/store/apps/app-HTyhC)
- Halo 2.0 不再内置友情链接、日志、图库等模块，需要安装额外的插件，目前官方已提供：
- 链接管理：[https://halo.run/store/apps/app-hfbQg](https://halo.run/store/apps/app-hfbQg)
- 图库：[https://halo.run/store/apps/app-BmQJW](https://halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://halo.run/store/apps/app-SnwWD](https://halo.run/store/apps/app-SnwWD)
- 链接管理：[https://www.halo.run/store/apps/app-hfbQg](https://www.halo.run/store/apps/app-hfbQg)
- 图库：[https://www.halo.run/store/apps/app-BmQJW](https://www.halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://www.halo.run/store/apps/app-SnwWD](https://www.halo.run/store/apps/app-SnwWD)
- Halo 2.0 不再内置外部云存储的支持。需要安装额外的插件，目前官方已提供：
- S3（兼容国内主流的云存储）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
- 阿里云 OSS：[https://halo.run/store/apps/app-wCJCD](https://halo.run/store/apps/app-wCJCD)
- S3（兼容国内主流的云存储）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
- 阿里云 OSS：[https://www.halo.run/store/apps/app-wCJCD](https://www.halo.run/store/apps/app-wCJCD)
- 在迁移过程中不会保留旧版本的用户数据，迁移完成之后，关于文章等数据的关联都将改为 Halo 2.0 的新用户。
- 为了防止直接升级 2.0 导致 1.x 的数据受到破坏，我们已经将工作目录由 `~/.halo` 变更为 `~/.halo2`。
- 目前 Halo 2.0 仅提供 Docker 部署方式，没有提供可执行 JAR 包，但可以自编译，请参考 [构建](../developer-guide/core/build.md) 文档
@@ -54,11 +54,11 @@ description: 从 Halo 1.x 迁移的完整指南和注意事项
在迁移过程中，需要提前安装必要的插件：
- 站点迁移：[https://halo.run/store/apps/app-TlUBt](https://halo.run/store/apps/app-TlUBt)
- 链接管理：[https://halo.run/store/apps/app-hfbQg](https://halo.run/store/apps/app-hfbQg)
- 图库：[https://halo.run/store/apps/app-BmQJW](https://halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://halo.run/store/apps/app-SnwWD](https://halo.run/store/apps/app-SnwWD)
- S3（如果需要迁移存在云存储的附件，需要安装）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
- 站点迁移：[https://www.halo.run/store/apps/app-TlUBt](https://www.halo.run/store/apps/app-TlUBt)
- 链接管理：[https://www.halo.run/store/apps/app-hfbQg](https://www.halo.run/store/apps/app-hfbQg)
- 图库：[https://www.halo.run/store/apps/app-BmQJW](https://www.halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://www.halo.run/store/apps/app-SnwWD](https://www.halo.run/store/apps/app-SnwWD)
- S3（如果需要迁移存在云存储的附件，需要安装）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
## 配置存储策略

6
versioned_docs/version-2.17/intro.md
View File

@@ -8,8 +8,8 @@ slug: /
---
<p align="center">
<a href="https://halo.run" target="_blank" rel="noopener noreferrer">
<img width="100" src="https://halo.run/logo" alt="Halo logo" />
<a href="https://www.halo.run" target="_blank" rel="noopener noreferrer">
<img width="100" src="https://www.halo.run/logo" alt="Halo logo" />
</a>
</p>
@@ -22,7 +22,7 @@ slug: /
<a href="https://github.com/halo-dev/halo/actions"><img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/halo-dev/halo/halo.yaml?branch=main&style=flat-square" /></a>
<a href="https://codecov.io/gh/halo-dev/halo"><img alt="Codecov percentage" src="https://img.shields.io/codecov/c/github/halo-dev/halo/main?style=flat-square&token=YsRUg9fall"/></a>
<br />
<a href="https://halo.run">官网</a>
<a href="https://www.halo.run">官网</a>
<a href="https://docs.halo.run">文档</a>
<a href="https://bbs.halo.run">社区</a>
<a href="https://gitee.com/halo-dev">Gitee</a>

6
versioned_docs/version-2.17/user-guide/attachments.md
View File

@@ -12,8 +12,8 @@ Halo 默认提供了本地的存储策略类型，你还可以通过安装插件
:::info
目前 Halo 官方维护了两个存储策略插件，可以根据需要选择安装：
1. 阿里云 OSS：[https://halo.run/store/apps/app-wCJCD](https://halo.run/store/apps/app-wCJCD)
2. Amazon S3 协议（主流云存储厂商均支持）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
1. 阿里云 OSS：[https://www.halo.run/store/apps/app-wCJCD](https://www.halo.run/store/apps/app-wCJCD)
2. Amazon S3 协议（主流云存储厂商均支持）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
:::
你可以点击附件页面右上角的 `存储策略` 按钮对存储策略进行管理。
@@ -24,7 +24,7 @@ Halo 默认提供了本地的存储策略类型，你还可以通过安装插件
![添加存储策略](/img/user-guide/attachments/attachment-policy-add.png)
添加时首先需要选择一种存储策略类型，系统内置的存储策略为本地存储，图中的 `S3 Object Storage` 由[对象存储（Amazon S3 协议）](https://halo.run/store/apps/app-Qxhpp)提供，此文档以本地存储为例。
添加时首先需要选择一种存储策略类型，系统内置的存储策略为本地存储，图中的 `S3 Object Storage` 由[对象存储（Amazon S3 协议）](https://www.halo.run/store/apps/app-Qxhpp)提供，此文档以本地存储为例。
![添加本地存储策略](/img/user-guide/attachments/attachment-policy-add-local.png)

2
versioned_docs/version-2.17/user-guide/common.md
View File

@@ -62,6 +62,6 @@ Halo 作为一款好用又强大的开源建站工具，配合上不同的模板
:::info
目前有两个官方渠道可以获取主题和插件：
- 应用市场：[https://halo.run/store/apps](https://halo.run/store/apps)
- 应用市场：[https://www.halo.run/store/apps](https://www.halo.run/store/apps)
- Awesome Halo：[https://github.com/halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo)
:::

4
versioned_docs/version-2.17/user-guide/posts.md
View File

@@ -21,8 +21,8 @@ description: 文章管理相关功能说明
:::info
Halo 支持通过插件来拓展文章编辑器，目前 Halo 官方维护了另外两款编辑器插件，可以按需安装使用：
1. StackEdit：[https://halo.run/store/apps/app-hDXMG](https://halo.run/store/apps/app-hDXMG)
2. ByteMD：[https://halo.run/store/apps/app-HTyhC](https://halo.run/store/apps/app-HTyhC)
1. StackEdit：[https://www.halo.run/store/apps/app-hDXMG](https://www.halo.run/store/apps/app-hDXMG)
2. ByteMD：[https://www.halo.run/store/apps/app-HTyhC](https://www.halo.run/store/apps/app-HTyhC)
:::
## 文章设置

4
versioned_docs/version-2.17/user-guide/users.md
View File

@@ -104,7 +104,7 @@ Halo 提供了全新创建和基于已有角色创建两种角色创建方式。
:::info
目前 Halo 官方提供的身份认证插件：
- OAuth2 认证：[https://halo.run/store/apps/app-ESVDK](https://halo.run/store/apps/app-ESVDK)
- OAuth2 认证：[https://www.halo.run/store/apps/app-ESVDK](https://www.halo.run/store/apps/app-ESVDK)
:::
你可以在用户管理界面的右上角点击 `身份认证` 按钮，进入身份认证管理页面。
@@ -115,4 +115,4 @@ Halo 提供了全新创建和基于已有角色创建两种角色创建方式。
![身份认证方式](/img/user-guide/users/auth-providers.png)
> 这里是安装了 [OAuth2 认证](https://halo.run/store/apps/app-ESVDK) 插件，提供了 `GitHub`、`GitLab`、`Gitee` 三种 OAuth2 认证方式。
> 这里是安装了 [OAuth2 认证](https://www.halo.run/store/apps/app-ESVDK) 插件，提供了 `GitHub`、`GitLab`、`Gitee` 三种 OAuth2 认证方式。

2
versioned_docs/version-2.18/developer-guide/core/code-style.md
View File

@@ -23,7 +23,7 @@ Halo 添加了 checkstyle 插件，来保证每位提交者代码的风格保持
- 导入 checkstyle.xm 配置：
![image.png](https://halo.run/upload/2020/2/image-0c7a018e73f74634a534fa3ba8806628.png)
![image.png](https://www.halo.run/upload/2020/2/image-0c7a018e73f74634a534fa3ba8806628.png)
- 选择 `./config/checkstyle/checkstyle.xml` 配置文件，点击确定即可。

4
versioned_docs/version-2.18/developer-guide/plugin/examples/todolist.md
View File

@@ -33,8 +33,8 @@ description: 这个例子展示了如何开发 Todo List 插件
requires: ">=2.0.0"
author:
name: halo-dev
website: https://halo.run
logo: https://halo.run/logo
website: https://www.halo.run
logo: https://www.halo.run/logo
homepage: https://github.com/halo-dev/plugin-starter#readme
repo: https://github.com/halo-dev/plugin-starter
issues: https://github.com/halo-dev/plugin-starter/issues

26
versioned_docs/version-2.18/getting-started/migrate-from-1.x.md
View File

@@ -6,17 +6,17 @@ description: 从 Halo 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 版本。
- Halo 2.0 不兼容 1.x 的主题，建议在升级前先查询你正在使用的主题是否已经支持 2.0。你可以访问 [halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo) 或 [应用市场](https://halo.run/store/apps?type=THEME) 查阅目前支持的主题。
- Halo 2.0 不兼容 1.x 的主题，建议在升级前先查询你正在使用的主题是否已经支持 2.0。你可以访问 [halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo) 或 [应用市场](https://www.halo.run/store/apps?type=THEME) 查阅目前支持的主题。
- Halo 2.0 目前没有内置 Markdown 编辑器，如果需要重新编辑迁移后的文章，需要额外安装 Markdown 编辑器插件。目前社区已经提供了以下插件：
- StackEdit：[https://halo.run/store/apps/app-hDXMG](https://halo.run/store/apps/app-hDXMG)
- ByteMD：[https://halo.run/store/apps/app-HTyhC](https://halo.run/store/apps/app-HTyhC)
- StackEdit：[https://www.halo.run/store/apps/app-hDXMG](https://www.halo.run/store/apps/app-hDXMG)
- ByteMD：[https://www.halo.run/store/apps/app-HTyhC](https://www.halo.run/store/apps/app-HTyhC)
- Halo 2.0 不再内置友情链接、日志、图库等模块，需要安装额外的插件，目前官方已提供：
- 链接管理：[https://halo.run/store/apps/app-hfbQg](https://halo.run/store/apps/app-hfbQg)
- 图库：[https://halo.run/store/apps/app-BmQJW](https://halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://halo.run/store/apps/app-SnwWD](https://halo.run/store/apps/app-SnwWD)
- 链接管理：[https://www.halo.run/store/apps/app-hfbQg](https://www.halo.run/store/apps/app-hfbQg)
- 图库：[https://www.halo.run/store/apps/app-BmQJW](https://www.halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://www.halo.run/store/apps/app-SnwWD](https://www.halo.run/store/apps/app-SnwWD)
- Halo 2.0 不再内置外部云存储的支持。需要安装额外的插件，目前官方已提供：
- S3（兼容国内主流的云存储）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
- 阿里云 OSS：[https://halo.run/store/apps/app-wCJCD](https://halo.run/store/apps/app-wCJCD)
- S3（兼容国内主流的云存储）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
- 阿里云 OSS：[https://www.halo.run/store/apps/app-wCJCD](https://www.halo.run/store/apps/app-wCJCD)
- 在迁移过程中不会保留旧版本的用户数据，迁移完成之后，关于文章等数据的关联都将改为 Halo 2.0 的新用户。
- 为了防止直接升级 2.0 导致 1.x 的数据受到破坏，我们已经将工作目录由 `~/.halo` 变更为 `~/.halo2`。
- 目前 Halo 2.0 仅提供 Docker 部署方式，没有提供可执行 JAR 包，但可以自编译，请参考 [构建](../developer-guide/core/build.md) 文档
@@ -54,11 +54,11 @@ description: 从 Halo 1.x 迁移的完整指南和注意事项
在迁移过程中，需要提前安装必要的插件：
- 站点迁移：[https://halo.run/store/apps/app-TlUBt](https://halo.run/store/apps/app-TlUBt)
- 链接管理：[https://halo.run/store/apps/app-hfbQg](https://halo.run/store/apps/app-hfbQg)
- 图库：[https://halo.run/store/apps/app-BmQJW](https://halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://halo.run/store/apps/app-SnwWD](https://halo.run/store/apps/app-SnwWD)
- S3（如果需要迁移存在云存储的附件，需要安装）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
- 站点迁移：[https://www.halo.run/store/apps/app-TlUBt](https://www.halo.run/store/apps/app-TlUBt)
- 链接管理：[https://www.halo.run/store/apps/app-hfbQg](https://www.halo.run/store/apps/app-hfbQg)
- 图库：[https://www.halo.run/store/apps/app-BmQJW](https://www.halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://www.halo.run/store/apps/app-SnwWD](https://www.halo.run/store/apps/app-SnwWD)
- S3（如果需要迁移存在云存储的附件，需要安装）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
## 配置存储策略

6
versioned_docs/version-2.18/intro.md
View File

@@ -8,8 +8,8 @@ slug: /
---
<p align="center">
<a href="https://halo.run" target="_blank" rel="noopener noreferrer">
<img width="100" src="https://halo.run/logo" alt="Halo logo" />
<a href="https://www.halo.run" target="_blank" rel="noopener noreferrer">
<img width="100" src="https://www.halo.run/logo" alt="Halo logo" />
</a>
</p>
@@ -22,7 +22,7 @@ slug: /
<a href="https://github.com/halo-dev/halo/actions"><img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/halo-dev/halo/halo.yaml?branch=main&style=flat-square" /></a>
<a href="https://codecov.io/gh/halo-dev/halo"><img alt="Codecov percentage" src="https://img.shields.io/codecov/c/github/halo-dev/halo/main?style=flat-square&token=YsRUg9fall"/></a>
<br />
<a href="https://halo.run">官网</a>
<a href="https://www.halo.run">官网</a>
<a href="https://docs.halo.run">文档</a>
<a href="https://bbs.halo.run">社区</a>
<a href="https://gitee.com/halo-dev">Gitee</a>

6
versioned_docs/version-2.18/user-guide/attachments.md
View File

@@ -12,8 +12,8 @@ Halo 默认提供了本地的存储策略类型，你还可以通过安装插件
:::info
目前 Halo 官方维护了两个存储策略插件，可以根据需要选择安装：
1. 阿里云 OSS：[https://halo.run/store/apps/app-wCJCD](https://halo.run/store/apps/app-wCJCD)
2. Amazon S3 协议（主流云存储厂商均支持）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
1. 阿里云 OSS：[https://www.halo.run/store/apps/app-wCJCD](https://www.halo.run/store/apps/app-wCJCD)
2. Amazon S3 协议（主流云存储厂商均支持）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
:::
你可以点击附件页面右上角的 `存储策略` 按钮对存储策略进行管理。
@@ -24,7 +24,7 @@ Halo 默认提供了本地的存储策略类型，你还可以通过安装插件
![添加存储策略](/img/user-guide/attachments/attachment-policy-add.png)
添加时首先需要选择一种存储策略类型，系统内置的存储策略为本地存储，图中的 `S3 Object Storage` 由[对象存储（Amazon S3 协议）](https://halo.run/store/apps/app-Qxhpp)提供，此文档以本地存储为例。
添加时首先需要选择一种存储策略类型，系统内置的存储策略为本地存储，图中的 `S3 Object Storage` 由[对象存储（Amazon S3 协议）](https://www.halo.run/store/apps/app-Qxhpp)提供，此文档以本地存储为例。
![添加本地存储策略](/img/user-guide/attachments/attachment-policy-add-local.png)

2
versioned_docs/version-2.18/user-guide/common.md
View File

@@ -62,6 +62,6 @@ Halo 作为一款好用又强大的开源建站工具，配合上不同的模板
:::info
目前有两个官方渠道可以获取主题和插件：
- 应用市场：[https://halo.run/store/apps](https://halo.run/store/apps)
- 应用市场：[https://www.halo.run/store/apps](https://www.halo.run/store/apps)
- Awesome Halo：[https://github.com/halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo)
:::

4
versioned_docs/version-2.18/user-guide/posts.md
View File

@@ -21,8 +21,8 @@ description: 文章管理相关功能说明
:::info
Halo 支持通过插件来拓展文章编辑器，目前 Halo 官方维护了另外两款编辑器插件，可以按需安装使用：
1. StackEdit：[https://halo.run/store/apps/app-hDXMG](https://halo.run/store/apps/app-hDXMG)
2. ByteMD：[https://halo.run/store/apps/app-HTyhC](https://halo.run/store/apps/app-HTyhC)
1. StackEdit：[https://www.halo.run/store/apps/app-hDXMG](https://www.halo.run/store/apps/app-hDXMG)
2. ByteMD：[https://www.halo.run/store/apps/app-HTyhC](https://www.halo.run/store/apps/app-HTyhC)
:::
## 文章设置

4
versioned_docs/version-2.18/user-guide/users.md
View File

@@ -104,7 +104,7 @@ Halo 提供了全新创建和基于已有角色创建两种角色创建方式。
:::info
目前 Halo 官方提供的身份认证插件：
- OAuth2 认证：[https://halo.run/store/apps/app-ESVDK](https://halo.run/store/apps/app-ESVDK)
- OAuth2 认证：[https://www.halo.run/store/apps/app-ESVDK](https://www.halo.run/store/apps/app-ESVDK)
:::
你可以在用户管理界面的右上角点击 `身份认证` 按钮，进入身份认证管理页面。
@@ -115,4 +115,4 @@ Halo 提供了全新创建和基于已有角色创建两种角色创建方式。
![身份认证方式](/img/user-guide/users/auth-providers.png)
> 这里是安装了 [OAuth2 认证](https://halo.run/store/apps/app-ESVDK) 插件，提供了 `GitHub`、`GitLab`、`Gitee` 三种 OAuth2 认证方式。
> 这里是安装了 [OAuth2 认证](https://www.halo.run/store/apps/app-ESVDK) 插件，提供了 `GitHub`、`GitLab`、`Gitee` 三种 OAuth2 认证方式。

2
versioned_docs/version-2.19/developer-guide/core/code-style.md
View File

@@ -23,7 +23,7 @@ Halo 添加了 checkstyle 插件，来保证每位提交者代码的风格保持
- 导入 checkstyle.xm 配置：
![image.png](https://halo.run/upload/2020/2/image-0c7a018e73f74634a534fa3ba8806628.png)
![image.png](https://www.halo.run/upload/2020/2/image-0c7a018e73f74634a534fa3ba8806628.png)
- 选择 `./config/checkstyle/checkstyle.xml` 配置文件，点击确定即可。

4
versioned_docs/version-2.19/developer-guide/plugin/examples/todolist.md
View File

@@ -33,8 +33,8 @@ description: 这个例子展示了如何开发 Todo List 插件
requires: ">=2.0.0"
author:
name: halo-dev
website: https://halo.run
logo: https://halo.run/logo
website: https://www.halo.run
logo: https://www.halo.run/logo
homepage: https://github.com/halo-dev/plugin-starter#readme
repo: https://github.com/halo-dev/plugin-starter
issues: https://github.com/halo-dev/plugin-starter/issues

26
versioned_docs/version-2.19/getting-started/migrate-from-1.x.md
View File

@@ -6,17 +6,17 @@ description: 从 Halo 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 版本。
- Halo 2.0 不兼容 1.x 的主题，建议在升级前先查询你正在使用的主题是否已经支持 2.0。你可以访问 [halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo) 或 [应用市场](https://halo.run/store/apps?type=THEME) 查阅目前支持的主题。
- Halo 2.0 不兼容 1.x 的主题，建议在升级前先查询你正在使用的主题是否已经支持 2.0。你可以访问 [halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo) 或 [应用市场](https://www.halo.run/store/apps?type=THEME) 查阅目前支持的主题。
- Halo 2.0 目前没有内置 Markdown 编辑器，如果需要重新编辑迁移后的文章，需要额外安装 Markdown 编辑器插件。目前社区已经提供了以下插件：
- StackEdit：[https://halo.run/store/apps/app-hDXMG](https://halo.run/store/apps/app-hDXMG)
- ByteMD：[https://halo.run/store/apps/app-HTyhC](https://halo.run/store/apps/app-HTyhC)
- StackEdit：[https://www.halo.run/store/apps/app-hDXMG](https://www.halo.run/store/apps/app-hDXMG)
- ByteMD：[https://www.halo.run/store/apps/app-HTyhC](https://www.halo.run/store/apps/app-HTyhC)
- Halo 2.0 不再内置友情链接、日志、图库等模块，需要安装额外的插件，目前官方已提供：
- 链接管理：[https://halo.run/store/apps/app-hfbQg](https://halo.run/store/apps/app-hfbQg)
- 图库：[https://halo.run/store/apps/app-BmQJW](https://halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://halo.run/store/apps/app-SnwWD](https://halo.run/store/apps/app-SnwWD)
- 链接管理：[https://www.halo.run/store/apps/app-hfbQg](https://www.halo.run/store/apps/app-hfbQg)
- 图库：[https://www.halo.run/store/apps/app-BmQJW](https://www.halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://www.halo.run/store/apps/app-SnwWD](https://www.halo.run/store/apps/app-SnwWD)
- Halo 2.0 不再内置外部云存储的支持。需要安装额外的插件，目前官方已提供：
- S3（兼容国内主流的云存储）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
- 阿里云 OSS：[https://halo.run/store/apps/app-wCJCD](https://halo.run/store/apps/app-wCJCD)
- S3（兼容国内主流的云存储）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
- 阿里云 OSS：[https://www.halo.run/store/apps/app-wCJCD](https://www.halo.run/store/apps/app-wCJCD)
- 在迁移过程中不会保留旧版本的用户数据，迁移完成之后，关于文章等数据的关联都将改为 Halo 2.0 的新用户。
- 为了防止直接升级 2.0 导致 1.x 的数据受到破坏，我们已经将工作目录由 `~/.halo` 变更为 `~/.halo2`。
- 目前 Halo 2.0 仅提供 Docker 部署方式，没有提供可执行 JAR 包，但可以自编译，请参考 [构建](../developer-guide/core/build.md) 文档
@@ -54,11 +54,11 @@ description: 从 Halo 1.x 迁移的完整指南和注意事项
在迁移过程中，需要提前安装必要的插件：
- 站点迁移：[https://halo.run/store/apps/app-TlUBt](https://halo.run/store/apps/app-TlUBt)
- 链接管理：[https://halo.run/store/apps/app-hfbQg](https://halo.run/store/apps/app-hfbQg)
- 图库：[https://halo.run/store/apps/app-BmQJW](https://halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://halo.run/store/apps/app-SnwWD](https://halo.run/store/apps/app-SnwWD)
- S3（如果需要迁移存在云存储的附件，需要安装）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
- 站点迁移：[https://www.halo.run/store/apps/app-TlUBt](https://www.halo.run/store/apps/app-TlUBt)
- 链接管理：[https://www.halo.run/store/apps/app-hfbQg](https://www.halo.run/store/apps/app-hfbQg)
- 图库：[https://www.halo.run/store/apps/app-BmQJW](https://www.halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://www.halo.run/store/apps/app-SnwWD](https://www.halo.run/store/apps/app-SnwWD)
- S3（如果需要迁移存在云存储的附件，需要安装）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
## 配置存储策略

6
versioned_docs/version-2.19/intro.md
View File

@@ -8,8 +8,8 @@ slug: /
---
<p align="center">
<a href="https://halo.run" target="_blank" rel="noopener noreferrer">
<img width="100" src="https://halo.run/logo" alt="Halo logo" />
<a href="https://www.halo.run" target="_blank" rel="noopener noreferrer">
<img width="100" src="https://www.halo.run/logo" alt="Halo logo" />
</a>
</p>
@@ -22,7 +22,7 @@ slug: /
<a href="https://github.com/halo-dev/halo/actions"><img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/halo-dev/halo/halo.yaml?branch=main&style=flat-square" /></a>
<a href="https://codecov.io/gh/halo-dev/halo"><img alt="Codecov percentage" src="https://img.shields.io/codecov/c/github/halo-dev/halo/main?style=flat-square&token=YsRUg9fall"/></a>
<br />
<a href="https://halo.run">官网</a>
<a href="https://www.halo.run">官网</a>
<a href="https://docs.halo.run">文档</a>
<a href="https://bbs.halo.run">社区</a>
<a href="https://gitee.com/halo-dev">Gitee</a>

6
versioned_docs/version-2.19/user-guide/attachments.md
View File

@@ -12,8 +12,8 @@ Halo 默认提供了本地的存储策略类型，你还可以通过安装插件
:::info
目前 Halo 官方维护了两个存储策略插件，可以根据需要选择安装：
1. 阿里云 OSS：[https://halo.run/store/apps/app-wCJCD](https://halo.run/store/apps/app-wCJCD)
2. Amazon S3 协议（主流云存储厂商均支持）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
1. 阿里云 OSS：[https://www.halo.run/store/apps/app-wCJCD](https://www.halo.run/store/apps/app-wCJCD)
2. Amazon S3 协议（主流云存储厂商均支持）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
:::
你可以点击附件页面右上角的 `存储策略` 按钮对存储策略进行管理。
@@ -24,7 +24,7 @@ Halo 默认提供了本地的存储策略类型，你还可以通过安装插件
![添加存储策略](/img/user-guide/attachments/attachment-policy-add.png)
添加时首先需要选择一种存储策略类型，系统内置的存储策略为本地存储，图中的 `S3 Object Storage` 由[对象存储（Amazon S3 协议）](https://halo.run/store/apps/app-Qxhpp)提供，此文档以本地存储为例。
添加时首先需要选择一种存储策略类型，系统内置的存储策略为本地存储，图中的 `S3 Object Storage` 由[对象存储（Amazon S3 协议）](https://www.halo.run/store/apps/app-Qxhpp)提供，此文档以本地存储为例。
![添加本地存储策略](/img/user-guide/attachments/attachment-policy-add-local.png)

2
versioned_docs/version-2.19/user-guide/common.md
View File

@@ -62,6 +62,6 @@ Halo 作为一款好用又强大的开源建站工具，配合上不同的模板
:::info
目前有两个官方渠道可以获取主题和插件：
- 应用市场：[https://halo.run/store/apps](https://halo.run/store/apps)
- 应用市场：[https://www.halo.run/store/apps](https://www.halo.run/store/apps)
- Awesome Halo：[https://github.com/halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo)
:::

4
versioned_docs/version-2.19/user-guide/posts.md
View File

@@ -21,8 +21,8 @@ description: 文章管理相关功能说明
:::info
Halo 支持通过插件来拓展文章编辑器，目前 Halo 官方维护了另外两款编辑器插件，可以按需安装使用：
1. StackEdit：[https://halo.run/store/apps/app-hDXMG](https://halo.run/store/apps/app-hDXMG)
2. ByteMD：[https://halo.run/store/apps/app-HTyhC](https://halo.run/store/apps/app-HTyhC)
1. StackEdit：[https://www.halo.run/store/apps/app-hDXMG](https://www.halo.run/store/apps/app-hDXMG)
2. ByteMD：[https://www.halo.run/store/apps/app-HTyhC](https://www.halo.run/store/apps/app-HTyhC)
:::
## 文章设置

4
versioned_docs/version-2.19/user-guide/users.md
View File

@@ -104,7 +104,7 @@ Halo 提供了全新创建和基于已有角色创建两种角色创建方式。
:::info
目前 Halo 官方提供的身份认证插件：
- OAuth2 认证：[https://halo.run/store/apps/app-ESVDK](https://halo.run/store/apps/app-ESVDK)
- OAuth2 认证：[https://www.halo.run/store/apps/app-ESVDK](https://www.halo.run/store/apps/app-ESVDK)
:::
你可以在用户管理界面的右上角点击 `身份认证` 按钮，进入身份认证管理页面。
@@ -115,4 +115,4 @@ Halo 提供了全新创建和基于已有角色创建两种角色创建方式。
![身份认证方式](/img/user-guide/users/auth-providers.png)
> 这里是安装了 [OAuth2 认证](https://halo.run/store/apps/app-ESVDK) 插件，提供了 `GitHub`、`GitLab`、`Gitee` 三种 OAuth2 认证方式。
> 这里是安装了 [OAuth2 认证](https://www.halo.run/store/apps/app-ESVDK) 插件，提供了 `GitHub`、`GitLab`、`Gitee` 三种 OAuth2 认证方式。

2
versioned_docs/version-2.20/developer-guide/core/code-style.md
View File

@@ -23,7 +23,7 @@ Halo 添加了 checkstyle 插件，来保证每位提交者代码的风格保持
- 导入 checkstyle.xm 配置：
![image.png](https://halo.run/upload/2020/2/image-0c7a018e73f74634a534fa3ba8806628.png)
![image.png](https://www.halo.run/upload/2020/2/image-0c7a018e73f74634a534fa3ba8806628.png)
- 选择 `./config/checkstyle/checkstyle.xml` 配置文件，点击确定即可。

4
versioned_docs/version-2.20/developer-guide/plugin/examples/todolist.md
View File

@@ -33,8 +33,8 @@ description: 这个例子展示了如何开发 Todo List 插件
requires: ">=2.0.0"
author:
name: halo-dev
website: https://halo.run
logo: https://halo.run/logo
website: https://www.halo.run
logo: https://www.halo.run/logo
homepage: https://github.com/halo-dev/plugin-starter#readme
repo: https://github.com/halo-dev/plugin-starter
issues: https://github.com/halo-dev/plugin-starter/issues

26
versioned_docs/version-2.20/getting-started/migrate-from-1.x.md
View File

@@ -6,17 +6,17 @@ description: 从 Halo 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 版本。
- Halo 2.0 不兼容 1.x 的主题，建议在升级前先查询你正在使用的主题是否已经支持 2.0。你可以访问 [halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo) 或 [应用市场](https://halo.run/store/apps?type=THEME) 查阅目前支持的主题。
- Halo 2.0 不兼容 1.x 的主题，建议在升级前先查询你正在使用的主题是否已经支持 2.0。你可以访问 [halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo) 或 [应用市场](https://www.halo.run/store/apps?type=THEME) 查阅目前支持的主题。
- Halo 2.0 目前没有内置 Markdown 编辑器，如果需要重新编辑迁移后的文章，需要额外安装 Markdown 编辑器插件。目前社区已经提供了以下插件：
- StackEdit：[https://halo.run/store/apps/app-hDXMG](https://halo.run/store/apps/app-hDXMG)
- ByteMD：[https://halo.run/store/apps/app-HTyhC](https://halo.run/store/apps/app-HTyhC)
- StackEdit：[https://www.halo.run/store/apps/app-hDXMG](https://www.halo.run/store/apps/app-hDXMG)
- ByteMD：[https://www.halo.run/store/apps/app-HTyhC](https://www.halo.run/store/apps/app-HTyhC)
- Halo 2.0 不再内置友情链接、日志、图库等模块，需要安装额外的插件，目前官方已提供：
- 链接管理：[https://halo.run/store/apps/app-hfbQg](https://halo.run/store/apps/app-hfbQg)
- 图库：[https://halo.run/store/apps/app-BmQJW](https://halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://halo.run/store/apps/app-SnwWD](https://halo.run/store/apps/app-SnwWD)
- 链接管理：[https://www.halo.run/store/apps/app-hfbQg](https://www.halo.run/store/apps/app-hfbQg)
- 图库：[https://www.halo.run/store/apps/app-BmQJW](https://www.halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://www.halo.run/store/apps/app-SnwWD](https://www.halo.run/store/apps/app-SnwWD)
- Halo 2.0 不再内置外部云存储的支持。需要安装额外的插件，目前官方已提供：
- S3（兼容国内主流的云存储）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
- 阿里云 OSS：[https://halo.run/store/apps/app-wCJCD](https://halo.run/store/apps/app-wCJCD)
- S3（兼容国内主流的云存储）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
- 阿里云 OSS：[https://www.halo.run/store/apps/app-wCJCD](https://www.halo.run/store/apps/app-wCJCD)
- 在迁移过程中不会保留旧版本的用户数据，迁移完成之后，关于文章等数据的关联都将改为 Halo 2.0 的新用户。
- 为了防止直接升级 2.0 导致 1.x 的数据受到破坏，我们已经将工作目录由 `~/.halo` 变更为 `~/.halo2`。
- 目前 Halo 2.0 仅提供 Docker 部署方式，没有提供可执行 JAR 包，但可以自编译，请参考 [构建](../developer-guide/core/build.md) 文档
@@ -54,11 +54,11 @@ description: 从 Halo 1.x 迁移的完整指南和注意事项
在迁移过程中，需要提前安装必要的插件：
- 站点迁移：[https://halo.run/store/apps/app-TlUBt](https://halo.run/store/apps/app-TlUBt)
- 链接管理：[https://halo.run/store/apps/app-hfbQg](https://halo.run/store/apps/app-hfbQg)
- 图库：[https://halo.run/store/apps/app-BmQJW](https://halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://halo.run/store/apps/app-SnwWD](https://halo.run/store/apps/app-SnwWD)
- S3（如果需要迁移存在云存储的附件，需要安装）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
- 站点迁移：[https://www.halo.run/store/apps/app-TlUBt](https://www.halo.run/store/apps/app-TlUBt)
- 链接管理：[https://www.halo.run/store/apps/app-hfbQg](https://www.halo.run/store/apps/app-hfbQg)
- 图库：[https://www.halo.run/store/apps/app-BmQJW](https://www.halo.run/store/apps/app-BmQJW)
- 瞬间（原日志）：[https://www.halo.run/store/apps/app-SnwWD](https://www.halo.run/store/apps/app-SnwWD)
- S3（如果需要迁移存在云存储的附件，需要安装）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
## 配置存储策略

6
versioned_docs/version-2.20/intro.md
View File

@@ -8,8 +8,8 @@ slug: /
---
<p align="center">
<a href="https://halo.run" target="_blank" rel="noopener noreferrer">
<img width="100" src="https://halo.run/logo" alt="Halo logo" />
<a href="https://www.halo.run" target="_blank" rel="noopener noreferrer">
<img width="100" src="https://www.halo.run/logo" alt="Halo logo" />
</a>
</p>
@@ -22,7 +22,7 @@ slug: /
<a href="https://github.com/halo-dev/halo/actions"><img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/halo-dev/halo/halo.yaml?branch=main&style=flat-square" /></a>
<a href="https://codecov.io/gh/halo-dev/halo"><img alt="Codecov percentage" src="https://img.shields.io/codecov/c/github/halo-dev/halo/main?style=flat-square&token=YsRUg9fall"/></a>
<br />
<a href="https://halo.run">官网</a>
<a href="https://www.halo.run">官网</a>
<a href="https://docs.halo.run">文档</a>
<a href="https://bbs.halo.run">社区</a>
<a href="https://gitee.com/halo-dev">Gitee</a>

6
versioned_docs/version-2.20/user-guide/attachments.md
View File

@@ -12,8 +12,8 @@ Halo 默认提供了本地的存储策略类型，你还可以通过安装插件
:::info
目前 Halo 官方维护了两个存储策略插件，可以根据需要选择安装：
1. 阿里云 OSS：[https://halo.run/store/apps/app-wCJCD](https://halo.run/store/apps/app-wCJCD)
2. Amazon S3 协议（主流云存储厂商均支持）：[https://halo.run/store/apps/app-Qxhpp](https://halo.run/store/apps/app-Qxhpp)
1. 阿里云 OSS：[https://www.halo.run/store/apps/app-wCJCD](https://www.halo.run/store/apps/app-wCJCD)
2. Amazon S3 协议（主流云存储厂商均支持）：[https://www.halo.run/store/apps/app-Qxhpp](https://www.halo.run/store/apps/app-Qxhpp)
:::
你可以点击附件页面右上角的 `存储策略` 按钮对存储策略进行管理。
@@ -24,7 +24,7 @@ Halo 默认提供了本地的存储策略类型，你还可以通过安装插件
![添加存储策略](/img/user-guide/attachments/attachment-policy-add.png)
添加时首先需要选择一种存储策略类型，系统内置的存储策略为本地存储，图中的 `S3 Object Storage` 由[对象存储（Amazon S3 协议）](https://halo.run/store/apps/app-Qxhpp)提供，此文档以本地存储为例。
添加时首先需要选择一种存储策略类型，系统内置的存储策略为本地存储，图中的 `S3 Object Storage` 由[对象存储（Amazon S3 协议）](https://www.halo.run/store/apps/app-Qxhpp)提供，此文档以本地存储为例。
![添加本地存储策略](/img/user-guide/attachments/attachment-policy-add-local.png)

2
versioned_docs/version-2.20/user-guide/common.md
View File

@@ -62,6 +62,6 @@ Halo 作为一款好用又强大的开源建站工具，配合上不同的模板
:::info
目前有两个官方渠道可以获取主题和插件：
- 应用市场：[https://halo.run/store/apps](https://halo.run/store/apps)
- 应用市场：[https://www.halo.run/store/apps](https://www.halo.run/store/apps)
- Awesome Halo：[https://github.com/halo-sigs/awesome-halo](https://github.com/halo-sigs/awesome-halo)
:::

4
versioned_docs/version-2.20/user-guide/posts.md
View File

@@ -21,8 +21,8 @@ description: 文章管理相关功能说明
:::info
Halo 支持通过插件来拓展文章编辑器，目前 Halo 官方维护了另外两款编辑器插件，可以按需安装使用：
1. StackEdit：[https://halo.run/store/apps/app-hDXMG](https://halo.run/store/apps/app-hDXMG)
2. ByteMD：[https://halo.run/store/apps/app-HTyhC](https://halo.run/store/apps/app-HTyhC)
1. StackEdit：[https://www.halo.run/store/apps/app-hDXMG](https://www.halo.run/store/apps/app-hDXMG)
2. ByteMD：[https://www.halo.run/store/apps/app-HTyhC](https://www.halo.run/store/apps/app-HTyhC)
:::
## 文章设置

4
versioned_docs/version-2.20/user-guide/users.md
View File

@@ -104,7 +104,7 @@ Halo 提供了全新创建和基于已有角色创建两种角色创建方式。
:::info
目前 Halo 官方提供的身份认证插件：
- OAuth2 认证：[https://halo.run/store/apps/app-ESVDK](https://halo.run/store/apps/app-ESVDK)
- OAuth2 认证：[https://www.halo.run/store/apps/app-ESVDK](https://www.halo.run/store/apps/app-ESVDK)
:::
你可以在用户管理界面的右上角点击 `身份认证` 按钮，进入身份认证管理页面。
@@ -115,4 +115,4 @@ Halo 提供了全新创建和基于已有角色创建两种角色创建方式。
![身份认证方式](/img/user-guide/users/auth-providers.png)
> 这里是安装了 [OAuth2 认证](https://halo.run/store/apps/app-ESVDK) 插件，提供了 `GitHub`、`GitLab`、`Gitee` 三种 OAuth2 认证方式。
> 这里是安装了 [OAuth2 认证](https://www.halo.run/store/apps/app-ESVDK) 插件，提供了 `GitHub`、`GitLab`、`Gitee` 三种 OAuth2 认证方式。