第三方服务

今日诗词

在侧边栏author小部件中找到或者新增jinrishici字段。

取值含义
false不加载,不显示
true显示,当请求失败时显示config.title
String显示,当请求失败时显示String

示例

1
2
3
4
5
6
# 侧边栏小部件
widgets:
- widget: author
avatar: https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/avatar/avatar.png
jinrishici: 柳暗花明又一村
social: true

APlayer播放器

字段含义是否必须值类型默认值
color音乐控件的主题色HEX颜色值字符串-
volume默认音量0~1之间的浮点数0.7
mode播放模式枚举,详见【mode】circulation
server服务器枚举,详见【server】-
type表明id值是单曲、专辑还是歌单枚举,详见【type】-
id列表idString‘’

mode:

取值含义
random随机
single单曲
order列表顺序
circulation列表循环

server:

取值含义
netease网易云
tencentQQ音乐
xiami虾米
kugou酷狗

type:

取值含义
song单曲
album专辑
playlist播放列表

分享

MobShare(1.0.2已弃用)

源文件相关字段功能
./_config.ymlmobmob平台API配置

mob

字段含义值类型
app_key你的MobSDK的appkeyString
list你需要分享的平台配置Array

list

字段含义是否
id平台ID
name分享按钮的title
icon分享按钮的图标
img分享按钮的图片

其中,iconimg只能有一个。

平台名称平台ID
新浪微博weibo
微信weixin
QQ空间qzone
QQ好友qq
豆瓣网douban
Facebookfacebook
Twittertwitter
Pocketpocket
Google+google
有道云笔记youdao
Tumblrtumblr
Instapaperinstapaper
Linkedinlinkedin

示例

1
2
3
4
5
6
7
8
9
mob:
app_key: xxxxxxxxxx
list:
- id: weibo
name: 微博
img: https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/img/tieba/喷.png
- id: weixin
name: 微信
img: https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/img/tieba/what.png

使用主题内置的分享功能

源文件相关字段功能
./_config.ymlshare分享按钮配置
字段含义是否
id平台ID
name分享按钮的title
icon分享按钮的图标
img分享按钮的图片

其中,iconimg只能有一个。

平台名称平台ID
新浪微博weibo
QQ空间qzone
QQ好友qq

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
share:
- id: qq
name: QQ好友
img: https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/logo/128/qq.png
- id: qzone
name: QQ空间
img: https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/logo/128/qzone.png
- id: qrcode
name: 微信
img: https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/logo/128/wechat.png
- id: weibo
name: 微博
img: https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/logo/128/weibo.png
- id: qrcode
name: QRcode
img: https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/logo/128/qrcode.png

QRcode

上例中的生成QRcode链接分享需要安装插件:

1
npm i -S hexo-helper-qrcode

目前微信使用的是二维码分享,而二维码目前是直接在新页面打开图片文件,在Chrome上被禁止了,所以追求体验的用户可以先不要用微信和二维码。

评论系统

源文件相关字段功能
./_config.ymldisqus_shortname或者valine或者livere_uid全局是否支持评论系统
某篇文章.mdcomments某篇文章下方是否显示评论

提供3种可选,如果你使用其他的评论系统,请自己修改主题。

Disqus

官网: https://disqus.com/

示例

1
2
# disqus评论
disqus_shortname: #你的disqus的shortname#

Valine

官网: https://valine.js.org

示例

1
2
3
4
5
6
7
8
9
10
11
12
# valine
valine:
enable: true # 如果你想用Valine评论系统,请设置enable为true
app_id: # 必填
app_key: # 必填
guest_info: nick,mail,link #valine comment header info
placeholder: 快来评论吧~ # valine comment input placeholder(like: Please leave your footprints )
avatar: mp # gravatar style https://valine.js.org/avatar
pageSize: 10 # comment list page size
verify: false # valine verify code (true/false)
notify: false # valine mail notify (true/false)
lang: zh-cn

其中,placeholder支持在Front-matter中设置。

例如

1
2
valine:
placeholder: 你觉得xxx怎么样呢?

也可以通过设置valine.path实现多个页面共用一个评论框。

例如

1
2
valine:
path: /wiki/material-x/

Volantis

这是我基于Valine修改过的版本,增加了若干表情,禁止匿名评论。

主题已经默认开启,配置方法和valine一模一样,如果需要使用原版valine,需要在主题的_config.yml文件中找到services字段,将其中的volantis:true注释掉。

Livere

官网: http://www.laibili.com.cn/

示例

1
2
# 来必力评论
livere_uid: #你的livere的uid

在这里查看你的uid:https://livere.com/insight/myCode,在【代码管理 -> 一般网站】中找到如下这段代码,其中 data-uid 中的内容就是你的 livere_uid

1
2
3
<!-- 来必力City版安装代码 -->
<div id="lv-container" data-id="city" data-uid="你的livere的uid">
...

推荐文章

安装和配置推荐文章插件

源文件相关字段功能
themes/material-x/_config.ymlrecommended_posts全局是否支持推荐文章

如果你不想显示推荐文章,可以卸载 hexo-recommended-posts 这个依赖包。

示例

1
2
3
4
5
6
7
8
9
10
# 推荐文章
recommended_posts:
autoDisplay: false # 自动在文章底部显示推荐文章,如果你使用Material-X主题,这里要设置为false。
server: https://api.truelaurel.com # 后端推荐服务器地址
timeoutInMillis: 10000 # 服务时长,超过此时长,则使用离线推荐模式
excludePattern: []
titleHtml: <h4>推荐文章</h4> #自定义标题
internalLinks: 3 # 内部文章数量
externalLinks: 2 # 外部文章数量
fixedNumber: false

注意:autoDisplay: false 这一项不要修改,因为自动显示效果不佳,我已经在主题里给它设置显示位置了。

是否显示推荐文章

源文件字段默认值功能
某篇文章.mdrecommended_poststrue某篇文章下方是否显示推荐文章

如果主题配置中没有提供recommended_posts,则这里的设置无效。

示例

1
2
3
---
recommended_posts: false
---

分析与统计

默认支持不蒜子的访问统计,可以添加百度统计、以leancloud为后端的阅读统计。

百度统计

源文件相关字段功能
./_config.ymlbaidu_analytics_key百度统计的key

Google Analytics

源文件相关字段功能
./_config.ymlgoogle_analytics_keyGoogle Analytics的key
./_config.ymlroot_domain域名



评论