Stellar：实现完整的笔记体系

笔记系统适合持续更新、按标签树组织的页面。一个站点可以有多个笔记本，一篇笔记只能属于一个笔记本。

创建笔记本

在 source/_data/notebooks/ 中创建 YAML，文件名就是笔记本 id：

blog/source/_data/notebooks/dev-notes.yml

name: 开发笔记
headline: Development Notes
tagline: 持续整理的开发知识
description: 关于 Web、Node.js 和工具链的笔记。
identity:
  icon: /images/favicon.png
card:
  cover: https://example.com/notebook.webp
routing:
  base_dir: /notes/dev/
listing:
  sort: 1
  excerpt_length: 128
  per_page: 10
  order_by: -updated
navigation:
  menu: notes
footer:
  license: true
  share: true
sidebar:
  left:
    widgets: [tagtree, recent]
  right:
    widgets: []
note:
  sidebar:
    left:
      widgets: [tagtree, recent]
    right:
      widgets: [toc]

listing.sort 控制笔记本列表顺序；listing.per_page 和 listing.order_by 控制笔记列表。sidebar 用于笔记本列表页，note.sidebar 用于具体笔记页。

笔记本未显式配置 sidebar.left.brand 时，会从 identity.icon、name、tagline 和 routing.base_dir 生成自动 Brand；card.cover 不会作为 Brand 图片回退。

主题级默认值写在：

blog/_config.stellar.yml

notebook:
  listing:
    excerpt_length: 128
    per_page: null
    order_by: -updated
  tag_icons:
    '': quot:hashtag
  footer:
    license: false
    share: false

创建笔记

笔记是普通页面，通过 collection 关联笔记本：

blog/source/notes/nodejs/index.md

---
title: Node.js 笔记
collection:
  type: notebook
  id: dev-notes
tags:
  - knowledge/nodejs
  - tools
card:
  cover: https://example.com/note.webp
listing:
  priority: 5
---

嵌套标签使用 / 分隔，例如 knowledge/math/probability。标签树会根据所有笔记的 tags 自动生成。

listing.priority > 0 的笔记排在普通笔记之前，数字越大越靠前。不再接受 pin、sticky 或布尔值。

页面结构

笔记本列表页列出所有笔记本。
笔记本页按 listing.order_by 分页列出笔记。
标签页只显示对应标签及其子标签的笔记。
笔记页优先展示更新时间，并可显示标签、许可协议和分享入口。

笔记卡片的 card.cover 只用于列表卡片，不参与博客文章的 article.card_style。搜索框会自动限定在当前笔记本的 routing.base_dir。