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

bin+lib rss_autogen_giscus

Autogenerate GitHub Discussions from RSS feeds for Giscus

2 unstable releases

0.2.0 Aug 16, 2023
0.1.1 Aug 10, 2023

#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 offers a great solution to bring commenting support to your website, but it comes with the caveat that authorizing the app grants permissions to all repos. You can still comment on GitHub itself, but the discussion post itself is only created when an authenticated user leaves one first. This program solves that, running as a container that can check for new blog posts from an RSS feed, and generating a compatible discussion for Giscus.

Usage

Binary

  1. Install the binary with cargo install rss_autogen_giscus.
  2. Get a personal access token with write permissions for GitHub discussions
  3. Set the environment variables as specified in the documentation.
  4. Run the program: rss_autogen_giscus

You can also use the provided container image:

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. Enable Giscus in your repo. When choosing the page to discussions mapping, select "Discussion title contains page pathname".
  2. Copy the workflow job from this repo. Edit the environment variables, and modify the trigger as needed. Take note of LOOKBACK_DAYS, as it may recreate an existing post if the program is unintentionally triggered.

Contributing

Feel free to open an issue or PR in this repo.

License

Both the program and container image are licensed under Apache 2.0.

Dependencies

~23–38MB
~682K SLoC