内容与页面插件教程

内容处理流水线

一篇文章通常经过：源文件发现、Front Matter 解析、正文解析、转换器处理、页面生成和资源收集。每一步都可以是插件。

article.md
  ↓ front-matter
Document metadata + body
  ↓ markdown parser
Document AST / HTML
  ↓ transformer
PageModel
  ↓ theme
public/article.html

页面插件

PageProvider 负责生成 about、分类、标签、归档、友链、时间线和自定义页面。一个页面插件应接收 Document 集合和配置，返回路由、标题、布局和正文，不直接调用另一个插件的私有函数。

编写建议

先定义输入输出，再决定语言。Markdown 等成熟库可以用 Rust 或 WASM；复杂业务可以用 Python 或 TypeScript；不要因为 Host 使用 Rust 就强迫插件使用 Rust。