1
mirror of https://github.com/jakejarvis/hugo-docker.git synced 2025-04-26 12:58:28 -04:00
hugo-docker/README.md
2019-08-26 10:25:44 -04:00

2.0 KiB

GitHub Action for Hugo ✏️

⚠️ Note: To use this action, you must have access to the GitHub Actions feature. GitHub Actions are currently only available in public beta. You can apply for the GitHub Actions beta here.

This is a simple GitHub Action that contains Hugo, the popular static site generator. Unlike other actions, this action includes releases going back to v0.27 (Sept. 11, 2017) for any compatibility requirements.

Usage

workflow.yml Example

This example simply uploads the ./public directory (the built Hugo website) as an artifact. You can replace the last actions/upload-artifact step with another action, like my s3-sync-action, to upload the built static site somewhere accessible.

Replace the master in uses: jakejarvis/hugo-build-action@master to specify the Hugo version, back to v0.27, like hugo-build-action@v0.27. This might be necessary if a recent version broke compatibility with your site. Otherwise, you'll get the latest version.

The with: args: portion holds any optional flags. You can remove those two lines for a vanilla build.

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@master
    - uses: jakejarvis/hugo-build-action@master
      with:
        args: --minify --buildDrafts
    - uses: actions/upload-artifact@master
      with:
        name: website
        path: './public'

License

CC0

To the extent possible under law, Jake Jarvis has waived all copyright and related or neighboring rights to this work.