Giter VIP home page Giter VIP logo

actions's Introduction

marp-team/actions

Common GitHub Actions and scripts for Marp team projects.

jobs:
  something:
    steps:
      - uses: marp-team/actions@v1
        with:
          task: release
          token: ${{ secrets.GITHUB_TOKEN }}

Please note that provided actions are only for Marp team projects.

Pass the name of task to task parameter in with key of the step.

release: Update GitHub Release

Update GitHub Release for the tagged version based on parsed contents from CHANGELOG.md.

on:
  push:
    tags:
      - v*

jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v1
      - uses: marp-team/actions@v1
        with:
          task: release
          token: ${{ secrets.GITHUB_TOKEN }}

Inputs

  • task (required): Must be release.
  • token (required): GitHub token.
  • convertGitHubMention (optional: true by default): Set whether to convert Markdown links to GitHub profile like [@marp-team](https://github.com/marp-team/) into a plain GitHub mention.
Details about convertGitHubMention

To give credit, CHANGELOG.md may mention to outside contributors who made a good improvement (e.g. Bug fix, critical update of docs, and so on. Minor fix such as typo may not mention the contributor).

We are using a traditional Markdown link into GitHub profile page to keep accessible when reading CHANGELOG.md directly, but using @mention syntax for GitHub releases is better because of the avatar list for to highlight and celebrate our collaborators.

upload: Upload assets to existing GitHub Release

Upload files to existing GitHub release for specified version.

on:
  push:
    tags:
      - v*

jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v1
      - uses: marp-team/actions@v1
        with:
          task: upload
          token: ${{ secrets.GITHUB_TOKEN }}
          files: dist,pkg/xxxxxxxx.zip

Inputs

  • task (required): Must be upload.
  • token (required): GitHub token.
  • files (required): Comma-separated string for upload files or directories.

npm version helper script

This repository also provides a helper script of npm version for including update of CHANGELOG.md to bumped commit.

// package.json
{
  "scripts": {
    "version": "curl https://raw.githubusercontent.com/marp-team/actions/v1/lib/scripts/version.js | node && git add -A CHANGELOG.md"
  }
}

Development

We are following the contributing guideline of marp-team projects. Please read these guidelines this before starting work in this repository.

Release

$ npm version [major|minor|patch]
$ git push && git push --tag

vX.X.X-release tag for production use will create automatically when pushed a semantic versioning tag such as vX.X.X. It includes compiled JS scripts and dependent modules for production.

In addition, the primary version tag such as v1 will move to the created commit by updated release tag when the pushed tag has no identifiers for prerelease.

Author

Managed by @marp-team.

License

MIT License

actions's People

Contributors

coolandsmartrr avatar dependabot[bot] avatar yhatt avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.