跳到主内容
简牍jiandu
阅读模式

用标签整理文档

官方教程整理masonv1
查看历史版本
目录

标签是扁平的:一篇可以打多个,没有层级,没有强制词表。想做目录之前,先用标签把文档分成几堆。

发布时打上

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