Disable unused taxonomy page kinds (closes #13)
All checks were successful
check / check (push) Successful in 17s
All checks were successful
check / check (push) Successful in 17s
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.
This commit is contained in:
12
TODO.md
12
TODO.md
@@ -27,6 +27,18 @@ Update `README.md` accordingly.
|
|||||||
|
|
||||||
# Completed Steps
|
# 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`
|
- 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
|
(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
|
in the preceding commit warns about it; left alone it would become a third
|
||||||
|
|||||||
@@ -3,6 +3,14 @@ locale = 'en-us'
|
|||||||
title = 'LoRa Vegas — Las Vegas Meshtastic Community'
|
title = 'LoRa Vegas — Las Vegas Meshtastic Community'
|
||||||
theme = 'loravega'
|
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]
|
[markup.goldmark.renderer]
|
||||||
unsafe = true
|
unsafe = true
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user