ghaction-github-pages

Go to file

CrazyMax 094f87438c Add all		2019-11-15 15:01:51 +01:00
.dependabot	Update dependabot conf	2019-10-23 11:30:04 +02:00
.github	Fix uncommitted workflow	2019-11-14 23:25:05 +01:00
lib	Add all	2019-11-15 15:01:51 +01:00
node_modules/@actions	Update node_modules	2019-11-06 01:46:58 +00:00
src	Add all	2019-11-15 15:01:51 +01:00
.editorconfig	Add editorconfig	2019-09-15 06:59:39 +02:00
.gitattributes	Switch to TypeScript Action (#3 )	2019-10-11 01:41:16 +02:00
.gitignore	Add node_modules for testing purpose	2019-10-11 01:44:23 +02:00
.prettierrc.json	Match vars and inputs	2019-11-06 03:02:59 +01:00
action.yml	Add keep_history, allow_empty_commit and fqdn inputs (#23 )	2019-11-15 14:40:43 +01:00
LICENSE	Initial version	2019-08-31 22:23:41 +02:00
package-lock.json	Bump prettier from 1.18.2 to 1.19.1 (#22 )	2019-11-12 00:07:13 +01:00
package.json	Bump prettier from 1.18.2 to 1.19.1 (#22 )	2019-11-12 00:07:13 +01:00
README.md	Add keep_history, allow_empty_commit and fqdn inputs (#23 )	2019-11-15 14:40:43 +01:00
tsconfig.json	Switch to TypeScript Action (#3 )	2019-10-11 01:41:16 +02:00

README.md

✨ About

A GitHub Action to deploy to GitHub Pages

If you are interested, check out my other :octocat: GitHub Actions!

🚀 Usage

Below is a simple snippet to deploy to GitHub Pages. A test example is also available for this repository.

name: website

on: push

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      -
        name: Checkout
        uses: actions/checkout@v1
      -
        name: Build
        run: |
          mkdir public
          cat > public/index.html <<EOL
          <!doctype html>
          <html>
            <head>
              <title>GitHub Pages deployed!</title>
            </head>
            <body>
              <p>GitHub Pages with <strong>${{ github.sha }}</strong> commit ID has been deployed through <a href="https://github.com/marketplace/actions/github-pages">GitHub Pages action</a> successfully.</p>
            </body>
          </html>
          EOL          
      -
        name: Deploy
        if: success()
        uses: crazy-max/ghaction-github-pages@v1
        with:
          target_branch: gh-pages
          build_dir: public
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

💅 Customizing

inputs

Following inputs can be used as step.with keys

Name	Type	Description
`repo`	String	GitHub repository where assets will be deployed (default current)
`target_branch`	String	Git branch where assets will be deployed (default `gh-pages`)
`keep_history`	Bool	Create incremental commit instead of doing push force (default `false`)
`allow_empty_commit`	Bool	Git branch where assets will be deployed (default `true`)
`build_dir`	String	Build directory to deploy (required)
`commit_name`	String	Commit author's name (default GITHUB_ACTOR or `github-actions`)
`commit_email`	String	Commit author's email (default `<committer_name>@users.noreply.github.com`)
`commit_message`	String	Commit message (default `Deploy to GitHub pages`)
`fqdn`	String	Write the given domain name to the CNAME file

environment variables

Following environment variables can be used as step.env keys

Name	Description
`GITHUB_TOKEN`	GITHUB_TOKEN as provided by `secrets`
`GITHUB_PAT`	Personal Access Token (see Limitation section below)

⚠️ Limitation

Currently, GITHUB_TOKEN does not suffice to trigger a page build on a public repository (propagate content to the GitHub content-delivery network). You must therefore create a custom Personal Access Token and use it through the GITHUB_PAT environment variable:

- name: Deploy
  if: success()
  uses: crazy-max/ghaction-github-pages@v1
  with:
    target_branch: gh-pages
    build_dir: public
  env:
    GITHUB_PAT: ${{ secrets.GITHUB_PAT }}

🤝 How can I help ?

All kinds of contributions are welcome 🙌! The most basic way to show your support is to star 🌟 the project, or to raise issues 💬 You can also support this project by becoming a sponsor on GitHub 👏 or by making a Paypal donation to ensure this journey continues indefinitely! 🚀

Thanks again for your support, it is much appreciated! 🙏

📝 License

MIT. See LICENSE for more details.