This project is a GitHub Action-powered blog. It's creating a blog from issues and tags.

It will search all your issues to build a blog. The issue's label will be the category name.

Special Label (ignore case):

• Todo: The TODO category.
• Links: The Links category. If you give a heart reaction ❤️ to the comment, it will be added to the link category, rule see #links
• Top: The Top category.

Inspired by GitBlog and other projects.¹²³⁴⁵

check out the example repository

In the repository where you wish to build a blog, create .github/workflows/issue_blog.yml. The following example shows the issue and issue's comments event trigger fired. It will generate README.md, feed.xml, rss.xls, and backup markdown files.

name: 'Generate Blog'
on:
  workflow_dispatch:
  issues:
    types: [ opened, edited ]
  issue_comment:
    types: [ created, edited ]
concurrency:
  # just run one action at a time
  group: ${{ github.workflow }}
  cancel-in-progress: true
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2 #  Check out the repository, so it can read the files it and do other operations
      - name: Generate README
        uses: bxb100/issueblog@v1 # Prefer to use the latest version
        with:
          # Define the README.md header content
          md_header: "## GitLog\nMy personal blog using issues and GitHub Actions\n[RSS Feed](https://bxb100.github.io/blog/feed.xml)"

If you want to generate podcast RSS, you can create the release, rules see #release.

You can define blog_image_url to customize your RSS image.

You can enable GitHub Page (branch main in /root) to show human-readable RSS.

The GitHub token used to create an authenticated client, the default github.token auth scope is the current repository.⁶

The author name of the blog, the default is ${{ github.repository_owner }}.

The header of README.md, default:

## GitLog

My personal blog using issues and GitHub Actions [RSS Feed](https://raw.githubusercontent.com/${{ github.repository
}}/master/feed.xml)

(YAML multiple lines)

The image url of the blog, default is

https://cdn.jsdelivr.net/gh/${{ github.repository }}/blog.png

that means the image is at the root of the repository.

The event issue number, default is {{ github.event.number }}, that not using currently.

The recent category limit, default is 10.

The number of each category to show, default is 5.

The title of the links, default is Links.

The title of the recent category, default is Recent.

The title of the top category, default is Top.

Group the no labeled issues to the unlabeled category, default ignore.

name:GitBlog
link:https://github.com/yihong0618/gitblog
desc:Example description

• Upload the mp3 file to the release.
• Write content like this:

podcast title
---
![podcast image](https://example.com/img.png)
---
description