Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lowply/build-hugo
A GitHub Action to build Hugo site.
https://github.com/lowply/build-hugo
github-actions hugo
Last synced: 4 days ago
JSON representation
A GitHub Action to build Hugo site.
- Host: GitHub
- URL: https://github.com/lowply/build-hugo
- Owner: lowply
- License: mit
- Created: 2019-02-24T10:35:20.000Z (almost 6 years ago)
- Default Branch: main
- Last Pushed: 2024-12-17T09:53:20.000Z (7 days ago)
- Last Synced: 2024-12-18T01:36:47.131Z (6 days ago)
- Topics: github-actions, hugo
- Language: Shell
- Homepage:
- Size: 157 KB
- Stars: 31
- Watchers: 3
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hugo - GitHub Action to build Hugo site
README
# Build Hugo
A GitHub Action for building [Hugo](https://gohugo.io/) sites.
- Utilizes [Hugo extended version 0.140.0](https://github.com/gohugoio/hugo/releases/tag/v0.140.0)
- Based on [debian:buster-slim](https://hub.docker.com/_/debian/)
## Usage
### Example Workflow
```yaml
name: Build Hugo
on: [push]
jobs:
build:
name: Build
runs-on: ubuntu-latest
steps:
- name: Check out code
uses: actions/checkout@v2
- name: Build Hugo
uses: lowply/[email protected]
```
### Versioning
The Build Hugo version aligns with [Hugo's releases](https://github.com/gohugoio/hugo/releases). If you need a specific Hugo version to build your website, you can specify it like this:
```yaml
- name: Build Hugo
uses: lowply/[email protected]
```
### Running Locally
To run it locally, use the following command:
```
docker run --rm -w /tmp -v $(pwd):/tmp lowply/build-hugo:v0.140.0
```
## Development
### Keeping Up with the Latest Hugo Version
To create a PR for the latest version, run:
```
./script/update.sh
```
After reviewing and ensuring the PR passes all tests, merge it, and then execute:
```
./script/release.sh
```