✏️ Dockerized Hugo Extended with Asciidoctor, Pygments, Babel, PostCSS, and Autoprefixer baked-in
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
Jake Jarvis 7d20947610
Hugo v0.84.0
1 day ago
.github/workflows Update build.yml 3 months ago
.dockerignore Test action by building Hugo docs site (#1) 1 year ago
Dockerfile Hugo v0.84.0 1 day ago
LICENSE.md Update LICENSE.md 2 years ago
README.md Update README.md 2 months ago

README.md

✏️ Hugo Extended via Docker

Build

A base image to ease local development of Hugo sites, including Hugo Extended (with SASS/SCSS support) and optional third-party tools (listed below). Now with multi-architecture images for native AMD64 and ARM64 support!

Usage

Command line

This will start a live server at http://localhost:1313/ from the Hugo site in your current directory:

docker run -v $(pwd):/src -p 1313:1313 jakejarvis/hugo-extended:latest server --buildDrafts --buildFuture --bind 0.0.0.0

docker-compose.yml

version: '3'

services:
  hugo:
    image: jakejarvis/hugo-extended:latest
    ports:
      - 1313:1313
    volumes:
      - ./:/src
    command: server --buildDrafts --buildFuture --bind 0.0.0.0

Notes

When using Docker to run a live server (i.e. hugo server), you must pass --bind 0.0.0.0 as an argument to fix some networking quirks between Hugo, the container, and the host.

Third-party software

Just in case, the final Alpine Linux container includes a few small third-party tools that are required by certain optional Hugo features:

Node (with NPM and Yarn), Go (for Hugo Modules support), and Python are also pre-installed.

Licenses

This project is distributed under the MIT License. Hugo is distributed under the Apache License 2.0.