post
post
用于设置文章内容页的文章字数统计、阅读时长、作者标识、版权信息、分享功能 和 打赏功能 等。
post:
author_badge:
enable: true # Option values: true | false
level_badge: true # Option values: true | false
custom_badge: ["One", "Two", "Three"]
word_count:
wordcount: false # Word count, one article. Option values: true | false
min2read: false # Time to read, one article. Option values: true | false
datetime_format: "YYYY-MM-DD HH:mm:ss" # Datetime format. e.g. "YYYY-MM-DD HH:mm:ss"
copyright_info: false # Option values: true | false
share: false # Option values: true | false
reward:
enable: false # Option values: true | false
img_link: # Image link for the payment QR code
text: # Custom reward text, Can be null
author_badge v4.0.0
author_badge
设置文章内容页的作者标识(徽标/称号)。
enable
enable
设置是否显示 作者标识(徽标/称号),可选值:true
或 false
。
有两种配置方案:level_badge
和 custom_badge
。
level_badge
level_badge
设置是否开启自动生成 Lv1
、Lv2
、Lv3
... 的等级标识,可选值:true
或 false
。
判断依据为已发布的文章数量,Lv 级别越高,增长越慢。
author_badge:
enable: true
level_badge: true
custom_badge
custom_badge
自定义配置作者标识列表,数组项可以 一个 或 多个,匹配的依据是按文章数量。
自定义配置需要设置
level_badge: false
。
只配置一个的作者标识 不管文章数量多少,将一直显示这个数组项的标识。
yaml# 示例 author_badge: enable: true level_badge: false custom_badge: 前端鼓励师
配置多个的作者标识
根据你的发布的文章数量,自动匹配作者标识。yamlauthor_badge: enable: true level_badge: false custom_badge: ["炼气", "筑基", "结丹", "元婴", "化神"]
word_count
word_count
用于实现 文章字数统计 和 计算阅读时长,启用前需在 Hexo 项目根目录下安装 Hexo 插件:hexo-wordcount。
cd your-hexo
npm install hexo-wordcount
wordcount
wordcount
显示文章字数统计,可选值:true
或 false
。
word_count:
wordcount: true
min2read
min2read
显示文章阅读时长,可选值:true
或 false
。
word_count:
min2read: true
datetime_format v3.7.2
datetime_format
用于设置文章创建时间和更新时间的显示格式,默认为 YYYY-MM-DD HH:mm:ss
。
使用示例:
datetime_format: "YYYY 年 MM 月 DD 日 HH:mm"
copyright_info
copyright_info
用于在文章末尾开启 文章版权信息,可选值:true
或 false
。
copyright_info: true
自定义版权信息 v4.1.0
自 v4.1.0
起,支持自定义设置文章的版权信息。
custom_license
自定义配置 Licensecustom_link
自定义配置 License 的跳转链接
使用示例:
copyright_info:
custom_license: Custom License
custom_link: https://xpoet.cn/license/
效果图:
share v3.8.0
share
是 Keep 主题 v3.8.0
新增的配置项,用于在文章末尾开启 文章分享 功能,可选值:true
或 false
。
share: true
目前仅支持将文章快捷分享到 QQ、微信、微博,后续版本支持分享到 X-推特、Facebook 等。
reward v3.8.0
reward
是 Keep 主题 v3.8.0
新增的 打赏作者 功能。
enable
enable
用于在文章末尾开启 打赏作者 功能,可选值:true
或 false
。
img_link
enable
用于配置打赏作者的收款码图片,可填写 本地图片路径 或 图片链接。
# 本地图片路径
img_link: /images/reward.png
# 图片链接
img_link: https://cdn.statically.io/gh/XPoet/image-hosting@master/FE-Cheerleaders/play-tour.png
text
text
用于配置打赏作者按钮的悬浮提示词,可以为空,不填将使用 Keep 主题内置提示词。
使用示例:
不填
yamlreward: enable: true img_link: /images/reward.png text:
text: 请作者喝咖啡
yamlreward: enable: true img_link: /images/reward.png text: 请作者喝咖啡
img_align v4.0.5
img_align
是 v4.0.5
新增的隐藏配置项,用于设置文章中图片的排列位置,可选值:left
(居左) | center
(居中) | right
(居右)。
使用示例:
img_align: left
居左(默认)img_align: center
居中img_align: right
居右
提示
img_align
是隐藏的配置项,你可以将其放入到主题配置文件中,快速实现修改图片的排列位置。
由于 Keep 主题的样式是高度可定制的,作者建议你使用 inject 注入 CSS 功能 来修改图片排列文章。
created_datetime_icon v4.1.0
created_datetime_icon
是 v4.1.0
新增的隐藏配置项,用于自定义设置文章创建(发布)时间的图标。
设置方式:
created_datetime_icon: 图标类名
INFO
使用示例:
yamlpost: created_datetime_icon: fa-solid fa-star
效果图:
updated_datetime_icon v4.1.0
updated_datetime_icon
是 v4.1.0
新增的隐藏配置项,用于自定义设置文章更新时间的图标。
设置方式:
updated_datetime_icon: 图标类名
INFO
使用示例:
yamlpost: updated_datetime_icon: fa-solid fa-arrows-rotate
效果图: