Skip to content

Commit

Permalink
docs: add issues field for theme and plugin manifest example (#342)
Browse files Browse the repository at this point in the history
为主题和插件的配置文件示例添加 issues 字段。

Ref halo-dev/halo#5755

/kind documentation

```release-note
None
```
  • Loading branch information
ruibaby committed Apr 30, 2024
1 parent fd7eac2 commit 7e0fbd8
Show file tree
Hide file tree
Showing 5 changed files with 7 additions and 0 deletions.
2 changes: 2 additions & 0 deletions docs/developer-guide/plugin/basics/manifest.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@ spec:
# configMapName: hello-world-configmap
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
displayName: "插件 Hello world"
description: "插件开发的 hello world,用于学习如何开发一个简单的 Halo 插件"
license:
Expand Down Expand Up @@ -52,6 +53,7 @@ spec:

- `spec.homepage`:通常设置为插件官网或帮助中心链接等。
- `spec.repo`:插件源码地址。
- `spec.issues`:插件问题反馈地址,如果你的插件是开源在 GitHub 上,可以直接配置为 GitHub Issues 地址。
- `spec.displayName`:插件的显示名称,它通常是以少数几个字来概括插件的用途。
- `spec.description`:插件描述,用一段简短的说明来介绍插件的用途。
- `spec.license`:插件使用的软件协议,参考:<https://en.wikipedia.org/wiki/Software_license>
Expand Down
1 change: 1 addition & 0 deletions docs/developer-guide/plugin/examples/todolist.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ description: 这个例子展示了如何开发 Todo List 插件
logo: https://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
displayName: "插件 Todo List"
description: "插件开发的 hello world,用于学习如何开发一个简单的 Halo 插件"
license:
Expand Down
2 changes: 2 additions & 0 deletions docs/developer-guide/theme/config.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@ spec:
logo: https://www.halo.run/logo
homepage: https://github.com/halo-sigs/theme-foo
repo: https://github.com/halo-sigs/theme-foo.git
issues: https://github.com/halo-sigs/theme-foo/issues
settingName: "theme-foo-setting"
configMapName: "theme-foo-configMap"
customTemplates:
Expand Down Expand Up @@ -58,6 +59,7 @@ spec:
| `spec.logo` | 主题 Logo ||
| `spec.homepage` | 主题网站 ||
| `spec.repo` | 主题代码托管地址 ||
| `spec.issues` | 主题问题反馈地址,如果你的主题是开源在 GitHub 上,可以直接配置为 GitHub Issues 地址。 ||
| `spec.settingName` | 设置表单定义的名称,需要同时创建对应的 `settings.yaml` 文件 ||
| `spec.configMapName` | 设置持久化配置的 ConfigMap 名称 ||
| `spec.customTemplates.post` | 文章的自定义模板配置,详细文档可查阅 [模板路由](./template-route-mapping#custom-templates) ||
Expand Down
1 change: 1 addition & 0 deletions docs/developer-guide/theme/prepare.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,7 @@ spec:
logo: https://www.halo.run/logo
homepage: https://github.com/halo-sigs/theme-foo
repo: https://github.com/halo-sigs/theme-foo.git
issues: https://github.com/halo-sigs/theme-foo/issues
settingName: "theme-foo-setting"
configMapName: "theme-foo-configMap"
version: 1.0.0
Expand Down
1 change: 1 addition & 0 deletions docs/developer-guide/theme/settings.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ spec:
logo: https://www.halo.run/logo
homepage: https://github.com/halo-sigs/theme-foo
repo: https://github.com/halo-sigs/theme-foo.git
issues: https://github.com/halo-sigs/theme-foo/issues
settingName: "theme-foo-setting"
configMapName: "theme-foo-configMap"
version: 1.0.0
Expand Down

0 comments on commit 7e0fbd8

Please sign in to comment.