Skip to content

πŸ—’οΈ Generate a README.md summary for your notes repository

License

Notifications You must be signed in to change notification settings

Dementriplimon/notes-summary

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

163 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ—“ Notes Summary GitHub Action

This GitHub Action generates a README.md summary for your notes repository. You can use the workflow to generate a list of items in your repository.

Build CI Release CI Node CI

πŸ‘©β€πŸ’» Getting started

First, setup your repository with this file structure:

β”œβ”€β”€ README.md
β”œβ”€β”€ .github
β”‚   └── workflows
β”‚       └── readme.yml
└── notes
    β”œβ”€β”€ 2019
    β”‚   β”œβ”€β”€ note-name.md
    β”‚   └── another-note-name.md
    └── 2020
        └── a-third-note-name.md

Add the following comment in your README.md file. This will be replaced with a summary of the notes you've participated it:

<!--notes--><!--/notes-->

Finally, create the GitHub Actions workflow in .github/workflows/readme.yml:

name: Readme CI
on:
  push:
    branches: [master]
  schedule:
    - cron: "0 0 * * *"
jobs:
  release:
    name: Update README
    runs-on: ubuntu-18.04
    steps:
      - name: Checkout
        uses: actions/checkout@v2
      - name: Update note summary
        uses: AnandChowdhary/notes-summary@master
        with:
          token: "${{ secrets.GITHUB_TOKEN }}"

Your README.md file should then contains a summary of the notes in the notes directory:

Screenshot of README.md

You can see this example repository: https://github.com/AnandChowdhary/notes

πŸ“„ License

About

πŸ—’οΈ Generate a README.md summary for your notes repository

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 95.5%
  • JavaScript 4.5%