Up and Running With

Keisha S Perkins

What is HUGO?

What is HUGO?

  • The world’s fastest static website engine

  • Written in Go (aka Golang)

  • Cross-platform compatible

    • ​Runs on macOS, Windows, Linux, OpenBSD, FreeBSD

    • Really, anything you can get to run the Go compiler can use HUGO

  • ​Portable

    • ​Install HUGO as a binary and run it anywhere

Installing HUGO

https://gohugo.io/getting-started/installing/

Building Your Site

https://gohugo.io/getting-started/quick-start/

Building Your Site

Step One: Give HUGO the hugo new command

hugo new site my-great-site

This creates a new folder with the basic skeleton for your site in whatever directory you call it in.

Building Your Site

Step Two: Add a Theme

cd my-great-site/themes
git clone https://github.com/spf13/hyde

https://themes.gohugo.io

Building Your Site

Step Four: Site Configuration

baseURL = "https://mygreatsite.org/"
languageCode = "en-us"
title = "My Great Site"
theme = "hyde"

Inside of config.toml...

https://gohugo.io/getting-started/configuration/

Building Your Site

Step Three: Add some content

hugo new post/my-first-post.md

Building Your Site

Step Five: Start up the HUGO server

hugo server -D

Default server location: localhost:1313

 

You now have a local copy of your site with auto-reload out of the box. The -D flag makes sure that drafts are rendered.

https://gohugo.io/commands/hugo_server

Demo Time!

Resources

  • Hugo Docs

    • https://gohugo.io

  • Hugo Community

    • https://discourse.gohugo.io

  • Mike Dane's Hugo Playlist

    • https://www.youtube.com/playlist?list=PLLAZ4kZ9dFpOnyRlyS-liKL5ReHDcj4G3

Thanks!