ghaction-github-pages

Go to file

CrazyMax 9c1675e58f update dev dependencies		2023-05-06 14:52:49 +02:00
.github	Bump docker/bake-action from 2 to 3	2023-04-19 04:56:43 +00:00
.yarn	Add plugin-interactive-tools yarn pkg	2023-05-06 14:33:11 +02:00
dist	Update generated content	2022-10-18 21:42:13 +02:00
src	update dev dependencies and workflow (#166 )	2022-04-24 03:14:32 +02:00
.dockerignore	Update to Yarn 3.5.1	2023-05-06 14:32:28 +02:00
.editorconfig	Update editorconfig	2020-04-09 03:37:51 +02:00
.eslintrc.json	update dev dependencies and workflow (#166 )	2022-04-24 03:14:32 +02:00
.gitattributes	Update to Yarn 3.5.1	2023-05-06 14:32:28 +02:00
.gitignore	Update to Yarn 3.5.1	2023-05-06 14:32:28 +02:00
.prettierignore	Update to Yarn 3.5.1	2023-05-06 14:32:28 +02:00
.prettierrc.json	Match vars and inputs	2019-11-06 03:02:59 +01:00
.yarnrc.yml	Add plugin-interactive-tools yarn pkg	2023-05-06 14:33:11 +02:00
action.yml	Node 16 as default runtime (#167 )	2022-05-26 10:30:53 +02:00
codecov.yml	update dev dependencies and workflow (#166 )	2022-04-24 03:14:32 +02:00
dev.Dockerfile	Dockerfile: fix typo	2023-05-06 14:38:07 +02:00
docker-bake.hcl	Update to Yarn 3.5.1	2023-05-06 14:32:28 +02:00
LICENSE	new year	2023-02-18 22:45:50 +01:00
package.json	update dev dependencies	2023-05-06 14:52:49 +02:00
README.md	readme: fix badge	2022-12-21 05:10:11 +01:00
tsconfig.json	update dev dependencies and workflow (#166 )	2022-04-24 03:14:32 +02:00
yarn.lock	update dev dependencies	2023-05-06 14:52:49 +02:00

README.md

About

A GitHub Action to deploy to GitHub Pages

Usage
Customizing
- inputs
- environment variables
Contributing
License

Usage

Workflow

Below is a simple snippet to deploy to GitHub Pages with a dummy HTML page.

A workflow is also available for this repository and deploys everyday to GitHub pages.

name: website

on: push

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      -
        name: Checkout
        uses: actions/checkout@v3
      -
        name: Gen dummy page
        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 to GitHub Pages
        if: success()
        uses: crazy-max/ghaction-github-pages@v3
        with:
          target_branch: gh-pages
          build_dir: public
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Sign commits

You can use the Import GPG GitHub Action along with this one to sign commits:

      -
        name: Import GPG key
        uses: crazy-max/ghaction-import-gpg@v5
        with:
          gpg_private_key: ${{ secrets.GPG_PRIVATE_KEY }}
          passphrase: ${{ secrets.PASSPHRASE }}
          git_user_signingkey: true
          git_commit_gpgsign: true
      -
        name: Deploy to GitHub Pages
        if: success()
        uses: crazy-max/ghaction-github-pages@v3
        with:
          target_branch: gh-pages
          build_dir: public
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Check availability of GitHub Pages

You can use the GitHub Status Action along with this one to check availability of GitHub Pages before deploying:

      -
        name: Check GitHub Pages status
        uses: crazy-max/ghaction-github-status@v3
        with:
          pages_threshold: major_outage
      -
        name: Deploy to GitHub Pages
        if: success()
        uses: crazy-max/ghaction-github-pages@v3
        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
`domain`	String	Git domain (default `github.com`)
`repo`	String	GitHub repository where assets will be deployed (default `$GITHUB_REPOSITORY`)
`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)
`absolute_build_dir`	Bool	Whether to treat `build_dir` as an absolute path (defaults to `false`, making it relative to the working directory)
`follow_symlinks`	Bool	If enabled, the content of symbolic links will be copied (default `false`)
`committer`	String	Committer name and email address as `Display Name <joe@foo.bar>` (defaults to the GitHub Actions bot user)
`author`	String	Author name and email address as `Display Name <joe@foo.bar>` (defaults to the GitHub Actions bot user)
`commit_message`	String	Commit message (default `Deploy to GitHub pages`)
`fqdn`	String	Write the given domain name to the CNAME file
`jekyll`	Bool	Allow Jekyll to build your site (default `true`)
`dry_run`	Bool	If enabled, nothing will be pushed (default `false`)
`verbose`	Bool	Enable verbose output (default `false`)

environment variables

Following environment variables can be used as step.env keys

Name	Description
`GITHUB_TOKEN`	GITHUB_TOKEN as provided by `secrets`
`GH_PAT`	Use a Personal Access Token if you want to deploy to another repo

Contributing

Want to contribute? Awesome! The most basic way to show your support is to star the project, or to raise issues. If you want to open a pull request, please read the contributing guidelines.

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.