Micro Essays

Learn how to configure Micro Essays page for the Solitude theme.

Modifying Theme Configuration

You need to modify the following configuration

_config.solitude.yml
# 此处为914行
# --------------------------- start ---------------------------
# Brevity Page
# 即刻短文
brevity:
  enable: true
  home_mini: true
  music: false
  page: /essay/
  style: 1
  strip: 30
# --------------------------- end ---------------------------

Configuring the Page

Open a terminal in the root directory of your Hexo blog and run the following command to create a new page:

hexo new page essay

This will generate a essay folder in your blog's source directory containing an index.md file. Add the page type and data value inside this file.

Reference (modify as needed):

index.md
---
title: Micro Essays
date: 2025-07-13 23:55:48
type: brevity
cover: ""
desc: 分享生活的小确幸
leftend: ""
rightend: ""
---

Create a _data folder in your blog's source directory, then create a file named brevity.yml inside it.

Configure your content here using the template below:

Micro Essay Content Template

brevity.yml
- content: 普通文字短文
  date: 2025-01-01 00:00
- content: B站视频短文
  date: 2025-01-01 00:00
  video:
    bilibili: 填写视频bvid
- content: 外链视频短文
  date: 2025-01-01 00:00
  video:
    player: 视频直链
- content: 音乐短文
  date: 2025-01-01 00:00
  aplayer:
    server: 音乐服务商,如netease
    id: 单曲id,不了解具体查看方法建议询问搜索引擎
- content: 图片短文(无图片描述)
  date: 2025-01-01 00:00
  image:
    - 可直接填写图片直链
- content: 图片短文(有图片描述)
  date: 2025-01-01 00:00
  image:
    - url: 图片直链
      alt: 图片描述
- content: 链接短文
  date: 2025-01-01 00:00
  link: 链接
- content: 地点短文
  date: 2025-01-01 00:00
  location: 发布地点

File Structure Reference

Field Descriptions

Required Fields

FieldTypeDescription
dateDate stringPost publish date
contentStringEssay content

Optional Fields

FieldTypeDescriptionSub-fields
imageArrayImage collectionElements can be strings or objects
aplayerObjectMusic player configserver, id
videoObjectVideo configplayer or bilibili
locationStringLocation information-
linkURLRelated link-

Nested Field Details

  1. aplayer Object
FieldRequiredDescriptionExample
serverMusic platform ID"netease"
idSong ID"9465695843"
  1. video Object
FieldTypeDescriptionExample
playerURLDirect video link"https://example.com/video.mp4"
bilibiliBV IDBilibili video ID"BV1AH4y1p7mF"
  1. image Array
TypeStructureDescription
StringAs aboveDirect image URL
ObjectAs aboveImage with alt text