Skip to content

Upgrade Docsy to 0.13.0 and Hugo to 0.152.2 #4395

@markmandel

Description

@markmandel

Description
The Docsy theme has released version 0.13.0, which includes highly requested features like active Table of Contents (TOC) tracking, accessibility improvements, and better dark mode support. It's not totally necessary to upgrade, but there are some nice things in there that would be useful.

Proposed Changes

  1. Dependency Updates:
  • Update Docsy to v0.13.0.
  • Update Hugo to v0.152.2 (required for Docsy 0.13 compatibility).
  • Update Node.js to LTS 24 (recommended for this release).
  • Update Bootstrap to 5.3.8 (bundled with Docsy).
  1. Breaking Changes & UX Fixes:
  • Language Menu: Docsy 0.13.0 now shows the language menu in the navbar for all viewport widths and hides it from the sidebar by default. This shouldn't affect us, as we don't show it.
  • Alert Shortcodes: The {{% alert %}} shortcode now processes Markdown differently (passing it to the page renderer). We should verify that existing alerts in our documentation still render correctly.
  1. New Features to Verify:
  • Active TOC Tracking: Ensure the new "On this page" highlighting works correctly with our documentation structure.
  • Mobile Navbar: Verify the new scroll indicators for overflowing menus on mobile viewports.
  • Dark Mode: Check for any regressions in our custom styling with the new dark mode accessibility fixes.

Additional Context

Task Checklist

  • Update site/themes/docsy submodule or npm dependency to v0.13.0.
  • Update Hugo version in build/build-image/Dockerfile (or relevant CI config).
  • Test local site generation with make site-server.
  • Verify {{% alert %}} shortcode rendering across docs.
  • Audit sidebar/navbar language selector visibility.
  • Run make hugo-test to ensure no broken links or rendering errors.

Metadata

Metadata

Labels

area/build-toolsDevelopment tooling. I.e. pretty much everything in the `build` directory.area/siteThe website itself - including redirects, styling, search, etckind/featureNew features for Agones

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions