待办事项插件

为了更好地管理全站的学习规划和临时任务，我编写了一个 TODO 插件。它可以自动提取全站所有 Markdown 文档中的待办事项，并生成一个汇总页面。

插件功能

自动收集：通过 Transformer 插件扫描所有文档中的 - [ ] 和 - [x] 节点。
属性扩展：支持通过 [priority::N] 设置优先级（1-4），通过 [created::YYYY-MM-DD] 设置创建日期。
动态排序：支持按创建时间（正序/倒序）或优先级（正序/倒序）动态重排，且始终保持“未完成优先”。
首页组件：在首页底部展示最新的待办任务，样式与“最近更新”模块保持高度统一。
汇总页面：生成 /todo 路由，支持分页显示（每页 10 条）与极简风格元数据展示。
精准定位：每条待办事项都带有来源链接，且支持 Quartz 的 Popover 预览功能。
内容隐藏：插件会自动在原文档渲染时隐藏属性文本，保持正文整洁。
无刷新交互：分页与排序均通过客户端脚本实现，无需刷新页面即可获得流畅体验。
手动补充：如果根目录下存在 content/todo.md，汇总页会优先展示其中的手动规划内容。

界面交互

在 /todo 汇总页，您可以利用顶部的工具栏和底部的导航进行交互：

排序重排：点击“📅 时间”或“🔥 优先级”按钮。
- 初次点击：应用默认排序（时间为倒序 ↓，优先级为正序 ↑）。
- 再次点击：在该模式下切换正序/倒序。
分页导航：列表底部显示 “Prev” 和 “Next” 按钮。
- 默认每页展示 10 条任务。
- 翻页操作不会导致页面滚动，保持当前阅读视点。

语法规范

在任何 Markdown 文档中，您可以像这样书写待办事项：

- [ ] 这是一个紧急任务 [priority::1] [created::2026-01-18]
- [ ] 这是一个普通任务 [priority::2]
- [x] 已完成的任务

优先级：使用 [priority::数字]，数字越小优先级越高（推荐 1-4）。汇总页会显示为 P1、P2 等。
创建日期：使用 [created::YYYY-MM-DD]。

这些属性标记在原文档阅读时不可见，仅在 /todo 汇总页中展示。

如何使用

下载文件

请将以下文件下载并保存至项目的 quartz/custom/ 对应位置：

插件文件夹：Todo/
统一入口：index.ts (若已存在则需补充 Todo 相关的导出)

启用插件

配置 Transformers：在 quartz.config.ts 中添加：
```
Custom.TodoTransformer(),
```
配置 Emitters：在 quartz.config.ts 中添加：
```
Custom.TodoEmitter(),
```

配置布局：在 quartz.layout.ts 的 afterBody 中添加组件：

Component.ConditionalRender({
  component: Custom.RecentTodo({
    title: "最新待办",
    limit: 1,
  }),
  condition: (page) => page.fileData.slug === "index",
}),

注意事项

ID 冲突：插件会根据每个文件中的 TODO 数量自动生成 ID（如 todo-1）。由于每个文件的计数是独立的，跨文件可能会有重复的 ID，但通过结合文件 Slug（#todo-1），在页面定位和预览时是唯一的。
排序逻辑：系统始终保持“未完成项目在前”。在同状态下：
- 时间模式：可选正序（↑）或倒序（↓）。时间取值顺序：[created::] > 文档 date > 文件创建时间。
- 优先级模式：可选正序（↑，P1 在前）或倒序（↓，P4 在前）。相同优先级下自动按时间倒序排列。
冲突处理：为了让 /todo 路径完全由汇总插件控制，需要确保 quartz/plugins/emitters/contentPage.tsx 中跳过了该路径的处理。

lllllan's blog

探索