Skip to content

GH Pages deploy

Actions
This deploys a static site on GitHub Pages
3.2.2
Latest
Star (42)

GitHub Pages deploy

This Action deploys a static site on GitHub Pages.

test

Usage

See action.yml.

- name: Deploy to GitHub Pages
  uses: Cecilapp/GitHub-Pages-deploy@v3
  env:
    GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
  with:
    email: [email protected]
    build_dir: _site               # optional
    branch: website                # optional
    cname: domain.tld              # optional
    jekyll: no                     # optional
    commit_message: custom message # optional

v2 VS v3

GitHub Pages deploy v3 use the secrets.GITHUB_TOKEN instead of a personal access token (PAT), and inputs parameters instead of environment variables. If you want to continue using the previous release (with environment variables) you must set the version: Cecilapp/GitHub-Pages-deploy@v2.

Workflow example

name: GitHub Pages deploy
on:
  push:
    branches:
      - master

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout
        uses: actions/checkout@v3

      - name: Build
        uses: # build your static site

      - name: Deploy to GitHub Pages
        uses: Cecilapp/GitHub-Pages-deploy@v3
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
          email: [email protected]
          build_dir: _site

About user and organization sites

The default publishing source for user and organization sites is the root of the default branch for the repository.

See documentation.

License

GitHub Pages deploy is a free software distributed under the terms of the MIT license.

© Arnaud Ligny

GH Pages deploy is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

About

This deploys a static site on GitHub Pages
3.2.2
Latest

GH Pages deploy is not certified by GitHub. It is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.