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

怎么读简牍站点

官方教程阅读masonv1
查看历史版本
目录

发布之后的阅读、查找、主题、原文都在浏览器里完成。发布本身仍然只有 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 一样。


教程目录:使用简牍 · 下一篇:jdu 命令速查