第六篇 Hexo 魔改实录 | 配置闲言碎语页面

Penry2025-07-092025-07-10

Hexo + Anzhiyu 配置闲言碎语页面 | 附 YAML 字段详解

💬 想写点碎碎念，又不想太隆重？Hexo 博客里的「闲言碎语」页面就派上用场啦！这篇文章将手把手教你配置，并解释 essay.yml 中每个字段的含义，适合 Anzhiyu 主题用户。

🧱 一、页面创建

在 Hexo 博客根目录执行以下命令：

1	hexo new page essay

会生成一个页面文件：source/essay/index.md
请将该文件内容修改为：

---
title: 闲言碎语
layout: essay
type: essay
top_img: false
aside: false
comments: false
---

其中 layout: essay 必须和主题目录下的 layout/essay.pug 文件匹配，否则页面无法正确渲染。

🗂️ 二、创建数据文件 `essay.yml`

在 source/_data/ 目录下创建一个名为 essay.yml 的文件，这个文件将承载你所有的碎碎念数据。

以下是一个完整范例：

- title: 闲言碎语
  subTitle: 一些碎碎念 ✨
  tips: 思绪偶尔发发光
  top_background: https://your.cdn.com/img/bg.jpg
  buttonText: 回到首页
  buttonLink: /
  limit: 10
  essay_list:
    - content: 今天阳光真好，适合发呆☀️
      date: 2025-07-09
      from: 心情记录
      address: 南京
      image:
        - /img/sunshine.jpg

    - content: 看了一篇强化学习论文，好像稍微懂一点了
      date: 2025-07-08
      from: 学习笔记
      link: https://arxiv.org/abs/1234.5678

🔍 三、字段详解

字段名	类型	含义
`title`	`string`	页面主标题（如：闲言碎语）
`subTitle`	`string`	副标题，展示在大标题下方
`tips`	`string`	页面底部一句话提示，可诗意或幽默
`top_background`	`url`	页面顶部横幅图背景
`buttonText`	`string`	按钮上的文字（比如“回到首页”）
`buttonLink`	`string`	按钮点击跳转的链接
`limit`	`number`	页面上展示的短文数量（防止过多加载）
`essay_list`	`array`	你的碎碎念内容集合

essay_list 子字段

字段	类型	说明
`content`	`string`	内容正文（必须）
`date`	`YYYY-MM-DD`	记录的时间
`from`	`string`	来源说明（如“生活随记”、“学习记录”）
`address`	`string`	地点，如“长沙”
`link`	`url`	可跳转的外链（如论文地址）
`image`	`array`	附图路径列表
`video`	`array`	视频链接（支持本地或 bilibili iframe）
`aplayer`	`object`	音乐播放器配置，如网易云歌曲 id、server、type 等