@cogita/plugin-categories 将 frontmatter 中的 categories 转换为分类索引、详情页和层级导航。分类支持父子路径;与合集不同,它不要求顺序,也不限制文章归属模型。
默认使用 / 作为层级分隔符。声明 前端/React 时会自动补齐 前端 节点,父节点聚合子分类文章。
virtual-categories-data 提供 allCategories、categoryMap、按 slug 查询、按分类查询文章、面包屑和统计数据。
| 路由 | 页面 |
|---|---|
/categories |
分类索引 |
/categories/:slug |
分类详情 |
/categories/:parent/:child |
层级分类详情 |
插件负责扫描、分类树、静态路由和虚拟模块;主题负责视觉和文章列表;SEO 负责页面元数据;Sitemap 只在显式启用后收录分类页面。
未配置分类时插件返回 null,不改变已有站点输出。后续应让分类与标签、搜索共享 Core 的 ContentIndex,避免重复扫描。