Halo Theme Joe3

预览：Jiewen's Blog

文档：部分配置请参考 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部分样式或者直接使用插件标签

• [x] 卡片化设计
• [x] 响应式主题
• [x] 深色模式
• [X] 文章目录
• [X] 代码高亮/语言/复制）
• [x] 文章搜索
• [x] 显示字数统计
• [x] 显示相关文章
• [X] 评论系统
• [x] 友情链接
• [x] 瞬时
• [x] 图库
• [x] 其他功能

主题配置

基本设置

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"}}

博主信息

展示天气信息

注意：天气的文字颜色为白色，考虑到用户使用的背景不同，如果不合适，请自行通过代码注入修改字体颜色以适配自己的博客

改配置项配置博主信息是否展示天气信息

天气插件token

由于和风天气插件已经停止服务，所以将其替换为心知天气插件

1. 注册账号

前往心知天气官网注册账号并登录控制台

2. 添加产品

具体操作如下图所示：

3. 配置插件并获取token

前往该网站配置插件，目前该网站在控制台中不可见，不知道是不是也要停止服务了😅

首先配置插件：

其次点击生成代码获取token：

预览

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）欢迎大家前来交流分享

TinyTale小程序

TinyTale Halo微信小程序正式版发布