actions-hugo/README.md
Shohei Ueda dc8541739a
Feat: Support macOS and Windows, migrate JavaScript to TypeScript (#32)
- Support macOS and Windows (Close #24 )
- Refactoring
  - Error handling
  - TypeScript
- Prettier (Close #29 )
- GHA: Add upload-artifact step for test coverage
- deps: Install husky
2019-09-21 10:41:21 +09:00

3.4 KiB
Raw Blame History

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 3 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

Getting started

Create your workflow

An example workflow .github/workflows/gh-pages.yml with GitHub Actions for deploying to GitHub Pages with Static Site Generators

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
    # runs-on: macOS-10.14
    # runs-on: windows-2019
    steps:
    - uses: actions/checkout@master

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

    - name: Build
      run: hugo --gc --minify --cleanDestinationDir

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

Options

Use Hugo extended

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

Use the latest version of Hugo

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

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

License

About the author