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
assets
are only loaded when they are needed.static
is always loaded.- images that are directly linked to should be in
static
while images that are processed should be inassets
. - Images that are processed from
assets
may 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