Building off of
- this tutorial
- this theme
- and visual inspiration from this Jekyll site
Helpful resources for dev:
- Tutorial for Hugo folder structure
- this Markdown cheatsheet
- Tutorial for converting from Bootstrap to CSS Grid
assetsare only loaded when they are needed.staticis always loaded.- images that are directly linked to should be in
staticwhile images that are processed should be inassets. - Images that are processed from
assetsmay need a server restart in order to see the proper changes, due to caching. - If things are stored in
assets, you may need to do a brute force call of them to get them in the cache.
- images that are directly linked to should be in
- The idea of the "microcommit"
Notes
<head>is for indexing only, not for visible changes- edit config.yaml for deciding which theme to use
- Run "hugo --gc --minify" to prevent excessive amounts of whitespace in the generated html
- Use ctrl+shift+R to force cache to refresh for CSS
- There is a bug that doesn't let you do shortcodes and markdown within inner, so unfortunately this means no Markdown within my toggle galleries
- For some reason, the default github pages action does not work so we have to do the docs compilation approach instead