Skip to content

Deploy Hugo Site to GitHub Pages #1

Deploy Hugo Site to GitHub Pages

Deploy Hugo Site to GitHub Pages #1

Workflow file for this run

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