Install

Make sure you install add-ons

Create a new site with yaml format

Modified from here

1. Create directory Structure

   hugo new site --format=yaml foldername
   cd foldername
   

2. Initialize git repository and add theme

   Might I suggest using this forked version of the “liva” theme? It has some nice enhancements

   git init
   git submodule add https://github.com/danb0b/external_liva-hugo.git themes/liva-hugo
   # or
   git submodule add https://github.com/danb0b/website_hugo_framework.git themes/website_hugo_framework
   # or 
   git submodule add https://github.com/dillonzq/LoveIt.git themes/LoveIt
   

3. Add theme to config.yaml

   echo theme: \"liva-hugo\" >> config.yaml
   # or 
   echo theme: \"website_hugo_framework\" >> config.yaml
   

4. Customize config.yaml

5. Run server for testing

   Production:

   hugo server
   

   With Drafts:

   hugo server -D
   

1 Build Pages

Production:

```bash
hugo
```

With drafts:

```bash
hugo -D
```

External Links

General

• https://gohugo.io/getting-started/quick-start/
• Page Variables
• The Page Variable
• https://cloudcannon.com/blog/the-ultimate-guide-to-hugo-sections/

Essential Add-ons

• Original liva theme
• Citations for Hugo
• custom pagination

Search

• https://gist.github.com/eddiewebb/735feb48f50f0ddd65ae5606a1cb41ae
• https://ben.land/post/2021/12/02/hugo-search-functionality/

JSON

• https://xdeb.org/post/2017/make-hugo-generate-a-json-search-index-and-json-feed/

Using with Github Actions

• automated deploytment on github pages
• detailed setup
• actions-gh-pages

Themes and Examples

• https://themes.gohugo.io/hugo-theme-bootstrap4-blog/
• https://www.liwen.id.au/photoswipe/

Documentation themes

• https://themes.gohugo.io/tags/docs/

Ones I didn’t like as much

• https://github.com/NotWoods/hugo-bootstrap-5
• Doks (relies on npm and nodejs, no deal)
• Whisper
• HBS

Good one:

• Geek Docs

Google Fonts helper

https://gwfh.mranftl.com/fonts/