标签是扁平的:一篇可以打多个,没有层级,没有强制词表。想做目录之前,先用标签把文档分成几堆。
发布时打上
jdu push notes/index.md --tag 架构 --tag 后端
--tag 可重复。更新已有文档时:
- 不传
--tag:标签不动 - 传了
--tag:整组换成这次给出的(不是追加)
只想加一个、保留其余的,用下面的 tag add。
事后改标签
jdu tag add abc123 架构 后端
jdu tag set abc123 架构 发布
jdu tag set abc123 # 清空
jdu tag list
| 命令 | 行为 |
|---|---|
tag add <id> <tags...> | 追加,已有的保留 |
tag set <id> [tags...] | 整组覆盖;不给标签名就是清空 |
tag list | 全部标签,带文档数 |
多个名字可以空格分开,也可以写成逗号:jdu tag add abc123 架构,后端。
站点里从文档阅读页或管理表的标签列打开浮层,效果和这些命令相同:已选的可摘掉,输入即搜,搜不到就新建。
重命名、合并、删除
这三个动作作用在标签本身,会碰到所有用了它的文档。
jdu tag rename 旧名 新名
jdu tag merge 废名 保留名
jdu tag rm 废名
| 动作 | 文档内容 | 标签 |
|---|---|---|
| 重命名 | 不动 | 全站引用改成新名字 |
| 合并 | 不动 | 带「废名」的文档改打「保留名」,废名消失 |
| 删除 | 不动 | 只解绑,文档还在 |
删除标签不会删文档。合并前用 tag list 看两边各有多少篇。
在站点里用标签
侧栏「标签」是一张表:名称、文档数、最近使用。点进某个标签,列出打了它的文档。
「我的文档」页顶上也可以按标签筛。官方知识库里的文档可以带标签(发布时打上),但读者不能给官方文档打自己的标签——标签是文档上的字段,不是每人一份。
搜索框匹配标题和摘要,不匹配标签名。靠标签找文档,走标签页,不要走顶栏搜索。
教程目录:使用简牍 · 下一篇:在文档里用 Widget