How to setup and use hugo

Setup

• follow installation instructions for hugo
• clone the repository

git clone --recursive https://github.com/Team-13-RLC/team-13-rlc.github.io

Usage

Note: All commands from here are run from the _site-source directory

• create a new post, download page or documentation

hugo new post/name-of-the-page.md
hugo new download/name-of-the-page.md
hugo new docs/name-of-the-page.md

• generate the site with the new pages

hugo -d ../

• safely delete the generated pages (UNIX-like systems only)

./cleanup

• test the website locally (site will be available at 127.0.0.1:1313)

hugo -D server

• make the changes public

cd ../
git add .
git commit -m "Commit message"
git push

Note: Every markdown page created with "hugo new" will have some metadata at the top. This includes "draft: true". This needs to be changed to "draft: false" in order for the page to be visible publicly.