Go to file
2019-11-19 09:06:21 +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 Trim token (#25) 2019-11-19 00:33:27 +01:00
node_modules Update node_modules 2019-11-15 15:21:04 +00:00
src Trim token (#25) 2019-11-19 00:33:27 +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 Fix inputs 2019-11-16 15:04:57 +01:00
LICENSE Initial version 2019-08-31 22:23:41 +02:00
package-lock.json Bump @types/node from 12.12.8 to 12.12.9 (#26) 2019-11-19 09:06:21 +01:00
package.json Bump @types/node from 12.12.8 to 12.12.9 (#26) 2019-11-19 09:06:21 +01:00
README.md Fix inputs 2019-11-16 15:04:57 +01:00
tsconfig.json Switch to TypeScript Action (#3) 2019-10-11 01:41:16 +02:00

GitHub release GitHub marketplace Test workflow Become a sponsor Paypal Donate

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 Allow an empty commit to be created (default true)
build_dir String Build directory to deploy (required)
committer_name String Commit author's name (default GITHUB_ACTOR or github-actions)
committer_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.