This document shows a brief guide to setup hugo-theme-monochrome in your hugo project.
Quick Start
Install Hugo
You need “extended” version of hugo to support SASS. Checkout Install Hugo for more details.
Take Linux for example:
The minimum hugo version that hugo-theme-monochrome required is
0.112.0
Create a New Site
Add a Theme
Then add theme = "hugo-theme-monochrome"
to your config.toml
Customize the Theme
See Configuration.
Start the Hugo server
Minify CSS and JS resources. The minifier of JavaScript here is powered by ESBuild.
Build static pages
Generate files to /public
folder, --minify
option can minify other resouces (e.g. HTML/XML/JSON…).
See Configure Minify to adjust the behavior of hugo minifier (powered by minify).
Deployment
Push /public
folder to your server.
For reference, this site is built by using Github Action and Github Pages. The CI script is available here.
Deployment on github
If you want to deploy your own site on github and you would like it to be built using Github Action and Github Pages you can follow these instructions on the HUGO website with the only change being to uncomment the following line in Setup Hugo:
This is needed since Monochrome uses SCSS.
Otherwise the Github Action will fail with the following message: