Obsidian 插件：Pocket integration

概述

轻松访问你的 Pocket 阅读列表条目并为它们创建笔记。

Readme(翻译）

下面是 obsidian-pocket 插件的自述翻译

obsidian-pocket

这是一个用于 Obsidian 的插件，允许你将 Pocket 阅读列表同步到 Obsidian 中，这样你就可以直接从 Pocket 阅读列表中轻松创建 Obsidian 笔记。

初始设置

启用插件后，您将能够在设置面板的“插件选项”部分下看到一个“Pocket”选项。点击它进入 obsidian-pocket 设置选项卡，您可以在那里连接您的 Pocket 账户并设置 obsidian-pocket 插件。

连接您的 Pocket 账户

点击“连接您的 Pocket 账户”以开始 Pocket 授权流程，通过在默认浏览器中打开一个网页。您将被询问是否允许此插件访问您的 Pocket 数据。然后您将被重定向回 Obsidian。您的 Pocket 账户现在应该已连接。

“断开您的 Pocket 账户”按钮可用于移除刚刚提供的 Pocket 授权。

指定设置

obsidian-pocket 设置选项卡将包含一些影响 obsidian-pocket 同步 Pocket 项目和创建 Pocket 项目笔记的设置，如下所述：

强烈建议您使用默认的 Pocket 项目笔记模板和前置 URL 关键字。如果您决定自定义这些选项，请确保您的 Pocket 项目笔记最终具有有效的 Pocket 项目 URL 的前置元数据关键字。

用法

可用命令

同步 Pocket 项目

您可以使用 Obsidian 命令“同步 Pocket 列表”或在 obsidian-pocket 设置选项卡中的按钮来同步您的 Pocket 项目。

您可以选择同步所有 Pocket 项目，或者只同步您指定的特定标签的 Pocket 项目，使用“Pocket 同步标签”设置。将其留空以同步所有 Pocket 项目，或者指定一个 Pocket 标签以仅限制同步到具有该标签的 Pocket 项目。

打开并使用 Pocket 列表

一旦 Pocket 列表被下载并存储，打开命令面板并搜索“Pocket”以查看可用命令列表。打开 Pocket 列表的命令是“打开 Pocket 列表”。Pocket 列表显示在上方的屏幕截图中。

可以使用 Pocket 列表浏览您保存到 Pocket 的项目，并通过点击项目标题为任何 Pocket 项目创建笔记。您还可以直接访问 Pocket 项目的 URL。

Obsidian 中的 Pocket 标签

Pocket 标签在 Pocket 列表中进行同步和展示。Pocket 支持带有空格的标签，而 Obsidian 不支持。obsidian-pocket 处理带有空格的 Pocket 标签的方式可以在上面的截图中的“多词 Pocket 标签转换器选项”设置中进行配置。

可用的选项有：

• （默认启用）蛇形命名（‘#tag with spaces’ 变为#tag_with_spaces）
• 驼峰命名（‘#tag with spaces’ 变为#TagWithSpaces）
• 什么都不做（‘#tag with spaces’ 保持不变）

这些设置仅影响在 Pocket 列表中显示的 Pocket 标签，以及如果您的 Pocket 项目笔记模板中有 {{tags}}，则插入到 Pocket 项目笔记中的标签（有关使用 Pocket 项目笔记模板的详细信息，请参见下文）。它们不会影响已存在的 Obsidian 标签或 Pocket 标签。

Pocket 项目的笔记

单击任何 Pocket 项目的标题以创建一个笔记（或导航到现有的笔记）。Pocket 项目的笔记将被创建在 Pocket 项目笔记文件夹中，该文件夹可以在设置中配置。如果没有设置 Pocket 项目笔记文件夹，则 Pocket 项目的笔记将被创建在根文件夹中。

可以在设置中指定新的 Pocket 项目笔记的模板。

使用 Meta+ 点击（Linux 和 Mac OS）或 Alt+ 点击（Windows）在浏览器中打开 Pocket 项目的 URL。

在 Obsidian 中，根据其 frontmatter 中的特定标签，将笔记与 Pocket 项目匹配。默认使用的标签是“URL”，但可以在设置中更改。

这意味着，虽然 Pocket 项目的笔记默认创建在 Pocket 项目笔记文件夹中，但可以将它们移动到其他位置和/或重命名，而不会断开与具有匹配 URL 的 Pocket 项目的连接。这也意味着您可以创建带有 URL frontmatter 的笔记，并且它们将自动连接到具有匹配 URL 的相关 Pocket 项目笔记，尽管在这种情况下不会使用 Pocket 项目模板。

使用“Index all files by URL”命令，确保 obsidian-pocket 知道所有包含 URL 前置标签的文件，从而使其能够将这些笔记与 Pocket 项目匹配。这个索引由 obsidian-pocket 自动维护，所以您不需要运行它。

使用自定义模板来处理 Pocket 笔记

Pocket 笔记的模板与 Obsidian 中的任何其他模板类似，可以参考 这里，只是仅支持以下变量：

这是 obsidian-pocket 的默认模板。它将使用所有可用的元数据填充 Pocket 项目笔记的 YAML 前置元数据，以便 YAML 前置元数据有效，标签正常工作，并显示 Pocket 项目的主要图片（如果有）：

---
Title: "{{title}}"
URL: {{url}}
Pocket URL: {{pocket-url}}
Tags: [pocket, {{tags-no-hash}}]
Excerpt: >
    {{excerpt}}
---
{{tags}}
{{image}}

如果您将 此 URL 保存到 Pocket，并使用此插件将其同步到 Obsidian，然后使用上述模板为相应的 Pocket 项目创建一个笔记，您的笔记将以以下内容开始：

---
Title: "Carbon removal hype is becoming a dangerous distraction"
URL: https://www.technologyreview.com/2021/07/08/1027908/carbon-removal-hype-is-a-dangerous-distraction-climate-change/
Pocket URL: https://getpocket.com/read/1337
Tags: [pocket, carbon_removal]
Excerpt: >
    In February, oil giant Shell trumpeted a scenario in which the world pulls
    global warming back to 1.5 ˚C by 2100, even as natural gas, oil, and coal
    continue to generate huge shares of the world’s energy.
---
#carbon_removal
![image](http://via.placeholder.com/640x360)

请注意，在示例模板中，标题被引用，以确保 YAML 前置元数据有效，即使 Pocket 项目的标题中包含冒号。

功能请求、错误报告和 PR 都欢迎！请使用https://github.com/nybbles/obsidian-pocket/issues 进行反馈。请将功能请求提交到https://github.com/nybbles/obsidian-pocket/labels/enhancement，或在现有的功能请求中发表评论以表示您的兴趣。

如果您要提交错误报告，请提供控制台日志，以便可以重现和修复问题。您可以从 Obsidian 开发者控制台中复制/粘贴控制台日志，方法是在 Obsidian 中转到 View > Toggle Developer Tools。

设计概述和安全考虑

该插件完全在本地运行。它仅与 Pocket 进行通信，通过 Pocket API。您的 Pocket 数据和 Pocket 访问令牌都存储在本地。

该插件将您的 Pocket 数据本地存储在 Obsidian 的 IndexedDB 中。

支持

如果您觉得这个插件有价值，请让我知道！听到使用我构建的东西的人的反馈是很棒的。如果您真的喜欢这个插件，并想通过给我买杯咖啡来表达这一点，请随意 🙏🏾。

请不要感到有义务捐赠！