Skip to content

Upgrade Hugo to 0.169.0 and PaperMod to 1181196 - #4

Open
danielwagn3r wants to merge 10 commits into
mainfrom
feature/upgrade-hugo-papermod
Open

danielwagn3r wants to merge 10 commits into
mainfrom
feature/upgrade-hugo-papermod

Conversation

@danielwagn3r

Copy link
Copy Markdown
Member

Upgrades Hugo from 0.122.0 to 0.169.0 and PaperMod from v8.0 to master commit 1181196.

PaperMod hasn't had a release since v8.0 (Nov 2024). 1181196 is the commit its demo site currently runs. Current master needs Hugo ≥ 0.158, and v8.0 no longer builds on current Hugo, so both have to be upgraded together. The commits are split up for review; the site builds again from "Fix site templates for Hugo 0.169" onwards.

Changes

  • Config:
    • languageCode → locale, paginate → pagination.pagerSize.
    • capitalizeListTitles: false, so tag and category names stay lower case.
    • Google Analytics is disabled through privacy.googleAnalytics instead of a copied head.html.
    • minifyOutput: false is removed. On Hugo 0.169 it overrides --minify, which would stop the deployed site from being minified.
  • Layouts:
    • Moved to _partials/ and _shortcodes/. That commit contains only renames.
    • Removed .Site.GoogleAnalytics and .Site.Data (both gone from current Hugo) and the partials/ prefix in partial names.
    • footer.html and index_profile.html now start from the new theme's versions, with the site's changes put back.
  • CSS: the project's copy of profile-mode.css (PaperMod v7.0's file) is replaced by upstream's, plus a small override that keeps the CoderDojo logos square and side by side.
  • Cleanup: removed coderdojo_austria.html, which nothing used, and its stylesheet.
  • Tooling:
    • Compose and AGENTS.md now use ghcr.io/gohugoio/hugo, because the hugomods/hugo images stop at 0.154.5.
    • CI runs on ubuntu-24.04 with actions/checkout@v7.

Testing

I compared a local build of main (Hugo 0.122) with this branch (Hugo 0.169).

  • Output files: the same set of files, apart from the hashed CSS/JS asset names.
  • Page text: the same on every page.
  • Homepage: checked with screenshots at 1280 px and 400 px wide.
  • Build log: no errors and no deprecation warnings.

Visible differences

  • Event months show "Jänner" instead of "Januar", because of the de-at locale.
  • Breadcrumbs use a chevron icon instead of "»".
  • Automatic summaries on list pages are a little longer.
  • Reading-time and word-count numbers differ slightly.
  • The profile logos and buttons are a little further apart (upstream's spacing).

Known warning

"Raw HTML omitted" for a <br/> in content/infos/eltern/index.md. The old build already dropped it, just without a warning, so the page is unchanged.

🤖 Generated with Claude Code

danielwagn3r and others added 10 commits October 30, 2026 17:27
PaperMod has had no release since v8.0 (Nov 2024); pin the master commit
that the official demo site currently deploys. It requires Hugo >= 0.158.0.
The site builds again once the following commits are applied.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- languageCode -> locale, paginate -> pagination.pagerSize
- capitalizeListTitles: false keeps taxonomy terms lower case; the new
  _index.md files keep the Posts/Tags/Categories headings capitalised
- privacy.googleAnalytics.disable replaces the head.html override that
  commented out the built-in GA template
- drop minifyOutput: false, which now overrides --minify in CI

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Hugo's current layout directories, also used by PaperMod. Contents unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- partial names without the partials/ prefix
- .Site.GoogleAnalytics -> .Site.Config.Services.GoogleAnalytics.ID
- .Site.Data -> hugo.Data

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
footer.html and index_profile.html start from the theme's current versions
with the site's changes re-applied (copyright always shown, Impressum link;
sub-images, events and CoderDojo International sections). The head.html
override is removed; GA is disabled through config instead.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Nothing includes the partial, and the stylesheet only styled its section.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
hugomods/hugo images stop at 0.154.5. ghcr.io/gohugoio/hugo is the extended
edition, pinned to HUGO_VERSION; its entrypoint is hugo.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
peaceiris/actions-hugo@v3 and actions-gh-pages@v4 are already the latest majors.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Drop the project copy, which was PaperMod v7.0's file with the image
border-radius commented out.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Minimal override on top of upstream profile-mode.css: the CoderDojo logos
are not cropped to a circle and stay in one row.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant