Information Technology Grimoire

Version .0.0.1

IT Notes from various projects because I forget, and hopefully they help you too.

Hugo Themes

Add a Theme

You will usually want a theme. Go to the root folder of your new hugo project. There are many themes. I’m going to cover the hugo techdoc theme only. There are many pre made ones that you can modify: https://themes.gohugo.io/

git submodule add https://github.com/thingsym/hugo-theme-techdoc.git themes/hugo-theme-techdoc

Initialize and update submodules

git submodule update –init –recursive

Start the Hugo Server With Theme

To start the server with the theme, you will need the specify it

hugo server -t hugo-theme-techdoc

or

hugo server --noHTTPCache --disableFastRender -t hugo-theme-techdoc

Theme Editing

Understanding golang will help make sense of editing the scripting, but the scripting is not required too.

https://gohugo.io/variables/page/

Sample Site

https://thingsym.github.io/hugo-theme-techdoc/sample/