Hugo: The world’s fastest framework for building websites.

To update or switch versions, run webi hugo@stable (or @v0.87, @beta, etc).

Files

These are the files / directories that are created and/or modified with this install:

~/.config/envman/PATH.env
~/.local/opt/hugo/
~/.local/bin/hugo

Cheat Sheet

Hugo is one of the most popular open-source static site generators. It makes building websites fun again.

Hugo is a simple and fast Jamstack / Static Site Generator (SSG) tool, which comes in two flavors:

Hugo Standard Edition: Fast, Safe, & Runs Almost Everywhere

Hugo Extended Edition: Supports libsass transpilation and WebP encoding, but mixed with unsafe C code and available for fewer OSes and CPU architectures

How to Pick & Switch Editions

You'll need Hugo Extended Edition for:

  • legacy libsass support - if you use templates that require it
    ("dartsass", also known as just "sass", is supported in both)
  • WebP encoding

Use webi hugo-extended and webi hugo to switch between editions.

Use hugo env to determine which edition you're running (Extended Edition references libsass and WebP in the output).

See hugo-extended tips specific to Hugo Extended Edition.

Create a new site

# create a new site
hugo new site ./blog.example.com
# compile a site
hugo
# serve a site in dev mode
hugo server -D

Use the Hugo+eon Bliss Template

Check out BeyondCodeBootcamp/bliss-template.

  • Build automatically with GitHub Actions (or GitDeploy)
  • Good-looking template (eon)
  • Works with the Bliss blog front end

Contribute

Report an Issue Submit Installer Star on GitHub