Page Front-matter
| 写法 |
解释 |
| title |
【必需】页面标题 |
| date |
【必需】页面创建日期 |
| type |
【必需】标签、分类和友情链接三个页面需要配置 |
| updated |
【可选】页面更新日期 |
| description |
【可选】页面描述 |
| keywords |
【可选】页面关键字 |
| comments |
【可选】显示页面评论模块 (默认 true) |
| top_img |
【可选】页面顶部图片 |
| mathjax |
【可选】显示 mathjax (当设置 mathjax 的 per_page: false 时，才需要配置，默认 false) |
| katex |
【可选】显示 katex (当设置 katex 的 per_page: false 时，才需要配置，默认 false) |
| aside |
【可选】显示侧边栏 (默认 true) |
| aplayer |
【可选】在需要的页面加载 aplayer 的 js 和 css, 请参考文章下面的音乐 配置 |
| highlight_shrink |
【可选】配置代码框是否展开 (true/false)(默认为设置中 highlight_shrink 的配置) |
Post Front-matter
| 写法 |
解释 |
| title |
【必需】文章标题 |
| date |
【必需】文章创建日期 |
| updated |
【可选】文章更新日期 |
| tags |
【可选】文章标籤 |
| categories |
【可选】文章分类 |
| keywords |
【可选】文章关键字 |
| description |
【可选】文章描述 |
| top_img |
【可选】文章顶部图片 |
| cover |
【可选】文章缩略图 (如果没有设置 top_img, 文章页顶部将显示缩略图，可设为 false / 图片地址 / 留空) |
| comments |
【可选】显示文章评论模块 (默认 true) |
| toc |
【可选】显示文章 TOC (默认为设置中 toc 的 enable 配置) |
| toc_number |
【可选】显示 toc_number (默认为设置中 toc 的 number 配置) |
| toc_style_simple |
【可选】显示 toc 简洁模式 |
| copyright |
【可选】显示文章版权模块 (默认为设置中 post_copyright 的 enable 配置) |
| copyright_author |
【可选】文章版权模块的文章作者 |
| copyright_author_href |
【可选】文章版权模块的文章作者链接 |
| copyright_url |
【可选】文章版权模块的文章连结链接 |
| copyright_info |
【可选】文章版权模块的版权声明文字 |
| mathjax |
【可选】显示 mathjax (当设置 mathjax 的 per_page: false 时，才需要配置，默认 false) |
| katex |
【可选】显示 katex (当设置 katex 的 per_page: false 时，才需要配置，默认 false) |
| aplayer |
【可选】在需要的页面加载 aplayer 的 js 和 css, 请参考文章下面的音乐 配置 |
| highlight_shrink |
【可选】配置代码框是否展开 (true/false)(默认为设置中 highlight_shrink 的配置) |
| aside |
【可选】显示侧边栏 (默认 true) |
标签
{% note [color] [icon] [style] %}
Any content (support inline tags too.io).
{% endnote %}
|
| 名称 |
用法 |
| color |
【可选】顔色
(default / blue / pink / red / purple / orange / green) |
| icon |
【可选】可配置自定义 icon (只支持 fontawesome 图标，也可以配置 no-icon) |
| style |
【可选】可以覆盖配置中的 style
（simple/modern/flat/disabled） 推荐使用 flat |
Example
{% note 'fab fa-cc-visa' modern %}
你是刷 Visa 还是 UnionPay
{% endnote %}
{% note blue 'fas fa-bullhorn' modern %}
2021年快到了....
{% endnote %}
{% note pink 'fas fa-car-crash' modern %}
小心开车 安全至上
{% endnote %}
{% note red 'fas fa-fan' modern%}
这是三片呢？还是四片？
{% endnote %}
{% note orange 'fas fa-battery-half' modern %}
你是刷 Visa 还是 UnionPay
{% endnote %}
{% note purple 'far fa-hand-scissors' modern %}
剪刀石头布
{% endnote %}
{% note green 'fab fa-internet-explorer' modern %}
前端最讨厌的浏览器
{% endnote %}
|
tag-hide
如果你想把一些文字、内容隐藏起来，并提供按钮让用户点击显示。可以使用这个标签外挂
请注意，tag-hide 内的标签外挂 content 内都不建议有 h1 - h6 等标题。因为 Toc 会把隐藏内容标题也显示出来，而且当滚动屏幕时，如果隐藏内容没有显示出来，会导致 Toc 的滚动出现异常。
详细内容请查看点击查看
Tabs
类似与上面的 tag-hide
点击查看
高亮文字
| 参数 |
解释 |
| text |
文字 |
| color |
【可选】背景颜色，默认为 default
default/blue/pink/red/purple/orange/green |
Demo
臣亮言：{% label 先帝 %}创业未半，而{% label 中道崩殂 blue %}。今天下三分，{% label 益州疲敝 pink %}，此诚{% label 危急存亡之秋 red %}也！然侍衞之臣，不懈于内；{% label 忠志之士 purple %}，忘身于外者，盖追先帝之殊遇，欲报之于陛下也。诚宜开张圣听，以光先帝遗德，恢弘志士之气；不宜妄自菲薄，引喻失义，以塞忠谏之路也。
宫中、府中，俱为一体；陟罚臧否，不宜异同。若有{% label 作奸 orange %}、{% label 犯科 green %}，及为忠善者，宜付有司，论其刑赏，以昭陛下平明之治；不宜偏私，使内外异法也。
|
timeline
{% timeline title,color %}
<!-- timeline title -->
xxxxx
<!-- endtimeline -->
<!-- timeline title -->
xxxxx
<!-- endtimeline -->
{% endtimeline %}
|
| 参数 |
解释 |
| title |
标题 / 时间线 |
| color |
timeline 颜色
default (留空) /blue/pink/red/purple/orange/green |
Demo
{% timeline 2022,red %}
<!-- timeline 01-02 -->
这是测试页面
<!-- endtimeline -->
{% endtimeline %}
|
