GitHub Actions for Hugo ️ Setup Hugo quickly and build your site fast. Hugo extended, Hugo Modules, Linux (Ubuntu), macOS, and Windows are supported. https://github.com/marketplace/actions/hugo-setup
Go to file
peaceiris d88559854c github: Update action meta 2019-10-29 09:59:34 +09:00
.dependabot deps: Add dependabot config 2019-10-23 20:01:55 +09:00
.github github: Remove FUNDING.yml 2019-10-29 03:26:27 +09:00
.vscode Feat: Support macOS and Windows, migrate JavaScript to TypeScript (#32) 2019-09-21 10:41:21 +09:00
__tests__ Feat: Support macOS and Windows, migrate JavaScript to TypeScript (#32) 2019-09-21 10:41:21 +09:00
images [ImgBot] Optimize images (#56) 2019-10-08 14:01:01 +09:00
lib config: enhance tsconfig.json (#44) 2019-09-23 10:58:19 +09:00
node_modules build(deps): bump @actions/core from 1.1.3 to 1.2.0 (#68) 2019-10-22 00:47:05 +09:00
src Refactor: enhance Hugo version dumping (#39) 2019-09-22 10:24:28 +09:00
.editorconfig Feat: Support macOS and Windows, migrate JavaScript to TypeScript (#32) 2019-09-21 10:41:21 +09:00
.envrc chore: delete line 2019-10-09 11:49:24 +09:00
.eslintrc.json Feat: Support macOS and Windows, migrate JavaScript to TypeScript (#32) 2019-09-21 10:41:21 +09:00
.gitignore chore: update .gitignore 2019-10-07 15:10:37 +09:00
.nvmrc gha: Use setup-node (#58) 2019-10-09 00:20:05 +09:00
.prettierrc.json Feat: Support macOS and Windows, migrate JavaScript to TypeScript (#32) 2019-09-21 10:41:21 +09:00
LICENSE add: action 2019-05-22 05:57:34 +09:00
README.md docs: Remove Hugo --gc flag 2019-10-24 21:51:13 +09:00
action.yml github: Update action meta 2019-10-29 09:59:34 +09:00
jest.config.js Feat: Support macOS and Windows, migrate JavaScript to TypeScript (#32) 2019-09-21 10:41:21 +09:00
package-lock.json deps: update 2019-10-29 09:56:12 +09:00
package.json deps: update 2019-10-29 09:56:12 +09:00
tsconfig.json config: enhance tsconfig.json (#44) 2019-09-23 10:58:19 +09:00

README.md

license release GitHub release date GitHub Actions status

GitHub Actions for Hugo

GitHub Actions for Hugo extended and Modules

We can run Hugo on a virtual machine of GitHub Actions by this Hugo action. Hugo extended version and Hugo Modules are supported.

From v2.0.0, this Hugo action migrated to a JavaScript (TypeScript) action. We no longer build or pull a Hugo docker image. Thanks to this change, we can complete this action less than 4 sec. (A docker base action was taking about 1 min or more execution time to build or pull.)

OS (runs-on) ubuntu-18.04 macOS-10.14 windows-2019
Support
Hugo type Hugo Extended Hugo Modules Latest Hugo
Support

Table of Contents

Getting started

Create your workflow

An example workflow .github/workflows/gh-pages.yml with GitHub Actions for GitHub Pages

peaceiris/actions-gh-pages - GitHub

peaceiris/actions-hugo latest version peaceiris/actions-gh-pages latest version

name: github pages

on:
  push:
    branches:
    - master

jobs:
  build-deploy:
    runs-on: ubuntu-18.04
    steps:
    - uses: actions/checkout@master
      # with:
      #   submodules: true

    - name: Setup Hugo
      uses: peaceiris/actions-hugo@v2.2.2
      with:
        hugo-version: '0.58.3'
        # extended: true

    - name: Build
      run: hugo --minify

    - name: Deploy
      uses: peaceiris/actions-gh-pages@v2.5.0
      env:
        ACTIONS_DEPLOY_KEY: ${{ secrets.ACTIONS_DEPLOY_KEY }}
        PUBLISH_BRANCH: gh-pages
        PUBLISH_DIR: ./public

Options

Use Hugo extended

Set extended: true to use a Hugo extended version.

- name: Setup Hugo
  uses: peaceiris/actions-hugo@v2.2.2
  with:
    hugo-version: '0.58.3'
    extended: true

Use the latest version of Hugo

Set hugo-version: 'latest' to use the latest version of Hugo.

- name: Setup Hugo
  uses: peaceiris/actions-hugo@v2.2.2
  with:
    hugo-version: 'latest'

This action fetches the latest version of Hugo by hugo | Homebrew Formulae

License

About the author