v0.14.0

[chalin]

Release summary

• Release 0.14.0 report and upgrade guide
• Changelog v0.14.0 entry

What's Changed

• Update changelog anchors, release process docs, and vers to 0.13.1-dev by @chalin in Update changelog anchors, release process docs, and vers to 0.13.1-dev #2415
• docsy.dev: set to_year to "present", and shortcode cleanup by @chalin in docsy.dev: set to_year to "present", and shortcode cleanup #2427
• Update all packages other than Hugo by @chalin in Update all packages other than Hugo #2428
• Upgrade Hugo to 0.154.3 by @chalin in Upgrade Hugo to 0.154.3 #2430
• Update Hugo to 0.154.5 by @chalin in Update Hugo to 0.154.5 #2432
• chore: complete German localization by @deining in chore: complete German localization #2435
• Update alias format in get started page so it works as a fallback too by @chalin in Update alias format in get started page so it works as a fallback too #2434
• i18n: zh_cn and zh_tw by @wlbksy in i18n: zh_cn and zh_tw #2419
• Update Serbian (cyrillic & latin) by @rammba in Update Serbian (cyrillic & latin) #2425
• [CI] Move Netlify config to docsy.dev subrepo by @chalin in [CI] Move Netlify config to docsy.dev subrepo #2437
• [CI] Drop temp site-copy code and more by @chalin in [CI] Drop temp site-copy code and more #2439
• Update README, contrib docs for deployment and release process by @chalin in Update README, contrib docs for deployment and release process #2440
• Add version to docs index page, bump version to 0.14.0-dev by @chalin in Add version to docs index page, bump version to 0.14.0-dev #2441
• Add docs version as a badge by @chalin in Add docs version as a badge #2442
• Add Hugo Markdown-style alert support and docs by @chalin in Add Hugo Markdown-style alert support and docs #2443
• Add missing feedback and Table of contents section in Bangla by @badhon495 in Add missing feedback and Table of contents section in Bangla #2416
• Add site build info and project build documentation by @chalin in Add site build info and project build documentation #2444
• chore: Rename 'site' docs section to 'project' and update links, and add task plan by @chalin in chore: Rename 'site' docs section to 'project' and update links, and add task plan #2445
• Add AGENTS.md, move a few project pages to be under About section by @chalin in Add AGENTS.md, move a few project pages to be under About section #2446
• Migrate i18n files from TOML to YAML and add conversion scripts by @chalin in Migrate i18n files from TOML to YAML and add conversion scripts #2447
• Add alert labels to selected i18n files by @chalin in Add alert labels to selected i18n files #2450
• Add support for custom attributes in blockquote alerts by @chalin in Add support for custom attributes in blockquote alerts #2452
• Fix left sidebar height by @chalin in Fix left sidebar height #2453
• Convert i18n/uk.toml to .yaml by @chalin in Convert i18n/uk.toml to .yaml #2454
• Delete i18n/uk.toml since we have a .yaml format now by @chalin in Delete i18n/uk.toml since we have a .yaml format now #2455
• Preliminary tasks, plan, and draft blog post for 0.14.0 by @chalin in Preliminary tasks, plan, and draft blog post for 0.14.0 #2456
• Convert most shortcode alerts to markdown, and more by @chalin in Convert most shortcode alerts to markdown, and more #2457
• Convert Bengali translations from TOML to YAML by @chalin in Convert Bengali translations from TOML to YAML #2458
• Add Bengali translations for alert labels by @chalin in Add Bengali translations for alert labels #2459
• Address Hugo deprecation msg related to mounts by @chalin in Address Hugo deprecation msg related to mounts #2460
• Convert Chinese i18n files from TOML to YAML by @chalin in Convert Chinese i18n files from TOML to YAML #2461
• Convert Japanese translations from TOML to YAML by @chalin in Convert Japanese translations from TOML to YAML #2463
• Add alert labels and all-rights-reserved in Japanese by @chalin in Add alert labels and all-rights-reserved in Japanese #2464
• Fix broken link to render-passthrough.html, dump tool versions by @deining in Fix broken link to render-passthrough.html, dump tool versions #2438
• Add alert label translations for zh-cn and zh-tw by @chalin in Add alert label translations for zh-cn and zh-tw #2462
• Create he.toml for Hebrew by @UrielOfir in Create he.toml for Hebrew #2272
• Convert Hebrew translation file to YAML by @chalin in Convert Hebrew translation file to YAML #2466
• Add alert and table of contents labels to Hebrew i18n by @chalin in Add alert and table of contents labels to Hebrew i18n #2467
• Convert all remaining i18n files to YAML, add helper scripts by @chalin in Convert all remaining i18n files to YAML, add helper scripts #2468
• Move internal SCSS files into Docsy-specific subdirectory by @chalin in Move internal SCSS files into Docsy-specific subdirectory #2469
• Update Swagger UI customization instructions by @chalin in Update Swagger UI customization instructions #2473
• Add nested sidebar_root_for to docs by @chalin in Add nested sidebar_root_for to docs #2476
• bugfix: nested sidebar_root_for by @reidmv in bugfix: nested sidebar_root_for #2470
• Update 0.14.0 release docs with i18n and SCSS changes by @chalin in Update 0.14.0 release docs with i18n and SCSS changes #2471
• Navbar styling fixes and updated documentation by @chalin in Navbar styling fixes and updated documentation #2477
• Update 0.14.0 release notes and changelog details by @chalin in Update 0.14.0 release notes and changelog details #2478
• Add read-only contents permission to workflows by @chalin in Add read-only contents permission to workflows #2479
• Refactor blocks/cover and pageinfo shortcodes by @chalin in Refactor blocks/cover and pageinfo shortcodes #2480
• KaTeX use: move media type declaration to theme's config file by @deining in KaTeX use: move media type declaration to theme's config file #2465
• docsy.dev: minor reorg and refactor SCSS by @chalin in docsy.dev: minor reorg and refactor SCSS #2481
• Update devDeps, incl. Hugo to 0.155.0 by @chalin in Update devDeps, incl. Hugo to 0.155.0 #2486
• docsy.dev config: switch to using sites.matrix by @chalin in docsy.dev config: switch to using sites.matrix #2487
• Reformat and clarify Docsy 'Get Started' pages by @chalin in Reformat and clarify Docsy 'Get Started' pages #2488
• Refactor navbar and layout SCSS, update examples by @chalin in Refactor navbar and layout SCSS, update examples #2489
• Add new Norwegian translations for UI and alerts by @chalin in Add new Norwegian translations for UI and alerts #2490
• Refactor extra and footer SCSS, add footer border by @chalin in Refactor extra and footer SCSS, add footer border #2491
• chore(hugo.yaml): cleanup config and add some explanation by @chalin in chore(hugo.yaml): cleanup config and add some explanation #2494
• Fix grammatical error in Norwegian translation by @chalin in Fix grammatical error in Norwegian translation #2498
• Use "front matter" rather than "frontmatter" by @tcrouch in Use "front matter" rather than "frontmatter" #2483
• Update 0.14 release notes, Hugo upgrade guide, style adjustments, and more by @chalin in Update 0.14 release notes, Hugo upgrade guide, style adjustments, and more #2502
• fix: only set td-sidebar-root-up-icon for links that are the tree root by @adlerzei in fix: only set td-sidebar-root-up-icon for links that are the tree root #2495
• Reorganize SCSS, fix scroll padding, normalize blocks-shortcode heading IDs and keep old IDs as alias by @chalin in Reorganize SCSS, fix scroll padding, normalize blocks-shortcode heading IDs and keep old IDs as alias #2505
• Document heading aliases and in-page targets by @chalin in Document heading aliases and in-page targets #2506
• Improve 0.14.0 upgrade action-step guidance by @chalin in Improve 0.14.0 upgrade action-step guidance #2508
• Refactor navbar vars, anchors, and cover styles; update blog & CL by @chalin in Refactor navbar vars, anchors, and cover styles; update blog & CL #2509
• Update NPM packages, Hugo to 0.155.2 by @chalin in Update NPM packages, Hugo to 0.155.2 #2511
• Rework Hugo upgrade post to make actions clearer by @chalin in Rework Hugo upgrade post to make actions clearer #2512
• Adjust Hugo 0.152-0.155 upgrade guide title to better match new org by @chalin in Adjust Hugo 0.152-0.155 upgrade guide title to better match new org #2513
• Update Serbian (cyrillic & latin) by @rammba in Update Serbian (cyrillic & latin) #2510
• Add extra styles for cover CTA/layouts and update 0.14.0 blog post by @chalin in Add extra styles for cover CTA/layouts and update 0.14.0 blog post #2514
• Adjust ToC and main layout breakpoints under td-no-left-sidebar by @chalin in Adjust ToC and main layout breakpoints under td-no-left-sidebar #2515
• Fix typos, remove duplicate paragraph, and other copyedits by @tcrouch in Fix typos, remove duplicate paragraph, and other copyedits #2507
• Centralize btn-lg helper to Hugo params, use anchors not buttons by @chalin in Centralize btn-lg helper to Hugo params, use anchors not buttons #2517
• Refresh refache, fix links, add local card images, and more by @chalin in Refresh refache, fix links, add local card images, and more #2518
• Opt-in dark navbar link contrast via homepage body_class by @chalin in Opt-in dark navbar link contrast via homepage body_class #2519
• Add td-navbar-links-all-active to list of experimental styles in 0.14.0 blog post by @chalin in Add td-navbar-links-all-active to list of experimental styles in 0.14.0 blog post #2520
• Style adjustments and new bs-defaults.scss partial by @chalin in Style adjustments and new bs-defaults.scss partial #2521
• Add dark overlay styles for GCS modal by @chalin in Add dark overlay styles for GCS modal #2524
• Fix toc position on desktop, and left sidenav + main layout on tablet by @chalin in Fix toc position on desktop, and left sidenav + main layout on tablet #2525
• Factor sidebar-toc styles, and 0.13.0 + 0.14.0 blog post improvements by @chalin in Factor sidebar-toc styles, and 0.13.0 + 0.14.0 blog post improvements #2527
• Adjust navbar heights and main-container layout by @chalin in Adjust navbar heights and main-container layout #2528
• Fix links in repository CHANGELOG.md & CONTRIBUTING.md by @rammba in Fix links in repository CHANGELOG.md & CONTRIBUTING.md #2516
• Upgrade GitHub Actions for Node 24 compatibility by @salmanmkc in Upgrade GitHub Actions for Node 24 compatibility #2526
• Promote examples page to navbar, rework CTA, hero images, and more by @chalin in Promote examples page to navbar, rework CTA, hero images, and more #2530
• Add cards with thumbnails to examples page, upgrade Hugo to 0.155.3 by @chalin in Add cards with thumbnails to examples page, upgrade Hugo to 0.155.3 #2531
• Add RTL fixes for code blocks and foldable-nav icons by @chalin in Add RTL fixes for code blocks and foldable-nav icons #2533
• Release 0.14.0 preparation by @chalin in Release 0.14.0 preparation #2534

New Contributors

• @wlbksy made their first contribution in i18n: zh_cn and zh_tw #2419
• @badhon495 made their first contribution in Add missing feedback and Table of contents section in Bangla #2416
• @UrielOfir made their first contribution in Create he.toml for Hebrew #2272
• @reidmv made their first contribution in bugfix: nested sidebar_root_for #2470
• @tcrouch made their first contribution in Use "front matter" rather than "frontmatter" #2483
• @adlerzei made their first contribution in fix: only set td-sidebar-root-up-icon for links that are the tree root #2495
• @salmanmkc made their first contribution in Upgrade GitHub Actions for Node 24 compatibility #2526

Full Changelog: v0.13.0...v0.14.0

---

This discussion was created from the release v0.14.0.

[hurrellit]

Thanks for your work @chalin.

A heads up for others: I had been using a .png formatted featured_background image file in my "home" page. On upgrade to Docsy 0.14.x, I received this error when building the project:

ERROR error building site: "/opt/buildhome/repo/content/en/_index.md:6:1": failed to render shortcode "blocks/cover": failed to process shortcode: "/opt/buildhome/.cache/hugo_cache/modules/filecache/modules/pkg/mod/github.com/google/docsy@v0.14.3/layouts/_shortcodes/blocks/cover.html:14:26": execute of template failed: template: _shortcodes/blocks/cover.html:14:26: executing "_shortcodes/blocks/cover.html" at <.Fill>: error calling Fill: failed to fill image "/opt/buildhome/repo/content/en/featured_background.png": fill /featured_background.png: image: unknown format

The fix was simple: just convert the image to .jpg. Not sure what had changed to cause this. I'm building on Cloudflare Pages with Hugo 0.155.0 + Docsy 0.14.3 (but also occurred in 0.14.0).

[chalin]

Hi @hurrellit - late to circling back, but I wanted to thank you for sharing that. I suspect that it is due to a Hugo upgrade, possibly hitting this issue:

• image: unknown format (PNG, cached) gohugoio/hugo#14295