分类法用于给内容打标签与分层。EmDash 内置分类(可层级)与标签(扁平),也支持自定义分类法。
内置分类法
| 分类法 | 类型 | 说明 |
|---|---|---|
| 分类 | 层级 | 支持父子关系 |
| 标签 | 扁平 | 无层级的标签 |
默认可用于 posts 集合。
管理词条
新建词条
Admin Dashboard
-
打开分类页面(如
/_emdash/admin/taxonomies/category) -
在 Add New 中填写名称
-
可选:Slug、Parent、Description
-
点击 Add
Content Editor
-
在编辑器中打开条目
-
使用侧栏分类面板
-
分类:勾选或 + Add New
-
标签:逗号分隔输入
-
保存
API
与英文文档相同的 POST /_emdash/api/taxonomies/category/terms 示例。
删除词条会移除所有内容上的关联,不会删除内容本身。
查询
使用 getTaxonomyTerms、getTerm、getEntryTerms、getEmDashCollection 的 where 与 getEntriesByTerm,代码示例与英文文档一致。
归档页与组件
分类归档、标签归档、CategoryList、TagCloud、PostTerms 的 Astro 示例结构与英文文档相同;界面文案可使用「篇」「分类」「标签」等。
自定义分类法
通过 POST /_emdash/api/taxonomies 创建;在查询与 where 中的用法与内置分类相同。
REST 端点
与英文文档中的表格一致。