Hexo Front-Matter简介
Front-matter是markdown文件上方以---分割的区域,用于指定当前文章参数
- Page Front-Matter 用于单独页面配置
- Post Front-Matter 用于文章页配置
Hexo Page Front-Matter选项
可以配置参数如下
1 | --- |
| 配置选项参数 | 默认值 | 配置选项参数说明 |
|---|---|---|
| title | 「必须」页面标题 | |
| date | 「必须」页面创建日期 | |
| type | 「必须」标签、分类和友情链接三个页面需要配置 | |
| updated | 「可选」页面更新日期 | |
| description | 「可选」页面描述 | |
| keywords | 「可选」页面关键字 | |
| comments | true | 「可选」显示页面评论模块 |
| top_img | false | 「可选」页面顶部图片 |
| mathjax | false | 「可选」显示mathjx |
| katex | false | 「可选」显示katex |
| aside | true | 「可选」显示侧边栏 |
| aplayer | 「可选」在需要的页面加载aplayer的js和css | |
| highlight_shrink | 「可选」配置代码框是否展开 |
Front-matter选项中所有内容均为非必填项,建议至少填写title和date值
Hexo Post Front-Matter选项
1 | --- |
| 配置选项参数 | 默认值 | 配置选项参数说明 |
|---|---|---|
| title | markdown文件标题 | 「必须」文章标题,强烈建议填写该选项 |
| date | 文件创建日期 | 「必须」文章创建日期,强烈建议填写此选项,且最好保证全局唯一 |
| updated | 文件更新日期 | 「可选」文章更新日期 |
| tags | 「可选」文章标签,一篇文章可多个标签 | |
| categories | 「可选」文章分类,主题分类显示宏观大分类,建议一篇文章一个分类 | |
| keywords | 文章关键字 | 「可选」文章关键字,SEO时需要 |
| description | 文章描述 | 「可选」文章描述 |
| top_img | 「可选」文章顶部图,推荐使用图床来做路径 | |
| cover | false | 「可选」文章缩略图,(未设置top_img,文章页顶部将显示缩略图,可设置false,图片地址,留空) |
| comments | true | 「可选」显示文章评论模块,默认true |
| toc | toc的enable配置 | 「可选」显示文章TOC(默认为设置中TOC的enable配置)permalink_defaults:是否开启TOC,可以针对某篇文章单独关闭TOC功能。前提是主题配置文件中激活了toc选项 |
| toc_number | toc的number配置 | 「可选」显示toc_number |
| toc_style_simple | 「可选」显示toc简洁模式 | |
| copyright | true | 「可选」显示文章版权模块(默认为设置中post_copyright的enable设置) |
| copyright_author | 「可选」文章版权模块的作者 | |
| copyright_author_href | 「可选」文章版权模块的文章作者链接 | |
| copyright_url | 「可选」文章版权模块的文章链接 | |
| copyright_info | 「可选」文章版权模块的版权声明文字 | |
| mathjax | false | 「可选」显示mathjx |
| katex | false | 「可选」显示katex |
| aside | true | 「可选」显示侧边栏 |
| aplayer | 「可选」在需要的页面加载aplayer的js和css | |
| highlight_shrink | 「可选」配置代码框是否展开 |
本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议。转载请注明来源 rminit's blog!