From 70048b3fb6ee3219bc56853a6fa7474ad9979df6 Mon Sep 17 00:00:00 2001 From: sneak Date: Sun, 9 Aug 2026 15:32:58 +0000 Subject: [PATCH] Disable unused taxonomy page kinds (closes #13) Hugo enables the `tags` and `categories` taxonomies by default. This site is a single page with no taxonomy terms and no taxonomy templates, so every build emitted WARN found no layout file for "html" for kind "taxonomy" and generated `categories/index.xml` and `tags/index.xml` that nothing links to. `disableKinds = ['taxonomy', 'term']` is the documented Hugo mechanism for a site that uses no taxonomies; it removes the warning at its source rather than suppressing it, and it does not create dead template files to satisfy the layout lookup. The premise was re-verified against hugo v0.164.0, the version now pinned in `script/bootstrap`, rather than trusted from the issue text, which was written when the build still used apk's 0.139.0. The warning and the unwanted pages are unchanged on v0.164.0. `make test`, `make lint` and `make check` now emit zero `WARN` lines, so the build's noise floor is zero and the next warning to appear will be visible instead of scrolling past. Rendered output is otherwise byte-identical: `index.html`, `css/style.css` and the RSS `index.xml` are unchanged, and `sitemap.xml` is still generated, now listing only the home page rather than two taxonomy URLs. --- TODO.md | 12 ++++++++++++ hugo.toml | 8 ++++++++ 2 files changed, 20 insertions(+) diff --git a/TODO.md b/TODO.md index 807288f..690d280 100644 --- a/TODO.md +++ b/TODO.md @@ -27,6 +27,18 @@ Update `README.md` accordingly. # Completed Steps +- 2026-08-09: disabled the unused `taxonomy` and `term` page kinds in + `hugo.toml` (closes #13). Hugo enables the `tags` and `categories` taxonomies + by default; this single-page site has no taxonomy terms and no taxonomy + templates, so every build emitted + `WARN found no layout file for "html" for kind "taxonomy"` and generated + `categories/index.xml` and `tags/index.xml` that nothing links to. Re-verified + the warning still occurs on the now-pinned hugo v0.164.0 rather than trusting + the issue's text, which predates the version move. `make test` and `make lint` + are now `WARN`-free, so the build's noise floor is zero and the next warning + will be visible. `public/` is otherwise byte-identical — `index.html`, + `css/style.css` and the RSS `index.xml` all unchanged — and `sitemap.xml` is + still generated, now listing only the home page instead of two taxonomy URLs - 2026-08-09: replaced `hugo.toml`'s deprecated `languageCode` key with `locale` (closes #18). Hugo deprecated `languageCode` in v0.158.0, so the Hugo pinned in the preceding commit warns about it; left alone it would become a third diff --git a/hugo.toml b/hugo.toml index 5a43c1b..bd36259 100644 --- a/hugo.toml +++ b/hugo.toml @@ -3,6 +3,14 @@ locale = 'en-us' title = 'LoRa Vegas — Las Vegas Meshtastic Community' theme = 'loravega' +# This is a single-page site with no taxonomy terms and no taxonomy +# templates. Hugo enables the `tags` and `categories` taxonomies by +# default, so without this it generates taxonomy list pages it has no +# layout for and warns on every build. The `sitemap` kind is left +# enabled: sitemap.xml is still generated, and now lists only the home +# page. +disableKinds = ['taxonomy', 'term'] + [markup.goldmark.renderer] unsafe = true -- 2.49.1