分类法(Taxonomies)

本页内容

分类法用于给内容打标签与分层。EmDash 内置分类(可层级)与标签(扁平),也支持自定义分类法。

内置分类法

分类法类型说明
分类层级支持父子关系
标签扁平无层级的标签

默认可用于 posts 集合。

管理词条

新建词条

Admin Dashboard

  1. 打开分类页面(如 /_emdash/admin/taxonomies/category

  2. Add New 中填写名称

  3. 可选:SlugParentDescription

  4. 点击 Add

Content Editor

  1. 在编辑器中打开条目

  2. 使用侧栏分类面板

  3. 分类:勾选或 + Add New

  4. 标签:逗号分隔输入

  5. 保存

API

与英文文档相同的 POST /_emdash/api/taxonomies/category/terms 示例。

删除词条会移除所有内容上的关联,不会删除内容本身。

查询

使用 getTaxonomyTermsgetTermgetEntryTermsgetEmDashCollectionwheregetEntriesByTerm,代码示例与英文文档一致。

归档页与组件

分类归档、标签归档、CategoryListTagCloudPostTerms 的 Astro 示例结构与英文文档相同;界面文案可使用「篇」「分类」「标签」等。

自定义分类法

通过 POST /_emdash/api/taxonomies 创建;在查询与 where 中的用法与内置分类相同。

REST 端点

与英文文档中的表格一致。

下一步