halo-dev / docs Goto Github PK
View Code? Open in Web Editor NEWThe open-source repo for docs.halo.run
Home Page: https://docs.halo.run
The open-source repo for docs.halo.run
Home Page: https://docs.halo.run
发布周期,各版本之间区别等等。
比如:
建议提供一个维护者准则文档,用于向社区透明 Halo 开源的运作方式,包括但不限于:
如题,目前我们计划 2.0 不再提供发行版的可执行 Jar。所以期望提供自编译的文档。
目前 Halo 为主题提供了如 site
的全局变量,但目前没有相关文档,期望补充。
/kind documentation
外部地址大概率会在博客搭建好后修改,且修改频次大多情况下只有 1 次。
为了让用户不因为修改外部地址而修改命令或重建容器,建议将此设置的配置方式优化为配置文件(application.yaml)。这样用户只需要重启一下即可生效。
/kind improvement
如题,我们需要为 Halo 2.0 编写各个特性的使用文档。
涉及版本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
如题,目前在主题开发文档中,是没有提供 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
期望添加补充。
参考:https://docusaurus.io/versions
/assign
/kind documentation
如题。
/kind documentation
目前 Halo 提供了 <halo:comment />
和 <halo:footer />
标签,但没有相关文档。
目前 Halo 2.0 已经支持了插件机制,期望为插件开发编写文档。
/kind documentation
目前在开发环境运行的文档中虽然要求了使用 dev 的配置文件运行,但是开发者如果不看配置文件,那么是不知道用户名和密码的,所以可以添加一个提示。
No response
参考获取多级菜单的标签,使用<@categoryTag method="tree"> 标签可以成功获取到树结构的文章分类列表但文档中没有提及。建议补充文档说明。
No response
请参考:halo-dev/halo#2880 (comment)
/kind bug
/kind documentation
在使用tencentCloudBase部署时,因为项目模板是在github上面,代码会拉不下来,请求一直超时导致部署失败;
所以只好将GitHub的代码clone下来,放到gitee,修改为gitee的地址后正常才可以正常部署。
希望官方文档能够更新一下
目前宝塔面板已经支持部署托管 Java 应用。
目前为:
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://book.prow.tidb.io/#/
/kind documentation
/cc @halo-dev/sig-docs
/kind documentation
RT
/assign
/kind documentation
RT
如题,我们需要为 Halo 2.0 提供主题的开发文档。稍后我会将基本的大纲列在下方评论。
/kind documentation
目前 Halo 已经合并了支持原生 MariaDB 驱动的 PR,需要对应修改文档。
RT
同步 https://github.com/halo-dev/halo/blob/913002d56d64b7dbd20b169921754a12790fcf80/CONTRIBUTING.md
See halo-dev/halo#1888 for more.
/kind documentation
/assign @JohnNiang
目前所有的三方指南的内容都已经过时,建议暂时移除掉过时的链接。请参考:https://docs.halo.run/getting-started/install/third-party。
如题,我们需要在 2.0 发布之前,提供从 1.x 迁移到 2.0 的文档。
请看:https://docs.halo.run/developer-guide/theme/finder-apis/contributor
方法名叫做 getContributor
,但示例里面写的是 ${contributorFinder.getByName('contributor-foo')}
/cc @guqing
这里为什么是叫 getContributor
,而不是 getByName
呢?
Halo 2.1.0 即将支持自定义资源的 Annotations,所以需要为主题和插件开发提供定义 Annotations 表单的文档。
/kind documentation
鉴于即将发布的 Halo 1.5 的文档可能与 1.4.x 有差异,所以考虑配置多版本文档。参考:https://docusaurus.io/docs/docs-multi-instance
比如在这个案例中,同一行的模板变量有的带!有的不带,在我具体使用的时候似乎有时候不写!会报错但我没有多留意测试,默认全都加上!了,询问一下这里的具体规则。
RT
版本: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的官网上没有相关的文档,只有命令行配置文档,但是命令行配置的文档,无法配置容器的运行内存大小,图形化配置当中可以配置运行内存,希望能够提供相关的配置说明。谢谢!
目前,我们仅提供了用 Docker 或 Docker Compose 安装 Halo 2.0 的文档,但是还缺少如何更新 Halo 2.x 的文档。
参考:
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.