Skip to content

post

post 用于设置文章内容页的文章字数统计阅读时长作者标识版权信息分享功能打赏功能 等。

yaml
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 设置是否显示 作者标识(徽标/称号),可选值:truefalse

有两种配置方案:level_badgecustom_badge

level_badge

level_badge 设置是否开启自动生成 Lv1Lv2Lv3 ... 的等级标识,可选值:truefalse

判断依据为已发布的文章数量,Lv 级别越高,增长越慢。

yaml
author_badge:
  enable: true
  level_badge: true

image

custom_badge

custom_badge 自定义配置作者标识列表,数组项可以 一个多个,匹配的依据是按文章数量。

自定义配置需要设置 level_badge: false

  • 只配置一个的作者标识 不管文章数量多少,将一直显示这个数组项的标识。

    yaml
    # 示例
    author_badge:
      enable: true
      level_badge: false
      custom_badge: 前端鼓励师

    image

  • 配置多个的作者标识
    根据你的发布的文章数量,自动匹配作者标识。

    yaml
    author_badge:
      enable: true
      level_badge: false
      custom_badge: ["炼气", "筑基", "结丹", "元婴", "化神"]

image

image

word_count

word_count 用于实现 文章字数统计计算阅读时长,启用前需在 Hexo 项目根目录下安装 Hexo 插件:hexo-wordcount

sh
cd your-hexo
npm install hexo-wordcount

wordcount

wordcount 显示文章字数统计,可选值:truefalse

yaml
word_count:
  wordcount: true

image

min2read

min2read 显示文章阅读时长,可选值:truefalse

yaml
word_count:
  min2read: true

image

datetime_format v3.7.2

datetime_format 用于设置文章创建时间和更新时间的显示格式,默认为 YYYY-MM-DD HH:mm:ss

image

使用示例:

yaml
datetime_format: "YYYY 年 MM 月 DD 日 HH:mm"

image

copyright_info 用于在文章末尾开启 文章版权信息,可选值:truefalse

yaml
copyright_info: true

image

自定义版权信息 v4.1.0

v4.1.0 起,支持自定义设置文章的版权信息。

  • custom_license 自定义配置 License
  • custom_link 自定义配置 License 的跳转链接

使用示例:

yaml
copyright_info:
  custom_license: Custom License
  custom_link: https://xpoet.cn/license/

效果图:

image

share v3.8.0

share 是 Keep 主题 v3.8.0 新增的配置项,用于在文章末尾开启 文章分享 功能,可选值:truefalse

yaml
share: true

image

目前仅支持将文章快捷分享到 QQ、微信、微博,后续版本支持分享到 X-推特、Facebook 等。

reward v3.8.0

reward 是 Keep 主题 v3.8.0 新增的 打赏作者 功能。

enable

enable 用于在文章末尾开启 打赏作者 功能,可选值:truefalse

image

enable 用于配置打赏作者的收款码图片,可填写 本地图片路径图片链接

yaml
# 本地图片路径
img_link: /images/reward.png

# 图片链接
img_link: https://cdn.statically.io/gh/XPoet/image-hosting@master/FE-Cheerleaders/play-tour.png

image

text

text 用于配置打赏作者按钮的悬浮提示词,可以为空,不填将使用 Keep 主题内置提示词。

使用示例:

  • 不填

    yaml
    reward:
      enable: true
      img_link: /images/reward.png
      text:
    • image

    • image

  • text: 请作者喝咖啡

    yaml
    reward:
      enable: true
      img_link: /images/reward.png
      text: 请作者喝咖啡

    image

img_align v4.0.5

img_alignv4.0.5 新增的隐藏配置项,用于设置文章中图片的排列位置,可选值:left (居左) | center (居中) | right (居右)。

使用示例:

  • img_align: left 居左(默认)

    image

  • img_align: center 居中

    image

  • img_align: right 居右

    image

提示

img_align 是隐藏的配置项,你可以将其放入到主题配置文件中,快速实现修改图片的排列位置。

由于 Keep 主题的样式是高度可定制的,作者建议你使用 inject 注入 CSS 功能 来修改图片排列文章。

created_datetime_icon v4.1.0

created_datetime_iconv4.1.0 新增的隐藏配置项,用于自定义设置文章创建(发布)时间的图标。

updated_datetime_icon v4.1.0

updated_datetime_iconv4.1.0 新增的隐藏配置项,用于自定义设置文章更新时间的图标。

Released under the AGPL-3.0 License