Changelog
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
timelinelayout, useh2define time, use native markdown syntax.
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
MARKDOWN
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" >}\}{\{< button text="Learn More" url="/about" >}\}
{\{< button text="GitHub" url="https://github.com" icon="github" target="\_self" >}\}
{\{< 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 nametarget:_blank,_self(default:_blank)rel: Link relationship (noopener noreferrer is automatically added when_blankis used)
Icon Shortcodes
Display SVG icons from the ~/assets/icons/ directory:
MARKDOWN
1{\{< icon name="heart" >}\}
2{\{< icon name="github" size="lg" >}\}
3{\{< icon name="sun" class="text-primary" >}\}{\{< icon name="heart" >}\}
{\{< icon name="github" size="lg" >}\}
{\{< icon name="sun" class="text-primary" >}\}
Parameters:
name: Icon name (required) - Checkassets/icons/for available icons or place custom icons in this directory, or place the custom icon in this directorysize: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:
DIFF
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"
- params:
- logo:
- image: ""
- link: ""
- stickyHeader: true
- showThemeSwitch: true
- showDarkModeSwitch: true
- showLanguageSwitch: true
- languageSwitchMode: "dropdown"
+ params:
+ header:
+ sticky: true
+ logo:
+ image: ""
+ link: ""
+ showThemeSwitch: true
+ showDarkMode: true
+ showLanguageSwitch: true
+ languageSwitchMode: "dropdown"
+ toc:
+ position: left # left | right | card
+ maxWidth: "280px"
+ 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
- Open external links in new tabs.
- Support for custom JavaScript files.
- Add a 404 template.
- Add dock display mode parameters.
DIFF
1params
2+ dock: float # Options: "scroll" (show on scroll up), "always" (always visible), "float" (floating)
params
+ 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
- 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
Aboutpartials. - New
linkshortcode. - Improve search and TOC user experience.
Refactor
- Refactor CSS framework, delete
@tailwindcss/typographydependency.
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
MARKDOWN
1{\{< masonry columns=4 gutter=15 >}\}
2
3
4{\{< /masonry >}\}{\{< masonry columns=4 gutter=15 >}\}


{\{< /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