No description, website, or topics provided.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
Dockerfile
README.mdwn

README.mdwn

Hugo Container

Usage

docker run -it --rm        \
  --publish 1313:1313      \
  --volume $(pwd):/tmp/pwd \
  --user $(id -u)          \
  frew/hugo                \
  server

Description

Hugo is a static site generator written in Go. It is incredibly fast and efficient. Normally a container for a typical Go program would be overkill, as the binaries are statically linked. In Hugo's case, though, Python is used to syntax highlight code, along with a few libraries to support that feature. This container includes everything to support the syntax highlighting.

Ports

Port 1313 is exposed for the debug server.

Volumes

The one exposed / required volume is /tmp/pwd, which represents the directory you want to be Hugo's pwd.

Shortcut Usage

I recommend putting the following script in your path to make usage of this container easier, presumably named hugo:

#!/bin/dash

exec docker run -it --rm   \
  --publish 1313:1313      \
  --volume $(pwd):/tmp/pwd \
  --user $(id -u)          \
  frew/hugo                \
  "$@"

Note that because the above publishes to a static port you cannot, for instance, run hugo help while hugo server is already running. I warmly welcome patches to only add the --publish 1313:1313 if server is the subcommand being used.