发布之后的阅读、查找、主题、原文都在浏览器里完成。发布本身仍然只有 CLI 这一条路,站点上没有「新建文档」按钮。
侧栏
登录后左侧从上到下:
| 入口 | 里面是什么 |
|---|---|
| 我的文档 | 你自己发布的,不含已上架到官方库的 |
| 标签 | 扁平标签表,点进去是打了该标签的文档 |
| CLI token | 这台机器发出去的 token,可以吊销 |
| 官方知识库 | 管理员上架的 official 档文档,公开可读、只进这里,只读 |
官方知识库放在分隔线下面,灰色,不进「我的」默认视野;官方库是空的(实例默认如此)时整项不出现。
没有「公开文档」这个列表:公开是文档自己的属性,知道链接的人就能读,站点上不提供一份对外的文件清单。想知道自己发过哪些公开文档,在「我的文档」里按「公开」筛。
未登录时能打开别人给你链接的公开文档和官方库;私有文档会把你带到登录。
列表怎么读
每行三行信息:标题、摘要、标签;右侧是可见性和时间、版本。标题和摘要超出就省略。空列表会给你一条 jdu push 命令,而不是「新建」按钮。
顶栏搜索匹配标题和摘要,不是全文。没登录时只搜得到官方库——公开文档有 URL 就能打开,但不会被匿名搜索列出来。
阅读页
面包屑第二段按文档档位走:official 是「官方知识库」,其余(公开、私有、含池内定向分享)都是「我的文档」。这条路径跟「谁在看」无关。
元信息行左侧是可见性、标签、作者、版本、时间;右侧常见动作:
- 复制 md 原文(或把 URL 改成
/d/<id>.md) - 历史版本
- 分享(改可见性、按人授权)
原文里的本地引用已经改写成 /blob/<hash>,下载下来的 md 在浏览器里图片也能开。
主题
右上角按钮在三种偏好里循环:跟随系统 → 亮色 → 暗色。选亮或暗之后不再听操作系统。多标签页通过 localStorage 同步。
Widget 跟这一套走。自己写组件时不要再单独 matchMedia('prefers-color-scheme'),否则会和用户点过的偏好打架。
语法与组件
语法对照表是官方库里的一篇:Markdown 语法速查。组件用法见 在文档里用 Widget;这台实例现有哪些组件看 /api/syntax,完整字段 schema 看 /api/widgets。
文档管理
「我的文档」切到管理视图后,可以按可见性筛、改标签、分享、归档、删除。和 CLI 的 share / tag / archive / delete 写同一份数据,两边改都行。
硬删除没有后悔药,和 jdu delete --hard 一样。