Skip to content

HUGO

Installation on macOS

Install HUGO with homebrew

brew install hugo

Create new site

In my case the new site is called panoair

hugo new site panoair

Add theme

I'm going for the Hugo Story theme

Change the working directory to your site

cd panoair

add theme

git clone https://github.com/caressofsteel/hugo-story.git themes/hugo-story

copy theme-parameteres to the directory of your site

cp -r themes/hugo-story/exampleSite/data ./
cp themes/hugo-story/exampleSite/config.toml ./

Serve the new site

hugo server

If everything went smoothly your output should look similar to mine:

Web Server is available at //localhost:1313/ (bind address 127.0.0.1)

open localhost in your browser

Customize

Change your files to your needs:

  • mkdocs.yml  -> root folder
  • banner.yml   -> data folder

To serve and test the site locally, add this to your basic configuration of your mkdocs.yml file

relativeURLs = true

Build site

Some flags might be added to the following command:

hugo

default folder for the output -> public folder