File Reference Hierarchy | cliffmccarthy.net

Added February 1, 2024; last modified February 11, 2026

This is the relationship between files in the theme. This site has been de-themed, but some or all of this may still apply.

                                                              .-> layouts/partials/head/css.html --> assets/css/main.css
                              +-> layouts/partials/head.html -+
                              |                               '-> layouts/partials/head/js.html --> assets/js/main.js
                              |
layouts/_default/baseof.html -+-> layouts/partials/header.html --> layouts/partials/menu.html
                              |
                              +-> layouts/partials/footer.html

layouts/_default/home.html (right arrow on links)

layouts/_default/list.html (scroll on links)

layouts/_default/single.html --> layouts/partials/terms.html

layouts/pages/list.html (page icon on links) (added after creating theme)

content/_index.md

content/pages/_index.md (added after creating theme)

static/favicon.ico

GoAT information: https://gohugo.io/content-management/diagrams/

First-class concepts in Hugo

Hugo has built-in knowledge of specific categories of templates:

Base
Single page
Home page (is a Page)
List
Section (is a List)
Taxonomy (is a List)
- ’tags’ and ‘categories’ are auto-configured.
- They can be removed with disableKinds.
- https://gohugo.io/content-management/taxonomies/#add-taxonomies-to-content

“Section” divides its sub-items into groups, each in a single section. “Taxonomy” can have overlapping sub-items, with each appearing in multiple groups. A typical use case for this is tags.

RSS happens automagically?

page kind: A classification of pages, one of home, page, section, taxonomy, or term. Note that there are also RSS, sitemap, robotsTXT, and 404 page kinds, but these are only available during the rendering of each of these respective page’s kind and therefore not available in any of the Pages collections.

Markdown files

This describes how things worked before the site was de-themed.

The pages section gets its index text from local content, that shadows the index defined in the theme.
The posts section gets its index text from local content.

  themes/fromblank/content/_index.md --> public/index.html

[ themes/fromblank/content/pages/_index.md ]
             |
             '---- content/pages/_index.md --> public/pages/index.html

                   content/pages/useful-links/index.md --> public/pages/useful-links/index.html

                   content/posts/_index.md --> public/posts/index.html

Tags:

Hugo SSG