wiki 的目录与命名:三层以内,路径就是导航

时间:2026-11-22 19:11:09   阅读:9
结论:目录不要超过三层,路径用英文小写短横线,标题写结果不写过程;把「导航」交给路径,把「找内容」交给搜索和标签。

一、四家产品的目录模型

产品层级说明
Wiki.js路径即目录页面路径 /universe/planets/earth 自动推断层级,面包屑自动生成
BookStack固定三层Book → Chapter → Page,不能再深
Docmost三级Workspace → Space → Page,Page 之间还能嵌套
Outline集合 + 嵌套文档Collection 下挂文档,文档内可再嵌套子文档

这四个模型里,我最喜欢 Wiki.js 的「路径就是目录」:不用手工建文件夹,页面放在哪个路径就属于哪一级,改路径等于改结构。代价是改名会让旧链接 404,需要重定向或保留别名。

wiki 的目录与命名:三层以内,路径就是导航

图:Wiki.js 文档的 Folder Structure & Tags 页:路径 /universe/planets/earth 会自动推断层级,面包屑自动生成

二、我用的命名规则

  • 路径:全小写英文,单词之间用短横线,不用下划线、不用中文;
  • 标题:写用户会搜的结果句,比如「MySQL 8 升级前检查清单」,不写「关于升级的说明」;
  • 日期:只进正文,不进路径,避免每年重建一次目录;
  • 标签:同义词放标签,比如 nginx 和 反向代理,别在路径里堆同义词;
  • 一页只讲一件事,超过三屏就拆页。

三、三种我拆过的坏目录

第一种按人名建目录:人一离职,目录就成了遗迹,内容也没人维护。第二种按年份建目录:2024、2025、2026 越堆越多,同一主题被切碎。第三种把首页当导航:所有链接堆在首页,改一次结构要动几十个页面。

替代做法是:按稳定的领域建一级目录,比如 ops、product、support;年份和负责人写进页面属性或正文;首页只放搜索框和三个最常用入口。

四、一套可以直接抄的目录样例

技术团队我一般开三个一级目录:ops 放服务器、发布、备份;product 放需求、设计、验收;support 放客服话术和排障。二级按子系统或阶段分,比如 ops/mysql、ops/nginx、product/pay。三级就是具体页面,超过三级的内容用标签和站内链接串起来,不再往下建。

标签我控制在 30 个以内,每个页面最多 3 个;标签只放「找内容」的维度,比如 mysql、备份、故障,不放「谁写的」「哪一年」这类会过期的信息。目录负责稳定,标签负责灵活,两者不要互相替代。

五、改名怎么不坏链接

Wiki.js 改路径后旧地址会 404,要么在反向代理加 301,要么保留旧页面做跳转;BookStack 的页面 slug 可改,旧链接同样要重定向;Docmost 和 Outline 以页面 ID 为主,改标题一般不影响链接。改名前先导出站内链接清单,改完跑一遍死链检查。

五、我的判断

50 页以内别做目录,搜索加标签就够;200 页以上必须有稳定路径规则,并且写进新人手册。目录是给未来的自己看的,不是给文件夹审美看的。

上一篇:自建 Outline 清单:Postgres、Redis、S3 与 OIDC

下一篇:知识库权限设计:三个角色够用,离职当天要能断

网友评论