github

Posted on Apr 20, 2022Read on Mirror.xyz

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

订阅公开

  • Atom: https://hypothes.is/stream.atom?user=paulallison
  • RSS: https://hypothes.is/stream.rss?user=paulallison
  • Atom: https://hypothes.is/stream.atom?tags=edu305
  • RSS: https://hypothes.is/stream.rss?tags=edu305
  • Atom: https://hypothes.is/stream.atom?uri=http://www.theatlantic.com/politics/archive/2015/07/tanehisi-coates-between-the-world-and-me/397619/
  • RSS: https://hypothes.is/stream.rss?uri=http://www.theatlantic.com/politics/archive/2015/07/tanehisi-coates-between-the-world-and-me/397619/

参考

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

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

Atom & RSS Feeds for Annotation