Feeds to Pocket

Feeds to Pocket 会监视您的 RSS 和 Atom 订阅源，并将新项目推送到您的 Pocket 列表。

许可证

Feeds to Pocket 根据您的选择，受 MIT 许可证或 Apache 许可证（版本 2.0）的约束，并且使用第三方库，其中一些具有不同的许可证。

贡献

除非您明确声明，否则您有意提交的任何贡献，根据 Apache-2.0 许可证定义，应作为上述双重许可发布，不附加任何额外条款或条件。

先决条件

Feeds to Pocket 使用 OpenSSL 进行 HTTPS 请求。如果您没有 OpenSSL，您必须先安装它。

您需要 Cargo，Rust 的包管理器。如果您还没有它，请访问 Rust 网站，然后下载并安装适合您平台的 Rust，这将安装 Rust 编译器和 Cargo。

使用方法

安装

在终端或命令提示符中运行以下命令

$ cargo install feeds-to-pocket

这将安装最后发布到 crates.io 的 Feeds to Pocket 的最新版本。

如果您想安装更新，请运行

$ cargo install --force feeds-to-pocket

配置

Feeds to Pocket 使用一个文件来存储您的配置（要监视的订阅源列表，Pocket 访问凭证）。您必须在调用程序时指定一个文件名作为命令行参数；没有默认文件名。

首先，您必须创建您的配置文件

$ feeds-to-pocket ~/feeds-to-pocket.yaml init

~/feeds-to-pocket.yaml 只是一个示例，您可以使用任何您想要的文件名！

然后，您必须在 Pocket 网站的开发者部分 创建一个应用。请确保您选择了至少 添加 权限。这将为您提供 客户密钥，这是使用 Pocket API 必要的。客户密钥有 速率限制，所以我建议您保密您的客户密钥。

当您获得您的客户密钥时，将其保存在您的配置文件中

$ feeds-to-pocket ~/feeds-to-pocket.yaml set-customer-key 1234-abcd1234abcd1234abcd1234

之后，您需要进行登录。只需运行

$ feeds-to-pocket ~/feeds-to-pocket.yaml login

按照说明操作。这将在您的配置文件中保存一个访问令牌。访问令牌类似于您账户的密码，所以请妥善保管！

恭喜您，Feeds to Pocket 现在可以与 Pocket 通信了！

添加源

完成以上配置步骤后，您就可以添加源了。使用 add 子命令来添加源

$ feeds-to-pocket ~/feeds-to-pocket.yaml add https://xkcd.com/atom.xml

这将下载源并标记所有当前条目为“已处理”，而不会将它们发送到 Pocket。如果您希望所有当前条目都发送到 Pocket，请传递 --unread 标志

$ feeds-to-pocket ~/feeds-to-pocket.yaml add --unread https://xkcd.com/atom.xml

为每个您希望 Feeds to Pocket 监控的源重复此操作。

将新条目发送到 Pocket

调用 feeds-to-pocket 而不带子命令，使其下载您的源并将新条目发送到 Pocket。

$ feeds-to-pocket ~/feeds-to-pocket.yaml

一旦条目已发送到 Pocket，Feeds to Pocket 将将其标记为“已处理”，并将不再发送它。

为源分配标签

您可以为源分配标签。当新的条目被推送到 Pocket 时，它将分配来自条目来源源的标签。

为此，请将 --tags 选项传递给 add 子命令。您可以在添加新源时或为现有源执行此操作（然后它将 替换 该源的标签列表）。--tags 选项后面跟有一个逗号分隔的标签列表。

$ feeds-to-pocket ~/feeds-to-pocket.yaml add --tags comics,xkcd https://xkcd.com/atom.xml

计划任务

Feeds to Pocket 没有内置的计划任务机制。您应该使用现有的任务计划程序定期运行 feeds-to-pocket 程序。

如果您使用 Linux 并使用 systemd，您可以为 systemd 用户实例设置 systemd 定时器。请参阅 systemd-examples 目录中的示例单元文件。

删除源

使用 remove 子命令来删除源

$ feeds-to-pocket ~/feeds-to-pocket.yaml remove https://xkcd.com/atom.xml

从源代码编译

要从项目目录构建项目，只需运行

$ cargo build

这将自动下载和编译项目的所有 Rust 依赖项。

问题

如果您发现了一个错误，首先检查您是否正在使用最新版本，如果不是，请更新。如果错误仍然存在，请检查是否已存在类似的 问题（检查已打开和关闭的问题！）如果不存在，请 提交一个新问题。如果程序输出错误消息，请将其包含在您的问题中。还要说明您正在使用的操作系统及其版本。

贡献

请参阅 CONTRIBUTING。