#rss #blog #blog-post #env-var #giscus #github-discussions

bin+lib rss_autogen_giscus

为 Giscus 自动从 RSS 源生成 GitHub 讨论帖

2 个不稳定版本

0.2.0 2023 年 8 月 16 日
0.1.1 2023 年 8 月 10 日

#14 in #blog-post

Apache-2.0

1MB
50K SLoC

GraphQL 49K SLoC Rust 818 SLoC // 0.0% comments Shell 16 SLoC // 0.1% comments

rss_autogen_giscus

Giscus 提供了一种将评论功能引入您网站的解决方案,但它有一个缺点,那就是授权应用程序会授予所有仓库的权限。您仍然可以在 GitHub 上进行评论,但讨论帖只有在认证用户首次留下评论时才会创建。这个程序解决了这个问题,作为一个容器运行,可以检查 RSS 源中的新博客帖,并为 Giscus 生成兼容的讨论帖。

使用方法

二进制文件

  1. 使用 cargo install rss_autogen_giscus 安装二进制文件。
  2. 获取具有 GitHub 讨论写权限的个人访问令牌
  3. 按照 文档 中指定的设置环境变量。
  4. 运行程序: rss_autogen_giscus

您还可以使用提供的容器镜像

podman pull ghcr.io/cam-rod/rss_autogen_giscus:latest
podman run --rm -it -e DISCUSSION_CATEGORY=Blogs [...] rss_autogen_giscus:latest

GitHub Actions

  1. 在您的仓库中启用 Giscus。在选择页面到讨论的映射时,选择 "讨论标题包含页面路径名"
  2. 从本仓库复制 工作流程作业。编辑环境变量,并根据需要修改触发器。请注意 LOOKBACK_DAYS,因为它可能会在不经意间触发程序时重新创建现有帖子。

贡献

请随意在此仓库中打开问题或 PR。

许可证

程序和容器镜像都采用 Apache 2.0 许可。

依赖项

~23–38MB
~682K SLoC