Hypothesis 页面记录工具介绍

hellolinux2021

2022 年 4 月 20 日

Hypothesis介绍

介绍

网站：https://hypothes.is/，Chrome 浏览器插件

与 Pocket、Instapaper 等知名服务相比，界面简陋，且上手门槛较高。但在熟悉操作后，是一个能较好兼顾上述三个理想特性的工具。

跨平台： 提供了一个代理入口 https://via.hypothes.is/，通过该入口访问网页后可以直接开始批注。
可溯源：Hypothesis 在批注时不仅会记录批注内容，而且会通过多种方式记录批注在原文中的位置（下文将会详细解释），这使得即便网页内容发生较大变化，它仍然能准确定位。
可迁移：Hypothesis 提供了完善的 API，可以结构化地导出所有批注数据。此外，Hypothesis API 还有一个半官方的网页前端 Facet，可以搜索满足特定条件的批注，并导出为 HTML、CSV 等格式。

获取API token

Hypothesis 官网注册账号，完成注册并登录后，点击页面右上角的齿轮图标，选择「Developer」，生成自己账号对应的 API token，留存备用。

使用细节

选中网页上任意文本，页面就会弹出一个工具列，允许你选择将这段文本高亮（highlight）或添加批注（annotate）；批注功能支持 Markdown 语法、LaTeX 公式和添加标签（tag）。
注意到面板顶部的「Public」字样，这代表批注内容将被存放在一个公开的分组（group）中，其他 Hypothesis 用户在批注相同网页时将可以看到你的用户名和批注。如果对此介意，可以点击并切换到「Private」分组。你也可以根据自己的整理需要，创建任意名称的分组。
Hypothesis 主界面会显示近期批注过的网页；点击标题将其展开，即可看到各条批注，并进行跳转到原文、编辑、链接分享等操作。你也可以通过页面顶部的搜索框根据内容、分组、URL、标签等条件搜索批注。
Hypothesis 官网的检索功能比较简陋，也没有提供批量导出功能。对此，最简单的解决方案是使用前面提到的 Facet 工具。
访问该工具页面后，在左上角的「User」框中填入自己的 Hypothesis 用户名，并在左下角的「Hypothesis API token」框中填入之前生成的 API token，然后根据需要填写其他检索条件（留空则默认显示近期批注页面），就可以在页面右侧看到实时更新的检索结果。如果需要批量导出，可以点击「CSV」或「JSON」按钮获得相应格式的数据，然后用 Excel 等工具进一步处理即可。
对于具有较高保存价值的网页，先用 Wayback Machine 等工具创建快照副本，再用 Hypothesis 对副本做批注，会是更稳妥的做法。

自动化

自动备份标注到 Obsidian 笔记库

每个网页生成一个文件，存在专门的文件夹中
meta 中记录网页标题、链接、创建和更新时间
以列表的方式整理标注，并保持原文中的顺序，其中 Page Note 放最前面
区分原文和我自己写的笔记
Hypothesis 的每个标注可以添加标签，若有标签，以 [[标签名]] 名的方式接在标注文本后面

脚本：hydown.py

自动分享内容到博客

对想分享的内容创建一个 Page Note 并打上 hypothesis 标签
把带有 hypothesis 标签的内容，自动发布到 typecho 博客

脚本：hypublish.py

使用 crontab 本地自动执行上述两个脚本

crontab定时操作

30 10 * * * /usr/local/bin/python3 ~/script/hydown.py
30 7 * * * /usr/local/bin/python3 ~/script/hypublish.py

订阅公开

参考

开源、可定制的网页批注工具——Hypothesis

Hypothesis 教程：一款免费好用的网页标注工具

Atom & RSS Feeds for Annotation

CC BY-NC-ND 2.0 授权