跳到主要内容
Varlig 指南
Varlig 首页

发布快照

快照是一个由静态网页组成的文件夹,按照你的笔记在那一刻的样子写出。打开它的人只能读到这些笔记,别的什么都读不到。 要把一组笔记交给没有 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 的其他方式,请参阅导入、导出与备份。