TGIH: Themeless and Gitless Introduction to Hugo

My web site is now – after a few years of experiments :crazy_face: – based on Hugo and Asciidoctor. My first new long article is about Hugo and is called:

  TGIH: Themeless and Gitless Introduction to Hugo

Here’s an excerpt from the beginning:

In the steps below, we use the static site generator Hugo to create a simple web site that…

  1. does not require any understanding of Hugo’s lookup order,
  2. does not use a themes directory, which makes it easier to satisfy goal #1,
  3. does not require git, and
  4. does not include any BS Web stuff such as cookies, pop-ups, JavaScript, remote fonts, or remote stylesheets.

Feedback is welcome!

7 Likes

Hi @_nm, thank you for this detailed write up :+1:

17.2. Check baseURL

In config.yaml , make sure there is a trailing forward slash ( / ) at the end of the baseURL key.

P.S., this isn’t necessary, as long as you build URLs correctly in your templates (absURL, .Permalink, etc.)

3 Likes

Thanks for the feedback @zwbetz. I’ve edited that section so it now says:

The slash ( / ) at the end of the baseURL can’t hurt and sometimes helps, so I recommend that you include it.

I also made a bunch of other edits in my TGIH article. Feedback is always welcome!

2 Likes