Skip to content

jiewenhuang/halo-theme-joe3.0

Repository files navigation

Halo Theme Joe3

Halo Release License


预览: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部分样式或者直接使用插件标签

主题配置

基本设置

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. 注册账号

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

  1. 添加产品

具体操作如下图所示:

添加产品

  1. 配置插件并获取token

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

首先配置插件:

配置插件

其次点击生成代码获取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分支。

🙆‍♂️ 感谢

在此感谢以下项目提供的支持:


交流群

QQ群号(929708466)欢迎大家前来交流分享

QQ群

TinyTale小程序

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