Notes to handle this GitHub Pages site

Basic site setup

Check Hugo quickstart.

hugo new site mysite --force

Theme

Install PaperMod theme (Method 2: submodule):

# this generate a .gitmodules file
git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod
# once you have a valid .gitmodules file, just run
git submodule update --init --recursive

Load submodules after cloning the repo:

git submodule update --init

Update the theme:

git submodule update --remote --merge

Add content

hugo new posts/my-first-post.md

Everything is a draft by default, keep in mind when serving the site. You can change this behaviour editing ./archetypes/default.md.

Add image

Images go to the ./static folder.

You can reference them from your markdown (no need of "/static/" prefix):

![Image Label](/image-name.jpg)

Check content

hugo server

Include drafts with

hugo server --buildDrafts

The command hugo-lunr knows where to check for content (./content) and where to create the index (./public/lunr.json)

Add tags and categories

This example is clearer (and shorter) than the official documentation