Skip to content

actions-js/profile-readme

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

30 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

GitHub Action for Profile Readme

The GitHub Actions for adding simple widgets to your profile readme.

Usage

Example Workflow file

An example workflow to authenticate with GitHub Platform:

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@master
        with:
          persist-credentials: false
          fetch-depth: 0
      - name: Create README.md
        uses: actions-js/profile-readme@master
        with:
          username: <your username>
          github_token: ${{ secrets.GITHUB_TOKEN }}
      - name: Commit & Push changes
        uses: actions-js/push@master
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}

Example TEMPLATE.md file

## my cool name

### πŸ—£ My activity:

<!--GITHUB_ACTIVITY:{"rows": 5}-->

---

<p align="center">
  Last refresh: 
  <b><!--TIMESTAMP--></b>
</p>

Widgets

All widgets are identified by and HTML commend containing only a name and optionally a JSON configuration, appended after the name, separated by a :. JSON configuration are always optional.

GitHub Activity

Display your most recent GitHub activity

<!--GITHUB_ACTIVITY:{"rows": 5, "raw": true}-->

displays as:

πŸ’ͺ Opened PR #43 in webview/webview_deno
❗️ Closed issue #32 in denosaurs/denon
πŸ—£ Commented on #6 in nestdotland/hatcher
❗️ Closed issue #22 in nestdotland/eggs
πŸ—£ Commented on #15 in nestdotland/eggs
Configuration
option value default description
rows string 10 Maximum number of rows to generate.
raw boolean false Strip markdown formatting.
include string[] all Select which of the supported events you want to include in the showcase.
exclude string[] [] Select which of the supported events you want to exclude in the showcase.
Supported events
"IssueCommentEvent",
  "IssuesEvent",
  "PullRequestEvent",
  "ForkEvent",
  "ReleaseEvent",
  "PushEvent";

GitHub Repos

Display your most recent GitHub activity

<!--GITHUB_REPOS:{"rows": 4, "raw": true}-->

displays as:

πŸ“¦ webview/webview_deno: ⭐️ 439
πŸ“¦ denosaurs/denon: ⭐️ 415
πŸ“¦ nestdotland/eggs: ⭐️ 8
πŸ“¦ nestdotland/hatcher: ⭐️ 2
Configuration
option value default description
rows string 10 Maximum number of rows to generate.
sort string "stars" Sort repositories by "stars", "created", "updated", "pushed", "full_name".
raw boolean false Strip markdown formatting.

Current Timestamp

Display your most recent GitHub activity

<!--TIMESTAMP:{"format": "dddd, MMMM Do YYYY, h:mm:ss"}-->

displays as:

Tuesday, July 21st 2020, 8:52:54 am UTC
Configuration
option value default description
format string ISO 8601 moment format.
tz boolean UTC moment timezone.

Feed

Display items from web feeds such as rss or atom.

<!--FEED:{"rows": 5, "select": "hackernews show", shuffle: true, "title": true  }-->

<!--FEED:{"rows": 5, "select": ["hackernews ask", "hackernews show"], "raw": true, "title": true }-->

displays as:

πŸ“° Hackernews Show

This is generated from feed provided here. Add it to your rss reader!


Index Posts Domain
1 Show HN: Johariapp – For individuals to track their performance on Johari Window johariapp.com
2 Show HN: Create and Monetize your Zoom Events in under 2 Minutes ditto.video
3 Show HN: Compare various PDF-to-text libraries in a few clicks www.apibatchtest.com
4 Show HN: UDT Courseware – Train people how to label a dataset universaldatatool.com
5 Show HN: An OpenStreetMap Gutenberg Block for WordPress wordpress.org

πŸ“‹ Hackernews Ask

This is generated from feed provided here. Add it to your rss reader!


  1. Show HN: Johariapp – For individuals to track their performance on Johari Window (johariapp.com)

  2. Show HN: Create and Monetize your Zoom Events in under 2 Minutes (ditto.video)

  3. Show HN: Compare various PDF-to-text libraries in a few clicks (www.apibatchtest.com)

  4. Show HN: UDT Courseware – Train people how to label a dataset (universaldatatool.com)

  5. Show HN: An OpenStreetMap Gutenberg Block for WordPress (wordpress.org)

Configuration
option value default description
rows number 5 Number of items to display
raw boolean false Strip table markdown
shuffle boolean false Shuffle the items from the feed
title boolean false Controls whether to add a title automatically from the feed.
select string[] all[] Select specific feeds to display.

Here's what FEEDS.json looks like.

{
  "hackernews top": "https://hnrss.org/frontpage",
  "hackernews show": "https://hnrss.org/show",
  "hackernews ask": "https://hnrss.org/show"
}

Inputs

name value default description
github_token string Token for the repo. Can be passed in using ${{ secrets.GITHUB_TOKEN }}.
username string Github profile username.
feed string "FEEDS.json" FEEDS.json file
template string './TEMPLATE.md' TEMPLATE.md file path.
readme string './README.md' README.md output file path.

License

The scripts and documentation in this project are released under the MIT License.