Move to YAML for config, much easier to read and write. Got TOC hierarchy now working as expected. Other sections like goldmark and menu now make more sense too.

hugo.yaml

@@ -0,0 +1,186 @@
+# 2025-11-21 Changed to be YAML rather than TOML. Much easier to understand.
+
+### My Params ###
+
+baseURL: '/'
+languageCode: 'en-us'
+title: "Hyperling's Works"
+subtitle: "My recipes, blogposts, musings, and more."
+
+#paginate = 25
+paginate: 99999
+
+markup:
+  goldmark:
+    # Allow direct HTML.
+    renderer:
+      unsafe: true
+
+    # Prevent URLs from becoming links which open in the same tab.
+    extensions:
+      linkify: false
+
+  tableOfContents:
+    endLevel: 4
+    ordered: false
+    startLevel: 2
+
+### End My Params ###
+
+
+### Theme ###
+# Seems pretty good, just need to add more config params so it acts better.
+theme: "hello-friend-ng"
+
+# Main Documentation
+# https://github.com/rhazdon/hugo-theme-hello-friend-ng/blob/master/docs/config.md
+
+# Favicon documentation for this theme.
+# https://github.com/rhazdon/hugo-theme-hello-friend-ng/blob/master/docs/favicons.md
+# Generator
+# https://realfavicongenerator.net/your-favicon-is-ready
+
+## Theme Suggested Params ##
+# The parameters below were copied, modified, or inspired from:
+#   https://github.com/rhazdon/hugo-theme-hello-friend-ng?tab=readme-ov-file#how-to-configure
+params:
+  dateform        : "Jan 2, 2006"
+  dateformShort   : "Jan 2"
+  dateformNum     : "2006-01-02"
+  dateformNumTime : "2006-01-02 15:04"
+
+  # Subtitle for home
+  homeSubtitle: "Blogposts, recipes, musings, and more."
+
+  # Set disableReadOtherPosts to true in order to hide the links to other posts.
+  disableReadOtherPosts: false
+
+  # Enable sharing buttons, if you like
+  enableSharingButtons: false
+
+  # Show a global language switcher in the navigation bar
+  enableGlobalLanguageMenu: false
+
+  # Metadata mostly used in document's head
+  description: "Written works by Hyperling."
+  keywords: "homepage, blog, recipes, crafts, food, seasonings, woodworking, poetry, poems"
+  images: [""]
+
+  # My Custom Params #
+  authorBug: "Chad Michael \"Bug\" Greenwood"
+  authorHyperling: "Chad Michael \"Hyperling\" Greenwood"
+  authorHyperVegan: "Chad Michael \"HyperVegan\" Greenwood"
+  authorDefault: "Chad Michael Greenwood"
+  # End My Custom Params #
+
+taxonomies:
+    categories : "categories"
+    tags       : "tags"
+    series     : "series"
+
+languages:
+  en:
+    title: "Hyperling's Written Works"
+    keywords: ""
+    copyright: '<a href="https://creativecommons.org/licenses/by-nc/4.0/" target="_blank" rel="noopener">CC BY-NC 4.0</a>'
+    readOtherPosts: "Read other posts"
+
+    params:
+      #subtitle = "Blogposts, recipes, musings, and more."
+
+      logo:
+        logoText: "Hyperling's Works"
+        logoHomeLink: "/"
+      # or
+      #
+      # path = "/img/your-example-logo.svg"
+      # alt = "Your example logo alt text"
+
+#  [languages.es]
+#    title = "Hola Amigo!"
+#    keywords = ""
+#    copyright = '<a href="https://creativecommons.org/licenses/by-nc/4.0/" target="_blank" rel="noopener">CC BY-NC 4.0</a>'
+#    readOtherPosts = "Read other posts"
+
+# And you can even create generic menu
+menu:
+  main:
+  - identifier : "00-all"
+    name       : "All"
+    url        : "/posts"
+    weight     : 1
+
+  - identifier : "01-tags"
+    name       : "Tags"
+    url        : "/tags"
+    weight     : 1
+    parent     : "00-all"
+
+  - identifier : "02-cats"
+    name       : "Categories"
+    url        : "/categories"
+    weight     : 2
+    parent     : "00-all"
+
+  - identifier : "20-food"
+    name       : "Food"
+    url        : "/tags/food"
+    weight     : 2
+
+  - identifier : "30-crafts"
+    name       : "Crafts"
+    url        : "/tags/crafts"
+    weight     : 3
+
+#[[menu.main]]
+#  identifier = "50-blog"
+#  name       = "Blogposts"
+#  url        = "/tags/blog"
+#  weight     = 5
+
+  - identifier : "60-poetry"
+    name       : "Poetry"
+    url        : "/tags/poetry"
+    weight     : 6
+
+  - identifier : "70-tech"
+    name       : "Tech"
+    url        : "/tags/tech"
+    weight     : 7
+
+  - identifier : "80-books"
+    name       : "Books"
+    url        : "/tags/books" #"https://hyperling.com/books"
+    weight     : 8
+
+# End parameters related to:
+#   https://github.com/rhazdon/hugo-theme-hello-friend-ng?tab=readme-ov-file#how-to-configure
+##
+
+### End Theme ###
+
+
+### Failed Themes ###
+# Do not go back to these unless figuring out what was done wrong.
+
+# not functioning well
+#theme = "recipes"
+
+# requires creating recipe objects?
+#theme = "cookbook"
+
+# not showing index files
+#theme = "awesome"
+
+# outdated
+#theme = "simple-dark"
+
+# too complicated? Failing to compile.
+#theme = "congo"
+
+# works, reads index files, shows cool header at the beginning of posts,
+# but FAILS at monospace fonts in code blocks and CSS for URLs is horrible.
+# Could maybe be modified to serve well enough.
+#theme = "hugo-classic"
+
+### End Failed Themes ###

old-hugo.toml

@@ -1,3 +1,4 @@
+# Abandoned 2025-11-21 because it was not working as needed. Moved to YAML.
 
 ### My Params ###
 
@@ -15,9 +16,10 @@ markup.goldmark.renderer.unsafe = true
 # Prevent URLs from becoming links which open in the same tab.
 markup.goldmark.extensions.linkify = false
 
-#[markup.tableOfContents]
-#  startLevel = 2
-#  endLevel = 5
+[markup.tableOfContents]
+  endLevel = 4
+  ordered = false
+  startLevel = 2
 
 ### End My Params ###