Refactor

• Refactor project card and single template.
• Reduce projectfrontmatter.

Refactor

• Replace justified gallery library with custom implementation, now supports justify, masonry and grid layout, and supports switching layout on the frontend.
• Replace Glightbox with photoswipe.
• Remove masonry shortcode.
• Refactor TOC, now supports top and side floating display.
• Refactor article cover, remove redundant placeholder logic.

Style

• Simplify some styles, remove redundant style files.
• Restore breadcrumb icons.

New Features

• New timeline layout, use h2 define time, use native markdown syntax.

New Features

• define main sections for search in hugo.yaml.

Refactor

• baseof template uses grid style when there is a sidebar
• REMOVE the series parameter
• REMOVE toc sideabr width parameter

New Features

• Notice template at homepage with i18n supported.
• Series post supported.

Bug Fixes

• Fix related posts counts parameter
• Fix comments parameter
• Fix header button overflow in some language

Features

• Add toggleable Table of Contents (enable via params.toc.enabled: true)
• Support custom head partials
• Add projects content support
• button & icon shortcodes

Button Shortcodes

1{\{< button text="Learn More" url="/about" >}\}
2{\{< button text="GitHub" url="https://github.com" icon="github" target="\_self" >}\}
3{\{< button text="Download" url="/download" variant="outline" size="lg" >}\}

Parameters:

• text: Button text (required, or use inner content)
• url: Link address (required)
• variant: primary, secondary, outline (default: primary)
• size: sm, md, lg (default: md)
• icon: Theme icon name
• target: _blank, _self (default: _blank)
• rel: Link relationship (noopener noreferrer is automatically added when _blank is used)

Icon Shortcodes

Display SVG icons from the ~/assets/icons/ directory:

1{\{< icon name="heart" >}\}
2{\{< icon name="github" size="lg" >}\}
3{\{< icon name="sun" class="text-primary" >}\}

Parameters:

• name: Icon name (required) - Check assets/icons/ for available icons or place custom icons in this directory, or place the custom icon in this directory
• size: xs, sm, md, lg, xl, 2xl (default: md)
• class: Custom CSS class, which can be used to change colors

Bug Fixes

• Remove redundant style files
• Adjust link class to fix unwanted element underlines

Breaking Changes

Some parameter levels have been adjusted and the TOC parameter has been added. The specific parameter changes are as follows:

 1- params:
 2-   logo:
 3-     image: ""
 4-     link: ""
 5-   stickyHeader: true
 6-   showThemeSwitch: true
 7-   showDarkModeSwitch: true
 8-   showLanguageSwitch: true
 9-   languageSwitchMode: "dropdown"
10+ params:
11+   header:
12+     sticky: true
13+     logo:
14+       image: ""
15+       link: ""
16+     showThemeSwitch: true
17+     showDarkMode: true
18+     showLanguageSwitch: true
19+     languageSwitchMode: "dropdown"
20+   toc:
21+     position: left # left | right | card
22+     maxWidth: "280px"
23+     maxHeight: "80vh"

New Features

• Supports sidebar table of contents (TOC).
• Initialize go.mod to support importing the theme via Hugo mod
• Support custom order for homepage sections

Refactors

• Split the example site configuration
• Adjust the parameter hierarchy of the header

Bug Fixes

• Icon templates now support solid icons without affecting references in the configuration file
• Adjust some style class names

New Features

• Homepage author information now supports i18n translation

• Added custom content template between homepage author information and recent posts

Bug Fixes

• Fixed incorrect parameter name for clarity in the site configuration file

New Features

• Open external links in new tabs.
• Support for custom JavaScript files.
• Add a 404 template.
• Add dock display mode parameters.

1params
2+  dock: float # Options: "scroll" (show on scroll up), "always" (always visible), "float" (floating)

Style

• Modify the color of superscripts and subscripts
• Adjust the bottom padding of alert blockquotes

Bug Fixes

• fix post card summary index order.
• fix reading progress and codeblock configuration.

New Features

• add language switch mode, new params params: languageSwitchMode, support dropdown and cycle options.

Style

• add license information at footer.

Bug Fixes

• Post cover placeholder not effect.
• regular page comments doesn’t display.
• License url too long to page overflow.

Style

• Codeblock plaintext style.
• Github Alert style.
• Post card style.
• Order list number color.
• Related post style minilize.
• Post navigation height.

Feature

• New About partials.
• New link shortcode.
• Improve search and TOC user experience.

Refactor

• Refactor CSS framework, delete @tailwindcss/typography dependency.

Bug Fixes

• Fixed frontmatter license params is not taking effect.

Style

• Image display center.

Breaking Changes

• license params add author and show params
• delete showLicense params

Bug Fixes

• Fixed masonry shortcode ID duplicate issue, causing style failure.
• Fixed glightbox and justified parameter settings not taking effect.

Styling Improvements

• Optimized link and footnote styles.
• Added scrollbar styles.
• Added theme colors from tweakcn .

This release refactor the configuration of gallery, add a shortcode of masonry gallery.

Breaking Changes

Gallery configuration structure has been updated. Please update your Hugo configuration.

Visit Release Notes .

New Features

• Masonry Gallery Shortcode: Added support for masonry/waterfall layout with the new {\{< masonry >}} shortcode

1{\{< masonry columns=4 gutter=15 >}\}
2![Image 1](image1.jpg)
3![Image 2](image2.jpg)
4{\{< /masonry >}\}

Improvements

• New Lightbox System: Migrated from lightGallery to GLightbox for improved performance and modern user experience
• Enhanced Justified Layout: Replaced jQuery-based justified gallery with flickr-justified-gallery for better native JavaScript support
• Removed jQuery Dependency: Complete elimination of jQuery from the gallery system, resulting in faster loading times and reduced bundle size

Bug Fixes

• Fixed i18n translation issues in post-meta component
• Resolved analytics template inclusion problem

This release introduces the gallery; additionally, booth maps are automatically generated for posts cover, and SEO metadata is rendered via Hugo’s native templates.

New Features

• Integrated Hugo’s built-in SEO templates
• Implemented gallery and justified gallery support
• Added customizable placeholder images for article covers

Improvements

• Removed redundant metadata fields
• Fixed article navigation descriptions in post pages