Halo Theme Joe3
文档:部分配置请参考 Joe3不完全使用指导指南
halo-theme-Joe3 是一款 Halo2.0 的博客主题
由halo-theme-joe2.0适配而来,感谢原作者的无私奉献
安裝
下载安装
下载releases或者直接下载代码,通过 Halo Console 后台主题安装处上传即可。
使用说明
1、首次使用请先把主题所有配置保存一遍
2、部分功能使用插件进行实现
3、请配合Halo2.8.0及以上版本使用
4、菜单栏的图标请使用iconfont的图标,需要填入Font Family 和图标代码例如:jiewen joe-icon-tupian
5、使用自定义标签样式请以插入HTML文本形式使用,标签请参考Joe3部分样式或者直接使用插件标签
主题配置
基本设置
Waline设置
Waline基础配置
该配置项可以对Waline进行自定义基础配置,内容为json格式,如果配置未生效,请先检查填入的内容是否为json格式,可以前往JSON校验网站进行格式校验。为了方便用户填写,这里提供如下样例,具体所代表的含义以及更多配置项请参考Waline官网。
{
"search":false,
"reaction":true,
"login":"force",
"locale": {
"placeholder":"欢迎评论啦啦啦"
},
"emoji": [
"//unpkg.com/@waline/emojis@1.2.0/weibo",
"//unpkg.com/@waline/emojis@1.2.0/bmoji"
]
}
Waline图片上传配置
该配置项可以配置Waline的图片上传方式
- 默认
默认的图片上传方式上传的图片最大只能128Kb
- 兰空图床
该配置项可以配置Waline的图片上传至兰空图床,需要自建兰空图床服务
兰空图床上传设置
- 兰空图床服务端地址
兰空图床服务端地址,如 https://img.example.com/api/v1/upload 不要加结尾反斜杠
- 兰空图床Token
兰空图床Token,如 2|1bJbwlqBfnggmOMEZqXT5XusaIwqiZjCDs7r1Ob5
,通过配置Token可以进行图片上传的权限控制,如果为空则以游客身份上传(需要在兰空图床开放游客上传的权限)
如何获取Token?
通过兰空图床api获取,请求示例如下:
curl -X POST https://img.example.com/api/v1/tokens \
-H "Content-Type: application/json" \
-d '{
"email": "email@qq.com",
"password": "password***"
}'
如果出现如下报错,请在末尾加入参数-k
来忽略证书验证
curl: (60) schannel: SEC_E_UNTRUSTED_ROOT (0x80090325) - More details here: https://curl.se/docs/sslcerts.html
curl failed to verify the legitimacy of the server and therefore could not
establish a secure connection to it.
返回结果示例:
{"status":true,"message":"success","data":{"token":"2|1bJbwlqBfnggmOMEZqXT5XusaIwqiZjCDs7r1Ob5"}}
预览
WIP
TODO
- 优化图库
- …
🏭 贡献
如果你想帮助完善
Joe3.0
主题,请:
- 点
star
- 提
issue
- 修
bugs
- 推
pr
奉献提示
此仓库分为main和dev分支,如何您想奉献代码,请fork dev分支,开发完成后提交pr到dev分支,dev分支会定期合并到main分支,main分支为稳定版本且dev分支才是最新代码,不接受pr。
现在只维护main分支,dev分支不再维护,如有需要请直接提交pr到main分支。
🙆♂️ 感谢
在此感谢以下项目提供的支持:
- Halo
- theme-starter
- Typecho Themes Joe
- Halo-theme-Joe2.0
- Halo-theme-hao
- Halo-theme-sakura
- plugin-links
- plugin-comment-widget
- plugin-search-widget
- plugin-moments
- plugin-photos
- …
交流群
QQ群号(929708466)欢迎大家前来交流分享