Deploy Hugo Site to GitHub Pages #1
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
name: Deploy Hugo Site to GitHub Pages | |
on: | |
push: | |
paths-ignore: | |
- "images/**" | |
- "LICENSE" | |
- "README.md" | |
branches: | |
- master # Replace with your default branch (e.g., main or master) | |
workflow_dispatch: | |
# Manual trigger | |
inputs: | |
hugoVersion: | |
description: "Hugo Version" | |
required: false | |
default: "0.125.7" # Default Hugo version | |
# Allow one concurrent deployment | |
concurrency: | |
group: "pages" | |
cancel-in-progress: true | |
# Default to bash | |
defaults: | |
run: | |
shell: bash | |
# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages | |
permissions: | |
contents: read | |
pages: write | |
id-token: write | |
jobs: | |
# Build job | |
build: | |
runs-on: ubuntu-latest | |
env: | |
HUGO_VERSION: ${{ github.event.inputs.hugoVersion || '0.125.7' }} # Use input or default version | |
steps: | |
- name: Install Hugo CLI | |
run: | | |
wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_${HUGO_VERSION}_linux-amd64.deb \ | |
&& sudo dpkg -i ${{ runner.temp }}/hugo.deb | |
- name: Checkout code | |
uses: actions/checkout@v4 | |
with: | |
submodules: true # Fetch Hugo themes (if used) | |
- name: Setup Pages | |
id: pages | |
uses: actions/configure-pages@v5 | |
- name: Build with Hugo | |
run: | | |
hugo \ | |
--buildDrafts --gc \ | |
--baseURL ${{ steps.pages.outputs.base_url }} | |
- name: Upload artifact | |
uses: actions/upload-pages-artifact@v3 | |
with: | |
path: ./public | |
# Deployment job | |
deploy: | |
environment: | |
name: github-pages | |
url: ${{ steps.deployment.outputs.page_url }} | |
runs-on: ubuntu-latest | |
needs: build | |
steps: | |
- name: Deploy to GitHub Pages | |
id: deployment | |
uses: actions/deploy-pages@v4 |