Skip to content

An Action 🎬 to create a Guestbook πŸ“–βœ’ in your Repository πŸ“š

License

Notifications You must be signed in to change notification settings

joshmgross/guestbook

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

53 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Guestbook

An Action 🎬 to create a Guestbook πŸ“–βœ’ in your Repository πŸ“š

Usage

Pre-requisites

Create a workflow .yml file in your repositories .github/workflows directory. An example workflow is available below. For more information, reference the GitHub Help Documentation for Creating a workflow file.

Create an issue in your repository. Any comment in this issue approved (:+1:) by an authorized user will be added to the guestbook. See #1 for an example issue.

Inputs

  • issue - The issue number to retrieve guestbook entries (required)
  • token - Authorization token used to interact with the repository and update the guestbook. Defaults to github.token
  • approvers - List of users allowed to approve comments for the guestbook
  • guestbook-path - File path of the guestbook

Example Workflow

    steps:
    - uses: actions/checkout@v2
    - uses: joshmgross/guestbook@main
      with:
        issue: 1
        approvers: |
          joshmgross
    - name: Update guestbook
      run: |
        if [[ `git status --porcelain` ]]; then
          git config --local user.email "actions@github.com"
          git config --local user.name "${{ github.actor }}"
          git add README.md
          git commit -m "✏ Update guestbook"
          git push
        fi

See main.yml for a full workflow file example.

In your guestbook markdown file, add comments to denote the start and end of the guestbook. Everything within these comments will be replaced by approved comments from the issue specified.

<!--START:guestbook-->

<!--END:guestbook-->

Example Guestbook

See guestbook.md for an example guestbook.

Prior Art 🎨

Inspired by @JasonEtco's readme-guestbook

About

An Action 🎬 to create a Guestbook πŸ“–βœ’ in your Repository πŸ“š

Resources

License

Stars

Watchers

Forks

Packages

No packages published