GitHub Action
Auto Issue List in README
v1.1.0
Latest version
Display issues on the landing page 👀
The issue list below...
Title | Status | Assignee | Body |
---|---|---|---|
more test | ✳️ | yay! | |
test | ✳️ | test hoge testtest ... |
is compiled through this action.
# setup
steps:
- name: checkout
uses: actions/checkout@v2
- name: rewriteReadme
uses: seed-of-apricot/issue-list-readme@v1.1.0
with:
GITHUB_TOKEN: '${{ secrets.GITHUB_TOKEN }}'
pattern: '<!-- issueTable -->' # suffixing "Demo" for this readme
labels: 'good first issue'
state: 'open'
# you need to add, commit and push here
# otherwise the changes will not be pushed back into master
- Place two identifiers in your README.md, which the action detects as the location to inject the issue list to.
README.md
//
// your contents
//
// place two identifiers
<!-- issueTable -->
<!-- issueTable -->
//
// your another contents
//
- Add some issues. You can optionally use the same identifier to extract a part the body to display in the list.
Some issue
// place two identifiers (optional)
<!-- issueTable -->
<!-- issueTable -->
//
// your comment
//
- Then, write the following section into your action.
uses: seed-of-apricot/issue-list-readme@v1.1.0
with:
GITHUB_TOKEN: '${{ secrets.GITHUB_TOKEN }}'
The action will fetch the issues in the repository and re-write the README.md 👍
The body will show up to three first lines of the body (or the extracted part of it).
It is recommended to run this action on issue open/close or by a cron job (e.g., cron: "0 0 * * *"
).
Available variables are:
variable | required | default | note |
---|---|---|---|
GITHUB_TOKEN | true | - | you can use ${{ secrets.GITHUB_TOKEN }} |
pattern | false | "<!-- issueTable -->" | the identifier to inject the issue table and extract the body of each issue |
labels | false | - | comma-separated labels to filter issues |
state | false | "all" | state of the issues to filter them ("all" | "open" | "closed" ) |
You must have README.md (not README) to make this work. (todo)
MIT License. This repository uses the typescript-action template so the original MIT license also applies.