Personal website

Powered by Hugo with PaperMod theme (as submodule). GitHub Pages are deployed from deploy branch. "Deployer for blog" app updates deploy branch from main.

Local commands

hugo server - run the server on localhost

hugo server --bind=0.0.0.0 --baseURL=http://AAA.BBB.CCC.DDD:1313 - run the server and expose it to local network (where AAA.BBB.CCC.DDD is your local IP address). To get local IP address: ipconfig (on Windows), find the correct adapter (Wi-Fi, Ethernet or something else) and take IPv4 Address.

hugo server --cleanDestinationDir --gc --buildDrafts - run the server (including draft content) cleaning target folder upfront.

hugo new content posts/my-post.md - create a new post

Local environment

• hugo (see hugo_version.txt for the version)
• python 3.9+
• pre-commit install to enable pre-commit hooks locally

hugo installation/upgrade

Win: download hugo_extended_***_windows-amd64.zip from hugo releases, unpack and add to $PATH.

Theme init: it's a submodule, so:

git submodule deinit -f --all  # clean the theme
git submodule update --init  # re-checkout the theme

Theme update:

git fetch
git checkout <LATEST_HASH>

Windows terminal

• Shift + Alt + '-' split window horizontally
• Shift + Alt + '+' split window vertically