Intro

Export Discussions in a repo as .md files. Also generate an index of posts as well as feed (rss or json).

Usage (Workflow)

1. "Use this template" to create a repo for discussions Or create a workflow like this in an existing repo
2. Edit or overwrite script/config.js as needed
3. The workflow will run automatically when a discussion is created or edited

Usage (Local)

1. Install deno (developed on 1.25)
2. Set environment variable GITHUB_TOKEN in command line or in .env file in project directory
3. Edit script/config.js as needed
4. deno run --allow-net --allow-env --allow-read --allow-write scripts/fetchPosts.js

Background

Some projects (e.g. YeungKC/Hakuba) use Github Discussions as a Content Management System for blogs. (In fact, Github Discussions works very well as a blog by itself.) Basically, the workflows of those projects are

1. Export discussions to .md files
2. Use static site generator to build .html pages

This project only does 1. Then the files can be used for any SSG or just as backup. The generated feed can be used by a feed reader (demo link).