Skip to content

Conversation

chalin
Copy link
Contributor

@chalin chalin commented Apr 23, 2025

  • Changes due to new template system introduced in Hugo v0.146.0
  • Fixes User guide: errors when running with latest hugo version 0.146.7 #2214
  • Renames the Docsy render-heading partial and it's heading self-link helper
  • Updates the User Guide accordingly
  • There are no changes to the generated UG pages, other than the specific doc updates -- which tells us that the renames were a clean refactoring
  • Updates the CHANGELOG
  • Does NOT update the Hugo version yet because doing so surfaces other issues, which I'll document separately

Copy link

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR renames the Docsy render-heading hook and associated heading self-link helper to enable a cleaner refactoring and update the relevant documentation.

  • Renames the partial from the old template naming to a new partial-based naming scheme.
  • Updates documentation and CHANGELOG to reflect these renames.

Reviewed Changes

Copilot reviewed 4 out of 5 changed files in this pull request and generated 1 comment.

File Description
userguide/layouts/_default/_markup/render-heading.html Updated to call the new partial "td/render-heading.html".
userguide/content/en/docs/adding-content/navigation.md Documentation changes to reflect the new partial names.
layouts/partials/td/render-heading.html Renamed partial invocation & definition for heading self-link.
CHANGELOG.md Updates reflecting the breaking changes in naming.
Files not reviewed (1)
  • userguide/static/refcache.json: Language not supported

@chalin chalin added user guide Improvements to user guide cleanup/refactoring labels Apr 23, 2025
@chalin chalin force-pushed the chalin-im-render-heading-2025-04-23 branch from 4f84770 to 05e8446 Compare April 24, 2025 12:03
@chalin chalin force-pushed the chalin-im-render-heading-2025-04-23 branch from 05e8446 to 66e8a56 Compare April 24, 2025 12:05
@chalin
Copy link
Contributor Author

chalin commented Apr 24, 2025

Merging. Feedback is still welcome.

@chalin chalin merged commit 343cdec into google:main Apr 24, 2025
11 checks passed
@chalin chalin deleted the chalin-im-render-heading-2025-04-23 branch April 24, 2025 12:14
@chalin
Copy link
Contributor Author

chalin commented Apr 24, 2025

@LisaFC
Copy link
Collaborator

LisaFC commented Apr 24, 2025

Looks much clearer, thanks!

fekete-robert pushed a commit to fekete-robert/docsy that referenced this pull request May 30, 2025
Yuan325 added a commit to googleapis/genai-toolbox that referenced this pull request Jun 4, 2025
There's a `no such template "_default/_markup/td-render-heading.html"`
error when running `hugo server` locally. This is due to a breaking
change in [Hugo
v0.146.0](https://github.com/gohugoio/hugo/releases/tag/v0.146.0). This
PR updates the render-heading file according to
google/docsy#2223.
github-actions bot pushed a commit to googleapis/genai-toolbox that referenced this pull request Jun 4, 2025
There's a `no such template "_default/_markup/td-render-heading.html"`
error when running `hugo server` locally. This is due to a breaking
change in [Hugo
v0.146.0](https://github.com/gohugoio/hugo/releases/tag/v0.146.0). This
PR updates the render-heading file according to
google/docsy#2223. 9ecf175
github-actions bot pushed a commit to renovate-bot/googleapis-_-genai-toolbox that referenced this pull request Jun 4, 2025
There's a `no such template "_default/_markup/td-render-heading.html"`
error when running `hugo server` locally. This is due to a breaking
change in [Hugo
v0.146.0](https://github.com/gohugoio/hugo/releases/tag/v0.146.0). This
PR updates the render-heading file according to
google/docsy#2223. 9ecf175
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
cleanup/refactoring user guide Improvements to user guide
Projects
None yet
Development

Successfully merging this pull request may close these issues.

User guide: errors when running with latest hugo version 0.146.7
2 participants