Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog and this project adheres to Semantic Versioning .
[Unreleased]
[3.19.1] - 2026-11-13
Fixed
- Keep homepage post cards visible in responsive rows when the masonry layout scripts fail to load.
- Let readers flip the legacy About view with Enter or Space from the desktop and mobile navigation. Tab moves through the visible side only.
- Reserve space for local and default summary covers in both the standard layout and Zen Mode to reduce layout shifts as images load.
[3.19.0] - 2026-11-12
Added
- Publish a standalone About page at
/about/. To switch from a headless About page, removeheadless: truefromcontent/about/index.mdand add a title and description. The existing Disqus discussion moves from the flippable view to the standalone page. - Set
hideAuthorInSummaryto hide the author name and avatar on post summary cards while keeping the reading time visible.
Changed
- Add breadcrumbs to category and tag pages, and move category and tag links above the post grid on their overview pages.
- The avatar flips with the page and can be activated with a keyboard. When reduced motion is enabled, page flips and scrolling skip their animations.
- Upgrade browser dependencies, including Mermaid 12, MathJax 4, and the Twikoo 2 client.
Fixed
- Fix the menu styling of nested entries in the table of contents.
- Use the URL of the current page in search and social metadata for paginated home, category, and tag listings. Tell search engines to skip the site’s built-in search page.
- Restore search on the Dream documentation site.
[3.18.0] - 2026-11-11
Changed
- Load Utterances only in Hugo’s production environment. To preview it locally, run
hugo server --environment production. - Let the site’s Disqus settings control whether ads appear.
- Reduce vertical spacing around the previous and next post links.
Fixed
- Preserve manual light and dark mode selections when the system color scheme changes.
- Keep custom code highlighting in sync with automatic theme changes and allow theme switching when custom highlighting is disabled.
- Sync Disqus and Utterances with the site’s light and dark modes, including when Utterances loads late.
- Honor custom navigation order and collapse settings on desktop and mobile.
- Link to the current language’s homepage from the site title and the 404 page.
- Include posts in nested sections on the archives page.
- Preserve special characters in math code blocks and in shared post titles and links.
- Resolve relative paths for bundled images when content appears outside its source page.
- Convert summary covers to WebP at their original size and keep unsupported image formats as-is.
[3.17.0] - 2026-08-02
Changed
- Update all i18n files by GPT 5.6 Sol High
- AI may make mistakes. If you find any problems, please open an issue to tell me. Thank you!
[3.16.1] - 2026-07-20
Changed
- Update search keys to include
descriptionorsummary
Fixed
- Prevent TOC from overlapping the article #412
[3.16.0] - 2026-07-13
Added
- Add optional pan and zoom controls for Mermaid diagrams with a reset button #410
Changed
- Update cdn dependencies to the latest version
Fixed
- Remove the extra space at the end of markdown links
- Allow links in the summary #409
[3.15.0] - 2026-04-30
Changed
- Add
data-nosnippetattribute to flippable about page other than home to prevent search engines from showing it as a snippet in search results
Deprecated
- Replace
languageCodewithlocale, see Base Configurations for more details.
Fixed
- The global background image is not shown in dark mode when
backgroundImageDarkis set - The styles of comment systems are no longer affected by theme styles
- Update footer to adapt to mobile layout
[3.14.0] - 2026-02-08
Added
- Support image title as https://gohugo.io/render-hooks/images/ describes
Changed
- Optimize browser compatibility of toc and achieve smooth scrolling
[3.13.0] - 2025-09-08
Added
- Mathematics enhancements #387
- Support
$delimiter for inline math - Support
math: truepage param for whole page math rendering
- Support
- Add
covercaptionpage param to display a caption for the cover image in the single post page (you need to setshowSummaryCoverInPosttotruefirst)
Fixed
- Fix the integrity issue of jsdelivr alpinejs
[3.12.0] - 2025-04-09
Added
- Highlight toc items when scrolling #383
Changed
- Upgrade to tailwindcss v4 and daisyUI v5 #374
Fixed
[3.11.0] - 2025-03-04
Added
- Add Google AdSense support #363
Changed
- Remove author display if both post author and site author are not set #354
- Prioritize page descriptions over page summaries #356
- Allow favicon to be specified in text format
- Support Twikoo comment system #359
- Allow specifying
aboutinreorderNavItems#371
Fixed
- Fix the background and z-index problem of the zoomable image
- Optimize layout shifts when the homepage loads #364
- Disable Disqus ads
[3.10.0] - 2025-01-07
Added
- Add
imageZoomableInPostparam to control the zoomable of images in the single post page #345 - Support mathematical equations and expressions by using MathJax #350
Changed
- Make TOC scrollable when it is too long #340
- Bump Mermaid version to 11.4.1
- Now external links will open in a new tab by default
Fixed
- Fix Disqus styling issues
- Add background color to the dark mode switch button
[3.9.0] - 2024-11-17
Added
- Now you can group posts with any layout in archives page, see custom group layout for more details
Changed
- Append global page footer on about page #329
Fixed
[3.8.2] - 2024-09-25
Added
- Now you can share your post to WhatsApp #317
- Add
reorderSharesparam #320 - Add a slot for Google AdSense on the post page, view this issue for more details
Changed
- Rename
updateAttoupdatedAtin i18n files
Fixed
- Tweak English translations for
minuteReadandupdateAt#323
[3.8.1] - 2024-09-08
Fixed
- Fix the cache issue of
commentSystems.html - Add missing “about” translation to the Italian language file
[3.8.0] - 2024-09-07
Added
Changed
- Upgrade Hugo minimum version to 0.97.0
Deprecated
- Deprecate
VALINE_LANGUAGEparam #309
[3.7.0] - 2024-08-29
Added
- Add Mermaid diagrams support #307
- Add GitHub Alerts Markdown extension compatible alerts #308
Fixed
- Fix image size of summary cards in Zen mode
[3.6.1] - 2024-08-25
Fixed
- Render SVG images in summary
- Incorrect use of the
_internal/schema.htmltemplate #306 - Remove shortcut link type in favicon
[3.6.0] - 2024-08-24
Added
- Add
noDefaultSummaryCoverparam #301
Changed
Deprecated
- Deprecate
hasTwitterEmbedparam #302
[3.5.0] - 2024-08-19
🍃 Hugo Theme Dream 3.5 introduces Zen mode. View Zen Mode for more details.
Added
- Zen mode: a simple layout that allows you to concentrate on reading and writing #299
Changed
- Now taxonomy pages follow the same layout as the home page
Deprecated
- If you still use
disqusShortname, please replace it withservices.disqus.shortname
Fixed
- Fix height of
.flip-containerclass - Fix tabindex issue in nav menu
[3.4.1] - 2024-08-14
Added
- Allow text-based custom nav items
Changed
- Refactor the implementation of localized time #298
[3.4.0] - 2024-08-10
Added
- Add
reorderNavItemsandcollapseNavItemsparams to reorder and collapse navigation items - Add
[params.navItems]to append custom items to the navbar
Changed
- Minimalize the theme css
Fixed
- Add missing descriptive attributes in some elements
[3.3.0] - 2024-08-01
Added
- Support arbitrary taxonomies #292
Fixed
- Fix the overflow problem of pre’s content
- Fix an overflow problem when users enable always show scroll bars in the system settings
- Resources accessibility when deploying site to a subdomain #295
[3.2.0] - 2024-07-25
Added
- Add
showPrevNextPostparam to control the display of previous and next post links in the single post page - Add
showTableOfContentsparam to control the display of the table of contents in the single post page
[3.1.1] - 2024-07-23
Changed
- Adjust shadow style of navbar
- Now if a paginator has only one page, the previous and next buttons will be hidden
Fixed
- Correct the usage of semantic elements in
baseof.htmlandsingle.html
[3.1.0] - 2024-07-18
Added
- Support image optimization for summary images. See Image Optimization for more details
Changed
- Upgrade
imagesloadedto5.0.0
Fixed
- Fix the problem of misaligned images during initial loading
[3.0.1] - 2024-07-12
Fixed
- Add WAI-ARIA roles to some non-semantic elements
- Fix mobile layout in term.html
- Add mobile display for nav right section
[3.0.0] - 2024-07-09
🎉 Hugo Theme Dream 3.0 is released.
See the migration guide for more details.
Last updated on