文章样式 articles
样式
正文字体大小
配置项名称：articles.style.font_size
| 类型 | 备注 | 可选值 | 默认值 |
|---|---|---|---|
| 字符串 | 如无特别需要不建议更改 | "*px" | "16px" |
正文行高
配置项名称：articles.style.line_height
| 类型 | 备注 | 可选值 | 默认值 |
|---|---|---|---|
| 数字 | 如无特别需要不建议更改 | 1-5 | 1.5 |
图片圆角大小
配置项名称：articles.style.image_border_radius
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 字符串 | "*px" | "14px" |
图片对齐
配置项名称：articles.style.image_alignment
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 字符串 | left | center | center |
图片描述
开启后，图片下方会按照 alt 属性的内容显示图片描述。
配置项名称：articles.style.image_caption
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 布尔值 | true | false | true |
链接图标
是否在文章中的链接后面显示图标。
配置项名称：articles.style.link_icon
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 布尔值 | true | false | true |
字数统计
需要安装 hexo-wordcount 插件。
请执行以下命令安装：
npm install hexo-wordcount开关
配置项名称：articles.word_count.enable
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 布尔值 | true | false | true |
字数
配置项名称：articles.word_count.count
是否开启字数统计。
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 布尔值 | true | false | true |
阅读时间
配置项名称：articles.word_count.min2read
是否开启阅读时间统计。
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 布尔值 | true | false | true |
作者标签
开关
配置项名称：articles.author_label.enable
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 布尔值 | true | false | true |
自动标签
配置项名称：articles.author_label.auto
自动打上 Lv1、Lv2、Lv3 等标签。
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 布尔值 | true | false | false |
自定义标签
配置项名称：articles.author_label.list
自定义标签列表。
| 类型 | 备注 | 示例 |
|---|---|---|
| 数组 | 请用英文逗号分隔 | ["Lv1", "Lv2", "Lv3"] |
代码块
复制按钮
配置项名称：articles.code_block.copy
是否开启代码块复制按钮。
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 布尔值 | true | false | true |
样式
配置项名称：articles.code_block.style
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 字符串 | mac | simple | mac |
mac 样式：
simple 样式：
字体
配置项名称：articles.code_block.font
enable：是否开启自定义字体。family：字体名称。url：到字体 CSS 样式文件的 URL，比如 Google Fonts 的https://fonts.googleapis.com/css2?family=Source+Code+Pro:wght@400;500;600;700&display=swap。
目录
开关
配置项名称：articles.toc.enable
是否开启目录。
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 布尔值 | true | false | true |
最大深度
配置项名称：articles.toc.max_depth
设置目录最大深度。
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 数字 | 1-6 | 3 |
编号
配置项名称：articles.toc.number
是否开启目录编号。
全部展开
配置项名称：articles.toc.expand
是否全部展开。
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 布尔值 | true | false | true |
默认打开 TOC
配置项名称：articles.toc.init_open
是否默认打开 TOC。
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 布尔值 | true | false | true |
文章版权
开关
配置项名称：articles.copyright.enable
是否在文章末尾展示文章版权信息。
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 布尔值 | true | false | true |
默认版权信息
配置项名称：articles.copyright.default
可选值：
all_rights_reserved：保留所有权利。cc_by_nc_sa：署名-非商业性使用-相同方式共享，详情请见 CC BY-NC-SA 4.0 (opens in a new tab)。cc_by_nc：署名-非商业性使用，详情请见 CC BY-NC 4.0 (opens in a new tab)。cc_by_nd：署名-禁止演绎，详情请见 CC BY-ND 4.0 (opens in a new tab)。cc_by_sa：署名-相同方式共享，详情请见 CC BY-SA 4.0 (opens in a new tab)。cc_by：署名，详情请见 CC BY 4.0 (opens in a new tab)。public_domain：公有领域，详情请见 CC0 1.0 (opens in a new tab)。
自定义版权信息
如需自定义文章使用的版权信息，请在文章的 Front-matter 中添加 license 字段，比如：
---
title: Hello World
date: 2021-03-22 19:20:00
license: all_rights_reserved
---可选值请参考上面的说明。
请注意，如果你的文章 Front-matter 中有 license 字段，那么这个字段的值会覆盖 default 的值。
如果以上选项不能满足你的需求，你可以在主题配置文件中使用 copyright 自定义说明信息，比如：
---
title: Hello World
date: 2021-03-22 19:20:00
copyright: 本文是瞎写的，你如果要用的话，后果自负。
---请注意，copyright 项比 license 优先级更高。所以如果你两个都写了，只有 copyright 会生效
懒加载
配置项名称：articles.lazyload
是否开启图片懒加载，在图片多的博客尤其有效，能够加快页面加载速度。
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 布尔值 | true | false | true |
文章推荐
自动根据文章关键词，推荐相关文章。
需要安装 nodejieba 模块。迁移自 hexo-theme-volantis。
请执行以下命令安装：
npm install nodejieba@2.5.2开关
配置项名称：articles.recommendation.enable
是否开启推荐文章。
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 布尔值 | true | false | false |
标题
配置项名称：articles.recommendation.title
推荐文章这个区块的标题。
| 类型 | 备注 | 默认值 |
|---|---|---|
| 字符串 | 无 | 推荐文章 |
推荐数量
配置项名称：articles.recommendation.limit 和 articles.recommendation.mobile_limit
limit 指的是在电脑端推荐文章的数量，mobile_limit 指的是在手机端的推荐文章数量。
| 类型 | 可选值 | 默认值 |
|---|---|---|
| 数字 | 1-10 | 3 |
排除目录
配置项名称：articles.recommendation.skip_dirs
推荐文章时，排除的目录。
| 类型 | 备注 | 示例 |
|---|---|---|
| 数组 | 请用英文逗号分隔 | ["/docs/", "/private/"] |