文章(post)及页面(page)配置
配置是最上方以 --- 分隔的区域，用于指定单个页面的配置。
- Page 用于
页面配置 - Post 用于
文章页配置
标注有可选的参数，可选填
Page
| 参数 | 解释 |
|---|---|
| title | 【必需】页面标题 |
| sticky | 【可选】页面权重，数值越大，置顶的优先级越大。当为1时文章置顶 |
| 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
| 写法 | 解释 |
|---|---|
| title | 【必需】文章标题 |
| date | 【必需】文章创建日期 |
| updated | 【可选】文章更新日期 |
| tags | 【可选】文章标籤 |
| categories | 【可选】文章分类 |
| keywords | 【可选】文章关键字 |
| description | 【可选】文章描述 |
| top_img | 【可选】文章顶部图片 |
| headimg | 【可选】文章缩略图(如果没有设置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) |
页面
普通页面
创建普通页面的语法为
hexo n page 页面标题
404页面
主题内置了一个简单的404页面，可在设置中开启
# _config.butterfly.yml
error_404:
enable: true
sublayout: post
title: "页面没有找到"
background: #侧边图
本地预览时，访问出错的网站是不会跳到404页面的。
如需本地预览，请访问http://localhost:4000/404.html
音乐
自定义音乐地址(普通音乐播放)
语法
Hexo语法
具体文档在这里
引用块
语法
{% blockquote [author[, source]] [link] [source_link_title] %}
content
{% endblockquote %}
例子
{% blockquote [author[, source]] [link] [source_link_title] %}
content
{% endblockquote %}
content
代码块
语法
{% codeblock [title] [lang:language] [url] [link text] [additional options] %}
code snippet
{% endcodeblock %}
例子
#普通的代码块
{% codeblock %}
alert('Hello World!');
{% endcodeblock %}
alert('Hello World!');
