d46d0aa12e
Refactoring * feat: Add reject to Promise * feat: Add printing inputs * feat: Add error handling to getLatestVersion() * feat: show version of Hugo, Go, and Git (Close #23) * refactor: Get the latest version from Homebrew (Close #26) * refactor: enhance error message of promise reject Enhancement for workflow * gha: Add deps (test-prod job needs test job) * gha: Fix matrix testing * gha: comment out Build production step * gha: remove Dump step Update README * docs: update readme
100 lines
3.1 KiB
Markdown
100 lines
3.1 KiB
Markdown
[](https://github.com/peaceiris/actions-hugo/blob/master/LICENSE)
|
||
[](https://github.com/peaceiris/actions-hugo/releases/latest)
|
||
[](https://github.com/peaceiris/actions-hugo/releases)
|
||
[](https://github.com/peaceiris/actions-hugo/actions)
|
||
|
||
<img width="400" alt="GitHub Actions for Hugo" src="./images/ogp.svg">
|
||
|
||
|
||
|
||
## GitHub Actions for Hugo extended and Modules
|
||
|
||
- [gohugoio/hugo: The world’s fastest framework for building websites.](https://github.com/gohugoio/hugo)
|
||
|
||
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 action. We no longer build or pull a Hugo docker image. Thanks to this change, we can complete this action less than **1 sec**. (Docker base action was taking about 1 min execution time to build or pull.)
|
||
|
||
|
||
|
||
## Getting started
|
||
|
||
### Create `.github/workflows/gh-pages.yml`
|
||
|
||
An example workflow with [GitHub Actions for deploying to GitHub Pages with Static Site Generators]
|
||
|
||
[GitHub Actions for deploying to GitHub Pages with Static Site Generators]: https://github.com/peaceiris/actions-gh-pages
|
||
|
||
[](https://github.com/peaceiris/actions-gh-pages)
|
||
|
||
|
||
|
||
|
||
```yaml
|
||
name: github pages
|
||
|
||
on:
|
||
push:
|
||
branches:
|
||
- master
|
||
|
||
jobs:
|
||
build-deploy:
|
||
runs-on: ubuntu-18.04
|
||
steps:
|
||
- uses: actions/checkout@master
|
||
|
||
- name: Setup Hugo
|
||
uses: peaceiris/actions-hugo@v2.0.0
|
||
with:
|
||
hugo-version: '0.58.2'
|
||
|
||
- 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
|
||
|
||
### Hugo extended
|
||
|
||
```yaml
|
||
- name: Setup Hugo
|
||
uses: peaceiris/actions-hugo@v2.0.0
|
||
with:
|
||
hugo-version: '0.58.2'
|
||
extended: true
|
||
```
|
||
|
||
### Latest version of Hugo
|
||
|
||
```yaml
|
||
- name: Setup Hugo
|
||
uses: peaceiris/actions-hugo@v2.0.0
|
||
with:
|
||
hugo-version: 'latest'
|
||
```
|
||
|
||
This action fetches the latest version of Hugo by [hugo | Homebrew Formulae](https://formulae.brew.sh/formula/hugo)
|
||
|
||
|
||
|
||
## License
|
||
|
||
- [MIT License - peaceiris/actions-hugo]
|
||
|
||
[MIT License - peaceiris/actions-hugo]: https://github.com/peaceiris/actions-hugo/blob/master/LICENSE
|
||
|
||
|
||
|
||
## About the author
|
||
|
||
- [peaceiris's homepage](https://peaceiris.com/)
|