Hugo is being used to manage content in my branch. I'm currently looking into how more markup can be moved into templates and use only markdown for authoring site content.

Initial bit of work can be found in the following branch: https://github.com/avtar/sojustrepairit.org/tree/SJRK-166

I had all the pages rendering using markdown files at one point but when it came time to push everything to a branch I realized some of the pages might have been cached and stopped being generated as I continued to poke around  Right now the home page works. I'll troubleshoot this further on Monday and update my notes in the previous comment.

hugo version
Hugo Static Site Generator v0.51/extended darwin/amd64 BuildDate: unknown

• Create a new site in your site directory

  • hugo new site .

• Use YAML config files instead of the default TOML

  • mv config.toml config.yml

• Edit the newly generated config file

• The default directory structure is documented at the following location

  • https://gohugo.io/getting-started/directory-structure/

  • When Hugo runs it creates a resources directory which isn't covered in the page above. It is a resource cache where generated files, such as images, are stored. For more information refer to the following forum post: https://discourse.gohugo.io/t/why-does-hugo-create-the-resources-directory/13021/3?u=balibebas

  • To make use of Hugo's asset processing features a top level assets directory needs to exist

  • The remaining files for your site that won't be minified or altered in other ways by Hugo should go in the static directory

• More information about asset management

  • https://gohugo.io/hugo-pipes/introduction/

  • https://gohugo.io/hugo-pipes/minification/

  • https://gohugo.io/hugo-pipes/fingerprint/

• Create a new assets/css directory and copy CSS files to that location

  • mkdir -p assets/css

  • cp ~/path/to/your/style.css assets/css/

• To minify and fingerprint our style.css use the following lines in your template

• Remove any unneeded directories

  • rm -rf archetypes/ data/ themes/

• Create a .gitignore file

• Create your index/home page and split up content in the partials directory

  • touch layouts/index.html

  • mkdir -p layouts/{_default,partials}

• This next step is not right, will troubleshoot and document

  • cp layouts/index.html layouts/_default/single.html

• Create your static pages in the content directory as Markdown files

  • touch content/ {_index,about,resources,partners}.md

• Start Hugo in "drafts" mode

  • hugo server --disableFastRender -D