# Hypothesis 页面记录工具介绍 By [github](https://paragraph.com/@github) · 2022-04-20 --- 介绍 == 网站：[https://hypothes.is/，](https://hypothes.is/%EF%BC%8C)[Chrome 浏览器插件](https://chrome.google.com/webstore/detail/hypothesis-web-pdf-annota/bjfhmglciegochdpefhhlphglcehbmek) 与 Pocket、Instapaper 等知名服务相比，界面简陋，且上手门槛较高。但在熟悉操作后，是一个能较好兼顾上述三个理想特性的工具。 * **跨平台：** 提供了一个代理入口 `https://via.hypothes.is/`，通过该入口访问网页后可以直接开始批注。 * \*\*可溯源：\*\*Hypothesis 在批注时不仅会记录批注内容，而且会通过多种方式记录批注在原文中的位置（下文将会详细解释），这使得即便网页内容发生较大变化，它仍然能准确定位。 * \*\*可迁移：\*\*Hypothesis 提供了完善的 API，可以结构化地导出所有批注数据。此外，Hypothesis API 还有一个半官方的网页前端 [Facet](https://jonudell.info/h/facet/)，可以搜索满足特定条件的批注，并导出为 HTML、CSV 等格式。 获取API token > Hypothesis 官网注册账号，完成注册并登录后，点击页面右上角的齿轮图标，选择「[Developer](https://hypothes.is/account/developer)」，生成自己账号对应的 **API token**，留存备用。 使用细节 ==== * 选中网页上任意文本，页面就会弹出一个工具列，允许你选择将这段文本高亮（highlight）或添加批注（annotate）；**批注功能支持 Markdown 语法、LaTeX 公式和添加标签（tag）**。 注意到面板顶部的「Public」字样，这代表批注内容将被存放在一个公开的分组（group）中，其他 Hypothesis 用户在批注相同网页时将可以看到你的用户名和批注。如果对此介意，可以点击并切换到「Private」分组。你也可以根据自己的整理需要，创建任意名称的分组。 * Hypothesis 主界面会显示近期批注过的网页；点击标题将其展开，即可看到各条批注，并进行跳转到原文、编辑、链接分享等操作。你也可以通过页面顶部的搜索框根据内容、分组、URL、标签等条件搜索批注。 * Hypothesis 官网的检索功能比较简陋，也没有提供批量导出功能。对此，最简单的解决方案是使用前面提到的 [Facet](https://jonudell.info/h/facet/) 工具。 访问该工具页面后，在左上角的「User」框中填入自己的 Hypothesis 用户名，并在左下角的「Hypothesis API token」框中填入之前生成的 API token，然后根据需要填写其他检索条件（留空则默认显示近期批注页面），就可以在页面右侧看到实时更新的检索结果。如果需要批量导出，可以点击「CSV」或「JSON」按钮获得相应格式的数据，然后用 Excel 等工具进一步处理即可。 * 对于具有较高保存价值的网页，先用 [Wayback Machine](https://archive.org/web/) 等工具创建快照副本，再用 Hypothesis 对副本做批注，会是更稳妥的做法。 自动化 === 自动备份标注到 Obsidian 笔记库 -------------------- * 每个网页生成一个文件，存在专门的文件夹中 * meta 中记录网页标题、链接、创建和更新时间 * 以列表的方式整理标注，并保持原文中的顺序，其中 Page Note 放最前面 * 区分原文和我自己写的笔记 * Hypothesis 的每个标注可以添加标签，若有标签，以 `[[标签名]]` 名的方式接在标注文本后面 脚本：[hydown.py](https://github.com/skyue/script/blob/main/hydown.py) 自动分享内容到博客 --------- * 对想分享的内容创建一个 Page Note 并打上 `hypothesis` 标签 * 把带有 `hypothesis` 标签的内容，自动发布到 typecho 博客 脚本：[hypublish.py](https://github.com/skyue/script/blob/main/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](https://sspai.com/post/63033) [Hypothesis 教程：一款免费好用的网页标注工具](https://www.skyue.com/22012820.html) [Atom & RSS Feeds for Annotation](https://web.hypothes.is/help/atom-rss-feeds-for-annotations/) --- *Originally published on [github](https://paragraph.com/@github/hypothesis)*