Pages Tutorial

Built with Hugo & GitLab Pages

A few handy things to know when working with this setup.

Local development

Run the local dev server with live-reload:

hugo server -D

The -D flag includes draft posts. Visit http://localhost:1313 in your browser.

Creating new content

hugo new content post/my-new-post.md

Edit the generated file — set draft: false (or remove the draft key) when the post is ready to publish.

Front matter fields

The CleanWhite theme recognises these optional front matter fields:

FieldPurpose
descriptionPost subtitle shown on the card
tagsTag cloud entries
categoriesCategory grouping
featured_imageHero image for the post (path under static/)

Building for production

hugo --minify

Output lands in the public/ directory — the same directory the CI pipeline publishes to GitLab Pages.