Commit Graph

31 Commits

Author SHA1 Message Date
Ryan Wang
461b7e089e Use shiki as code highlighter (#521) 2025-10-29 18:18:23 +08:00
Ryan Wang
46143f9c8b chore: bump docusaurus to 3.8 (#498) 2025-05-27 19:15:18 +08:00
Ryan Wang
22600b7f6f fix: missing example display for ListedPostVo type (#482)
修复 ListedPostVo 类型示例不显示的问题。

Fixes #480 

```release-note
None
```
2024-12-09 11:23:35 +00:00
Ryan Wang
002d1f472d chore: bump docusaurus to 3.6.2 (#471)
升级 Docusaurus 至 3.6.2,以修复开发环境无法启动的问题。

```release-note
None
```
2024-11-20 03:26:07 +00:00
Ryan Wang
aa466d9b72 chore: bump docusaurus to canary verison (#428)
Support for building projects via rspack has been added in the latest Canary version of Docusaurus, which significantly improves compilation speed. 

```bash
❯ hyperfine --prepare 'pnpm clear' --runs 5 'DOCUSAURUS_FASTER=false pnpm build' 'DOCUSAURUS_FASTER=true pnpm build'
Benchmark 1: DOCUSAURUS_FASTER=false pnpm build
  Time (mean ± σ):     70.715 s ± 17.150 s    [User: 134.096 s, System: 31.651 s]
  Range (min … max):   52.330 s … 88.497 s    5 runs

Benchmark 2: DOCUSAURUS_FASTER=true pnpm build
  Time (mean ± σ):     30.094 s ±  4.572 s    [User: 64.061 s, System: 28.384 s]
  Range (min … max):   25.832 s … 37.655 s    5 runs

Summary
  DOCUSAURUS_FASTER=true pnpm build ran
    2.35 ± 0.67 times faster than DOCUSAURUS_FASTER=false pnpm build
```

see: https://github.com/facebook/docusaurus/issues/10556#issuecomment-2407671873

```release-note
None 
```
2024-10-31 09:48:01 +00:00
guqing
0b1d4596d5 feat: diagrams can be rendered using Mermaid in a code block (#458)
### What this PR does?
添加对 Mermaid Diagrams 的支持

```release-note
None
```
2024-10-31 05:28:51 +00:00
Ryan Wang
250c0180d7 chore: bump docusaurus version to 3.x (#395)
升级 Docusaurus 版本至 3.x

参照 https://docusaurus.io/zh-CN/docs/migration/v3 升级指南。

Fixes #394 

/kind improvement

```release-note
None
```
2024-08-09 14:12:40 +00:00
Ryan Wang
d78a16e217 chore: use swc instead of esbuild (#359)
使用 swc 代替 esbuild,之前在 https://github.com/halo-dev/docs/pull/358 中引入了 esbuild,但发现在生产构建之后会出现这个问题:

<img width="1912" alt="image" src="https://github.com/halo-dev/docs/assets/21301288/5dcd724d-3876-4e58-b902-1818dd9d1fbd">

暂时不清楚为什么,使用 swc 测试构建之后没有这个问题。

/kind bug

```release-note
None
```
2024-05-28 05:18:58 +00:00
Ryan Wang
ac0b158b73 chore: use esbuild instead of babel (#358)
引入 esbuild,提升构建速度。

before:

<img width="777" alt="image" src="https://github.com/halo-dev/docs/assets/21301288/49d28d76-1c10-47c8-ac8c-31b41a31f6bd">

after:

<img width="888" alt="image" src="https://github.com/halo-dev/docs/assets/21301288/61462a4c-ba66-4612-9363-67e5d394601b">


/kind improvement

```release-note
None
```
2024-05-28 03:42:57 +00:00
Ryan Wang
b4e637b4b0 chore: use selfhosted-meilisearch as docs search engine (#357)
使用自建的 Meilisearch 作为文档搜索引擎,代替 Algolia。

/kind improvement

```release-note
None
```
2024-05-28 03:12:58 +00:00
Ryan Wang
1d97214ad3 chore: remove 1.x documentation (#303)
移除 1.x 的文档,以及清除一些过时文档。

1.x 所有文档已经被移动到 https://github.com/halo-dev/v1-legacy-docs 并托管在 https://v1.legacy-docs.halo.run

<img width="669" alt="图片" src="https://github.com/halo-dev/docs/assets/21301288/684e4b0e-fc60-44ae-bda1-52fe62c4670d">

/kind cleanup

```release-note
None
```
2024-01-02 02:38:12 +00:00
Ryan Wang
12a8b47426 feat: add image zoom feature (#250)
支持点击放大图片。

```release-note
None 
```
2023-09-06 08:56:14 +00:00
Ryan Wang
5e70b24ed1 chore: bump docusaurus version to 2.4 (#228)
升级 Docusaurus 的版本至 2.4 

```release-note
None
```
2023-06-09 06:36:11 +00:00
Ryan Wang
bc4497eeac docs: bump docusaurus version to 2.3.0 (#184)
升级 docusaurus 的版本:https://github.com/facebook/docusaurus/releases/tag/v2.3.0

/kind improvement

```release-note
None
```
2023-02-03 07:14:13 +00:00
BugKing
3ee41adb3a Adapt lint script in Windows platform (#119)
```release-note
None
```
2022-11-25 10:43:07 +00:00
Ryan Wang
4921736046 refactor: document versioning structure (#99)
重构文档版本结构。

- 移除 1.5/1.4 相关所有 patch 版本的文档,使用 1.5/1.4 版本号代替。
- 创建 1.6 的文档版本。
- 后续针对 1.5 或者 1.6 的更新,可以直接对具体版本进行更改。

本打算使用 [@docusaurus/plugin-client-redirects](https://docusaurus.io/zh-CN/docs/api/plugins/@docusaurus/plugin-client-redirects) 做已删除的 patch 版本的重定向,旦可能不是很好满足匹配重定向的需求。~~所以在此 PR 合并之前我将通过 Nginx 对具体版本进行重定向转发~~。

比如:`/1.4.17/{path}` 重定向到 `/1.4/{path}`,`/1.5.4/{path}` `/1.5.3/{path}` 都从定向到 `/1.5/{path}`

/kind documentation
/cc @halo-dev/sig-docs 

> PS: 此 PR 未对新发布的 [1.6.0](https://github.com/halo-dev/halo/releases/tag/v1.6.0) [1.5.5](https://github.com/halo-dev/halo/releases/tag/v1.5.5) [2.0.0-alpha.2](https://github.com/halo-dev/halo/releases/tag/v2.0.0-alpha.2) 做修改,将在后续 PR 更改。

```release-note
None
```
2022-10-13 03:58:14 +00:00
Ryan Wang
2e421f26ab chore: bump docusaurus to 2.1.0 (#91)
升级 docusaurus 到 2.1.0

- https://github.com/facebook/docusaurus/releases/tag/v2.0.0
- https://github.com/facebook/docusaurus/releases/tag/v2.1.0

```release-note
none
```
2022-09-28 15:14:16 +00:00
Ryan Wang
d605271fcc docs: update markdown.md for Halo 1.5.x (#70)
* doc: update markdown document

Signed-off-by: Ryan Wang <i@ryanc.cc>

* docs: update markdown.md

Signed-off-by: Ryan Wang <i@ryanc.cc>

* docs: update markdown.md

Signed-off-by: Ryan Wang <i@ryanc.cc>

* docs: update markdown.md

Signed-off-by: Ryan Wang <i@ryanc.cc>
2022-04-14 05:35:16 +00:00
Ryan Wang
ddcfbeed36 release: create 1.5.2 version (#69)
Signed-off-by: Ryan Wang <i@ryanc.cc>
2022-04-10 17:09:00 +08:00
Ryan Wang
75405a306d release: create 1.5.0 version (#54)
Signed-off-by: Ryan Wang <i@ryanc.cc>
2022-03-23 13:01:57 +08:00
Ryan Wang
b64030c98f chore: bump docusaurus to beta 17 (#46)
Signed-off-by: Ryan Wang <i@ryanc.cc>
2022-03-07 14:15:40 +08:00
Ryan Wang
ea16bf0046 chore: bump docusaurus to beta 16 (#44)
Signed-off-by: Ryan Wang <i@ryanc.cc>
2022-02-26 12:08:00 +08:00
Ryan Wang
7e023448fc chore: use markdownlint and add pre commit hook (#41)
Signed-off-by: Ryan Wang <i@ryanc.cc>
2022-02-14 15:34:33 +08:00
Ryan Wang
1749c8f1b9 chore(deps): upgrade docusaurus to beta.14 (#23) 2022-01-05 17:07:43 +08:00
Ryan Wang
8767974c17 chore(deps): upgrade docusaurus to beta.13 (#15) 2021-12-12 16:02:48 +08:00
Ryan Wang
de31762622 chore: remove wwads 2021-11-26 23:06:30 +08:00
Ryan Wang
d13850f10a chore(deps): upgrade docusaurus to beta 9. 2021-11-03 22:45:48 +08:00
Ryan Wang
3a0e85e455 chore(deps): upgrade docusaurus to beta 8. 2021-10-23 23:22:16 +08:00
Ryan Wang
60dc1880e6 feat: add route redirects. 2021-10-08 23:46:29 +08:00
Ryan Wang
4289778be3 feat: add images. 2021-10-05 15:21:21 +08:00
Ryan Wang
d1d89b21a1 first commit 2021-10-05 14:30:42 +08:00