halo-dev / docs Goto Github PK

RT

同步 https://github.com/halo-dev/halo/blob/913002d56d64b7dbd20b169921754a12790fcf80/CONTRIBUTING.md

See halo-dev/halo#1888 for more.

/kind documentation
/assign @JohnNiang

外部地址大概率会在博客搭建好后修改，且修改频次大多情况下只有 1 次。

为了让用户不因为修改外部地址而修改命令或重建容器，建议将此设置的配置方式优化为配置文件（application.yaml）。这样用户只需要重启一下即可生效。

/kind improvement

目前所有的三方指南的内容都已经过时，建议暂时移除掉过时的链接。请参考：https://docs.halo.run/getting-started/install/third-party。

如题，我们需要为 Halo 2.0 编写各个特性的使用文档。

https://bbs.halo.run/d/1956-docker-xmx

目前，我们仅提供了用 Docker 或 Docker Compose 安装 Halo 2.0 的文档，但是还缺少如何更新 Halo 2.x 的文档。

参考：

• https://bbs.halo.run/d/3095-20%E5%8D%87%E7%BA%A7%E9%95%9C%E5%83%8F%E5%92%8C1x%E7%9A%84%E4%B8%80%E6%A0%B7%E5%90%97

目前在开发环境运行的文档中虽然要求了使用 dev 的配置文件运行，但是开发者如果不看配置文件，那么是不知道用户名和密码的，所以可以添加一个提示。

错误位置

图库#根据分组获取图片（listbyteam）

错误描述

method listByTeam 示例为 listTeams，并且示例中遍历时使用team对象进行遍历

如题，我们需要在 2.0 发布之前，提供从 1.x 迁移到 2.0 的文档。

https://github.com/halo-sigs/plugin-migrate

如题，目前我们计划 2.0 不再提供发行版的可执行 Jar。所以期望提供自编译的文档。

目前 Halo 提供了 <halo:comment /> 和 <halo:footer /> 标签，但没有相关文档。

建议提供一个维护者准则文档，用于向社区透明 Halo 开源的运作方式，包括但不限于：

1. 版本发布流程相关，比如版本发布节奏，版本维护周期。
2. 依赖更新，比如 patch 版本非特定情况不允许更新依赖。
3. PR 提交相关。
4. 开源社区维护相关。

涉及版本2.1、2.2
修改前：

docker run \
  -it -d \
  --name halo \
  -p 8090:8090 \
  -v ~/.halo2:/root/.halo2 \
  halohub/halo:2.1 \
  --halo.external-url=http://localhost:8090/ \
  --halo.security.initializer.superadminuser=admin \
  --halo.security.initializer.superadminpassword=P@88w0rd

修改后：

docker run \
  -it -d \
  --name halo \
  -p 8090:8090 \
  -v ~/.halo2:/root/.halo2 \
  halohub/halo:2.1 \
  --halo.external-url=http://localhost:8090/ \
  --halo.security.initializer.superadminusername=admin \
  --halo.security.initializer.superadminpassword=P@88w0rd

RT

如题，目前在主题开发文档中，是没有提供 VO 类型定义中字段的解释的，如 https://docs.halo.run/2.0.0-SNAPSHOT/developer-guide/theme/template-variables/index_#%E7%B1%BB%E5%9E%8B%E5%AE%9A%E4%B9%89

期望添加补充。

目前宝塔面板已经支持部署托管 Java 应用。

请看：https://docs.halo.run/developer-guide/theme/finder-apis/contributor

方法名叫做 getContributor，但示例里面写的是 ${contributorFinder.getByName('contributor-foo')}

/cc @guqing

这里为什么是叫 getContributor，而不是 getByName 呢？

你当前使用的版本

版本：1.4.17 数据库：MySQL 5.7.18-txsql-log 运行模式：production User Agent：Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/97.0.4692.99 Safari/537.36 Edg/97.0.1072.76

描述一下此特性

宝塔自带的docker管理器当中，可以通过图形化界面创建容器，但是halo的官网上没有相关的文档，只有命令行配置文档，但是命令行配置的文档，无法配置容器的运行内存大小，图形化配置当中可以配置运行内存，希望能够提供相关的配置说明。谢谢！

附加信息

在使用tencentCloudBase部署时，因为项目模板是在github上面，代码会拉不下来，请求一直超时导致部署失败；

所以只好将GitHub的代码clone下来，放到gitee，修改为gitee的地址后正常才可以正常部署。

希望官方文档能够更新一下

比如：

• halo-dev/halo#1777
• halo-dev/halo#1676
• Nginx 配置相关

发布周期，各版本之间区别等等。

你当前使用的版本

No response

描述一下此特性

参考获取多级菜单的标签，使用<@categoryTag method="tree"> 标签可以成功获取到树结构的文章分类列表但文档中没有提及。建议补充文档说明。

附加信息

No response

目前 Halo 2.0 已经支持了插件机制，期望为插件开发编写文档。

/kind documentation

请参考：halo-dev/halo#3274 (comment)。

https://bbs.halo.run/d/2062-idea2021-checkstyle-scope

halo-dev/halo#1470 (comment)

请参考：halo-dev/halo#2925

/kind documentation

你当前使用的版本

1.5.4

描述一下此特性

文档版本 2.2， 这个提示建议删掉，每次看到这个提示，都感觉官方不建议升到 2.0+ .......

附加信息

目前 Halo 已经合并了支持原生 MariaDB 驱动的 PR，需要对应修改文档。

halo-dev/halo#2787

如题，我们需要为 Halo 2.0 提供主题的开发文档。稍后我会将基本的大纲列在下方评论。

/kind documentation

see halo-dev/halo#3072

/assign

RT

鉴于即将发布的 Halo 1.5 的文档可能与 1.4.x 有差异，所以考虑配置多版本文档。参考：https://docusaurus.io/docs/docs-multi-instance

请参考：halo-dev/halo#2880 (comment)

/kind bug
/kind documentation

https://docs.halo.run/user-guide/plugins#%E5%8D%B8%E8%BD%BD%E6%8F%92%E4%BB%B6

/kind documentation

现在 Halo 已经支持了通过参数来配置应用，请参考：halo-dev/halo#3098

期望文档也与这种方式保持一致。

/kind improvement
/kind documentation

请参考：halo-dev/halo#2923

/kind documentation

RT

如题。

/kind documentation

参考：https://github.com/halo-dev/halo-admin/blob/master/netlify.toml

参考：https://docusaurus.io/versions

/assign
/kind documentation

https://docs.halo.run/contribution/pr

拉取代码部分还是使用的 master 分支。

/kind documentation

Halo 2.1.0 即将支持自定义资源的 Annotations，所以需要为主题和插件开发提供定义 Annotations 表单的文档。

/kind documentation

• halo-dev/console#770
• halo-dev/halo#3028

主题开发文档中关于文章和自定义页面的 VO 描述需要添加 lastModifyTime 字段

halo-dev/halo#3101

/kind documentation

比如在这个案例中，同一行的模板变量有的带！有的不带，在我具体使用的时候似乎有时候不写！会报错但我没有多留意测试，默认全都加上！了，询问一下这里的具体规则。

目前 Halo 为主题提供了如 site 的全局变量，但目前没有相关文档，期望补充。

/kind documentation

类似于 https://book.prow.tidb.io/#/

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

目前为：

git clone https://github.com/halo-dev/halo

// 如果你在 Github 上已经添加了你的 ssh key，请使用以下命令进行 clone：
git clone [email protected]:halo-dev/halo.git

git submodule init

git submodule update

建议修改为：

git clone --recursive [email protected]:halo-dev/halo.git

请看：https://github.com/halo-sigs/charts