海灵总结

海灵提示：今天为你梳理了博客主题的排版语法与各项配置规范。内容涵盖文章和页面的基础参数设置，普通页面与错误页面的创建及配置方法，自定义音乐播放地址的语法规则，以及引用块和代码块的具体书写格式与应用示例。这些实用的排版技巧能帮你更好地建设博客，快来一起泡杯茶，轻松掌握这些实用内容吧。

文章(post)及页面(page)配置

配置是最上方以 --- 分隔的区域，用于指定单个页面的配置。

标注有可选的参数，可选填

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的配置)

写法	解释
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)

创建普通页面的语法为

1	hexo n page 页面标题

主题内置了一个简单的404页面，可在设置中开启

# _config.butterfly.yml
error_404:
  enable: true
  sublayout: post
title:  "页面没有找到"
  background:  #侧边图

本地预览时，访问出错的网站是不会跳到404页面的。
如需本地预览，请访问http://localhost:4000/404.html

具体文档在这里

1
2
3

{% blockquote [author[, source]] [link] [source_link_title] %}
content
{% endblockquote %}

1
2
3

{% blockquote [author[, source]] [link] [source_link_title] %}
content
{% endblockquote %}

content

[author[source]] [link] [source_link_title]

1
2
3

{% codeblock [title] [lang:language] [url] [link text] [additional options] %}
code snippet
{% endcodeblock %}

#普通的代码块
{% codeblock %}
alert('Hello World!');
{% endcodeblock %}

1	alert('Hello World!');