github-action-contributors

Github action generates dynamic image URL for contributor list to display it!

The contributors list is fetched fromGitHub API.

Contributors

As always, thanks to our amazing contributors!

Write contributors(htmlTable) to markdown Example:

小弟调调

Bot Users:

github-actions[bot]

renovate[bot]

Collaborators Users:

小弟调调

Write contributors(htmlList) to markdown Example:

Usage

-run: mkdir-p build-name: Generate Contributors Imagesuses: jaywcjlove/github-action-contributors@mainwith:filter-author: (renovate\[bot\]|renovate-bot|dependabot\[bot\])output: build/CONTRIBUTORS.svgavatarSize:42-name: Deployuses: peaceiris/actions-gh-pages@v3with:github_token: ${{ secrets.GITHUB_TOKEN}}publish_dir: ./build

https://jaywcjlove.github.io/github-action-contributors/CONTRIBUTORS.svg

Use in markdown

## ContributorsAs always, thanks to our amazing contributors!<ahref="https://github.com/jaywcjlove/github-action-contributors/graphs/contributors"><imgsrc="https://jaywcjlove.github.io/github-action-contributors/CONTRIBUTORS.svg"/></a>Made with[contributors](https://github.com/jaywcjlove/github-action-contributors).

Write contributors(htmlList) to markdown

-name: Generate Contributors Imagesuses: jaywcjlove/github-action-contributors@mainid: contributorswith:filter-author: (renovate\[bot\]|renovate-bot|dependabot\[bot\])avatarSize:42-name: Modify README.mduses: jaywcjlove/github-action-modify-file-content@mainwith:path: README.mdbody:'${{steps.contributors.outputs.htmlList}}'

Use inREADME.md markdown

## ContributorsAs always, thanks to our amazing contributors!<!--GAMFC--><ahref="https://github.com/jaywcjlove"title="小弟调调"><imgsrc="https://avatars.githubusercontent.com/u/1680273?v=4"width="36;"alt="小弟调调"/></a><!--GAMFC-END-->Made with[contributors](https://github.com/jaywcjlove/github-action-contributors).

Write contributors(htmlList) to markdown Example:

Write contributors(htmlTable) to markdown

-name: Generate Contributors Imagesuses: jaywcjlove/github-action-contributors@mainid: contributorswith:filter-author: (renovate\[bot\]|renovate-bot|dependabot\[bot\])openDelimiter:'<!--GAMFC_DELIMITER-->'closeDelimiter:'<!--GAMFC_DELIMITER-END-->'hideName:'true'# Hide names in htmlTableavatarSize:100# Set the avatar size.-name: Modify htmlTable README.mduses: jaywcjlove/github-action-modify-file-content@mainwith:path: README.mdbody:'${{steps.contributors.outputs.htmlTable}}'

Use inREADME.md markdown

## ContributorsAs always, thanks to our amazing contributors!<!--GAMFC_DELIMITER-->will be replaced here<!--GAMFC_DELIMITER-END-->Made with[contributors](https://github.com/jaywcjlove/github-action-contributors).

Write contributors(htmlTable) to markdown Example:

Bot Users:

Inputs

• token - YourGITHUB_TOKEN. This is required. Why do we needtoken? Read more here:About the GITHUB_TOKEN secret. Default:${{ github.token }}
• filter-author - Regular expression filtering'.
• count - Specify the max count of contributors listed. Default list all contributors(max 100).
• output - output image path. default:CONTRIBUTORS.svg
• truncate - Truncate username by specified length,0 for no truncate. default:12
• svgWidth - Width of the generated SVG. default:740
• avatarSize - Size of user avatar. default:24
• avatarMargin - Margin of user avatar. default:5
• hideName - Hide names inhtmlTable
• userNameHeight - Height of user name. default:0
• svgTemplate - Template to render SVG.

<svgxmlns="http://www.w3.org/2000/svg"xmlns:xlink="http://www.w3.org/1999/xlink"version="1.1"width="{{ width }}"height="{{ contributorsHeight }}"><style>.contributor-link { cursor: pointer; }</style>  {{{ contributors }}}</svg>

Outputs

• svg svg image string:<svg xmlns.....
• htmlTable Contributor HTML <Table> form string
• htmlTableBots Contributor(Bot Users) HTML <Table> form string
• htmlList Contributor HTML <a> list form string
• htmlListBots Contributor(Bot Users) HTML <a> list form string
• htmlCollaboratorsTable Collaborators user HTML form string
• htmlCollaboratorsTableBots Collaborators user(Bot Users) HTML
form string
• htmlCollaboratorsList Collaborators user HTMLlist form string
• htmlCollaboratorsListBots Collaborators user(Bot Users) HTMLform string

htmlTable

<table><tr><tdalign="center"><ahref="https://github.com/jaywcjlove"><imgsrc="https://avatars.githubusercontent.com/u/1680273?v=4"width="36;"alt="jaywcjlove"/><br/><sub><b>jaywcjlove</b></sub></a></td></tr></table>

htmlList

<ahref="https://github.com/jaywcjlove"><imgsrc="https://avatars.githubusercontent.com/u/1680273?v=4"width="36;"alt="jaywcjlove"/></a><ahref="https://github.com/github-actions[bot]"><imgsrc="https://avatars.githubusercontent.com/in/15368?v=4"width="36;"alt="github-actions[bot]"/></a

Quick Start

$npminstall$npm runwatch# Listen compile .ts files.$npm run build# compile .ts files.

Related

• Github Release Changelog Generator A GitHub Action that compares the commit differences between two branches
• Create Tags From Auto create tags from commit or package.json.
• Create Coverage Badges Create coverage badges from coverage reports. (no 3rd parties servers)
• Create Coverage Package Read and modify the contents ofpackage.json.
• Generated Badges Create a badge using GitHub Actions and GitHub Workflow CPU time (no 3rd parties servers)

Contributors

As always, thanks to our amazing contributors!



Made withcontributors.

License

Licensed under the MIT License.