发布快照
快照是一个由静态网页组成的文件夹,按照你的笔记在那一刻的样子写出。打开它的人只能读到这些笔记,别的什么都读不到。 要把一组笔记交给没有 Varlig 的人,或者自己在 PC 或手机浏览器上阅读,靠的就是它。
发布之前,面板会把话说在前头:“快照是一个由静态页面组成的文件夹。打开它的人只能阅读这些笔记:页面无法编辑,无需联网,而且在你修改原笔记后,仍会显示今天的文本。”
快照是什么,不是什么
快照就是一组文件。它固定在你写出它的那一刻:此后再编辑原来的笔记,已经写好的文件夹连一个字节都不会变,Varlig 也不会在后台重写它。
它不是网站、账户或同步服务:
- 没有账户,也没有邀请。 能打开这个文件夹的人就能读。没有登录,没有按人区分的权限,也不会记录谁读过。
- 无法撤回。 移除文件夹只能让别人无法再从那个位置打开它,却够不着别人已经下载、转发或放进备份里的副本。
- 不能编辑,也不能评论。 这些网页就是文稿。读它们不会改变 Varlig 里的任何东西,Varlig 里的任何东西也不会改变它们。
- 不提供托管,也不负责传输安全。 Varlig 只负责写出这个文件夹;之后由什么来承载它 —— 共享的驱动器、网页服务器、邮件附件 —— 才决定谁能拿到它。
发布一个快照
有三个命令会打开同一个面板:
| 命令 | 发布的内容 |
|---|---|
| 文件 › 发布快照… | 你选中的笔记 |
| 笔记列表快捷菜单中的 发布快照… | 你右键点按的那些笔记 |
| 标签边栏快捷菜单中的 发布标签快照… | 带有该标签的每一篇笔记 |
它们都没有键盘快捷键。
面板的标题是 发布快照。在 快照名称 栏中输入一个名称,看一遍预览,然后选取 选取文件夹… 并指定写到哪里。取消 会让一切保持原样。
完成之后,结果会显示 已发布 12 篇笔记,给出路径,并补充说明:“在任意浏览器中打开 index.html,无论是在这里还是在手机上。这些页面是快照:编辑笔记时它们不会改变,阅读的人也无法编辑。之后移除文件夹可以阻止新的下载,但无法收回别人已经拥有的副本。”在访达中显示 会打开这个文件夹,完成 会关闭面板。
先看一遍预览
在你选定文件夹之前,什么都不会被写出,而预览会原原本本地显示这个文件夹将包含什么:
- 将要发布的每一篇笔记,以及它有多少个附件、附件总共多大。
- 未发布 —— 被排除在外的笔记,每一篇都附上原因:已锁定的笔记、加密笔记 或 加密标签——必须保留在 Varlig 中。
- 缺失的附件(未发布) —— 资料库找不到的文件。之后的结果会说明有多少个被排除在外,细到“有 1 个附件缺失,未发布”。
- 每一条指向外部的笔记链接,以及发布后的网页会怎样处理它。
下方有一个实时总计,统计笔记数、附件数和字节数,并说明有多少条笔记链接会作为链接发布、有多少条会作为纯文本发布。如果所选内容中没有任何东西可以发布,面板会如实说明,按钮保持停用。
每条链接都会落入以下三种归类之一:
| 归类 | 网页的处理方式 |
|---|---|
included |
被链接的笔记就在这个快照里,所以网页会链接到它的文件 |
kept as plain text (not published) |
被链接的笔记不在这个快照里,所以只保留你输入的文字 |
blocked (protected, protected tag or locked) |
被链接的笔记不得离开 Varlig,所以只保留你输入的文字 |
面板打开期间,预览会重新读取这些笔记,所以你在另一个窗口中编辑过的笔记,预览出来的 —— 以及发布出去的 —— 就是它此刻的样子。
哪些内容永远不会被发布
受保护的笔记、带有受保护标签的笔记和已锁定的笔记,永远不会被读取,也永远不会被发布。与普通的导出不同,这里没有 包括已解锁的加密笔记 这个选项:发布根本没有办法把它们包含进来。
如果一条链接无法在快照内部重写,它会连同链接样式一起失去自己的地址,所以发布出去的网页绝不可能指出、也绝不可能指向一篇没有被发布的笔记。这包括 [[Title|alias]] 链接、varlig:// 和 Bear 的笔记地址(它们的地址本会带上未发布笔记的标题),以及标签链接。普通的网址不受影响。
文件夹里有什么
旅行笔记/
index.html 每位读者的起点,也就是那份目录
旅行-<UUID>.html 每篇笔记一个网页
行李-<UUID>.html
assets/ 图片和文件,所有网页共用
publication.json
这些网页与 HTML 导出的呈现方式相同 —— 计算答案如同富文本导出中那样显示,图片来自 assets/,代码和图表以图片形式呈现 —— 另外还加上了适配手机宽度的视口、一条回到 index.html 的链接,以及一个标注快照日期的页脚:“发布于 2026年9月16日。这是一个快照:它显示的是笔记在该日期的状态,不会随笔记的更改而变化。无法在此编辑。”
其中没有任何脚本、任何网络请求,也没有任何形式的编辑控件,所以这个文件夹离线可读,被移动或拷贝之后可读,在手机屏幕上也可读。
publication.json 记录了发布了什么:varligPublication 格式版本、这次发布的 id、它的 name、created 和 updated 日期、每篇笔记的 id、title、file 和 contentHash,以及一份已发布文件的清单。更新的格式版本会被拒绝,而不会被误读。
更新或移除快照
设置 › 导入与导出 › 已发布的快照 会列出这个资料库写出过的每一个快照。在你写出第一个之前,它写着“还没有快照. 选择笔记,然后使用“文件”▸“发布快照…”写入一个只读页面文件夹。”
每一行都会说明其中的笔记此后是否有变动 —— 3 篇笔记已更改,以及单独的 1 篇笔记已不在资料库中 —— 并提供三个按钮:
| 按钮 | 作用 |
|---|---|
| 在访达中显示 | 打开写出时的那个文件夹。 |
| 更新快照… | 重新打开面板,标题为 更新快照,显示哪些笔记有变动。更新快照 会把同一个文件夹重写为同一次发布的新一版。 |
| 移除… | 在确认之后,从这台 Mac 上删除该文件夹。 |
更新会先在目标位置旁边构建好,再移动到位,所以即使失败,之前的快照也完好无损。只有当文件夹里仍然带着这次发布自己的
publication.json 时,Varlig 才会移除它,所以你自己移动过或替换过的文件夹会被原样留下。
要移除“旅行笔记”吗? 提醒框把“移除”的界限说得很清楚:“这会删除这台 Mac 上已发布的文件夹,其他人将无法再从这里打开它。其他人已经下载的副本仍归他们所有:已发布的快照无法收回。”按钮是 取消 和 删除文件夹。
这个面板自己的脚注说的是同一件事:“快照是一个只读页面文件夹,你可以拷贝、邮寄或放在共享文件夹中;在手机浏览器中也能阅读。它不是账户:任何拿到文件夹的人都能阅读,而别人已下载的副本无法收回。”
关于把笔记带出 Varlig 的其他方式,请参阅导入、导出与备份。