记一笔 How to

每本书对应一页 Markdown，文件名建议用英文 slug，例如 my-book-slug.md。

新建一本书

1
npx hexo new book "my-book-slug"

会在 source/_posts/my-book-slug.md 生成笔记，预览地址为 /notes/my-book-slug/。

统一模板字段

每篇笔记建议包含以下区块（可直接复制 scaffolds/book.md）：

区块 说明
书目信息 书名、作者、开始/读完日期、状态、评分（可选）
一句话 这本书对我是什么
印象最深的 3 点 读完仍记得的核心
摘录与批注 少摘多评；可留空
我的心得 / 会怎么用 个人感受与行动
相关书 站内链接，可空
评分 1–5，可选

Front matter 建议

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
---
title: 书名（页面标题）
layout: book
book_title: 书名
book_author: 作者
book_status: 想读   # 想读 | 在读 | 读完
bg_image: /img/books/my-book-slug/bg.jpg   # 可选
float_image: /img/books/my-book-slug/float.png
start_date:
finish_date:
rating:
tags:
  - 标签名
categories:
  - 主题名
---

同步到书单

  1. 在 书单 表格加一行
  2. 若在读，在 在读 页加卡片或链接
  3. 用 categories 归类到 主题

单书背景与小图（可选）

主站（首页 / 书单 / 在读等）仍用主题默认背景；只有笔记页可单独定制。

在笔记 front matter 里（layout: book）增加：

1
2
3
4
5
6
layout: book
bg_image: /img/books/my-book-slug/bg.jpg
float_image: /img/books/my-book-slug/float.png
float_position: br          # br 右下 | bl 左下 | tr 右上
bg_overlay: 0.68            # 亮色模式遮罩，越大背景越淡
bg_overlay_dark: 0.82       # 暗色模式遮罩（可省略）

图片放在 source/img/books/<slug>/，例如：

1
2
3
source/img/books/qingdai-mingjia-cixuanjiang/
  bg.jpg      ← 全页背景
  float.png   ← 透明底悬浮小图

去哪找合适配图

类型 来源 说明
简约通用 Unsplash / Pexels 搜 minimal paper、desk、fog mountain
水墨 / 古籍风 Wikimedia Commons 搜 Chinese ink landscape、old paper texture；注意许可
与书相关 自己拍书影、扉页、笔记纸 最贴题；裁成横图作 bg.jpg
悬浮小图 自己裁 PNG，或 Commons 里的印章 / 花卉线稿 要透明底，尺寸不必大

《清代名家词选讲》 可试：留白山水、宣纸纹理作背景；印章、卷轴、梅瓣作 float。关键词：ink wash、rice paper、plum blossom line art。

工作流

1
2
npm run dev    # 边写 Markdown 边预览
npm run build  # 生成静态文件到 public/