Releases: HugoBlox/hugo-blox-builder
modules/wowchemy/v5.7.0
A BIG shoutout to all the sponsors and contributors who supported this release 🙌🏻
Help us improve. As privacy-focused software, we don't know what features are important to you. Take the feedback survey if you haven't already: https://forms.gle/bVyDCjSpYDPPqYJH9
Have an improvement for the docs? We've started migrated docs into this repo. Edit docs pages here https://github.com/wowchemy/wowchemy-hugo-themes/tree/main/docs or open an issue with your improved text for a page.
What's Changed (highlights)
Check out the demos of the updated starter templates or Discord Announcement channel for more visual examples of these incredible improvements 🦄
The Second Brain and Markdown Slides starter templates have so far been updated for this shiny new release of the Wowchemy website building framework for Hugo: https://github.com/wowchemy/wowchemy-hugo-themes/tree/main/starters
feat: add support for mindmaps
https://discord.com/channels/722225264733716590/738922126966521907/1015587595838836758
feat: add support for more complex filters in Portfolio widget
See https://isotope.metafizzy.co/filtering.html
E.g. filter on multiple tags:
filter_button:
- name: All
tag: '*'
- name: Machine Learning
tag: ML
- name: Computer Vision
tag: CV
- name: NLP
tag: NLP
- name: CV or NLP
filter: '.js-id-cv, .js-id-nlp'
- name: ML and NLP
filter: '.js-id-ml.js-id-nlp'
feat: add page feedback widget
See https://discord.com/channels/722225264733716590/738922126966521907/1015585595843674223
Requires Google Analytics and production env. New front-matter param for Book layout: feedback: true
feat: load featured image from media library (#2799)
Adds support for loading featured image from media library via image.filename
param as an alternative to placing a featured.*
image in the page folder.
Supports setting a default feature image for all pages via Hugo Cascade in Hugo Config.
Supports featured image reuse without duplicating the image within each page folder.
feat: add support for Algolia Docsearch
In params.yaml:
search:
provider: docsearch
docsearch:
app_id: ''
api_key: ''
index_name: ''
feat: add Announcement Bar feature
In front matter:
announcement:
text: 'Hello World!️'
feat: add support for different Footer Widgets
For example, params.yaml:
footer:
widget: mega
loads layouts/partials/components/footers/mega.html
feat: add GitHub Discussions as a comment provider via Giscus
See #2830
Templates:
- Renamed the Notes template to Second Brain
Hugo Compatibility
- Tested with Hugo Extended 0.101.0 (recommended)
Breaking Changes
Join us on Discord for help upgrading a site.
- Rename
.Params.cover
to.Params.image
and.Params.cover.image
to.Params.image.filename
(mainly if you are using the Notes template) - The Slides plugin (aka Reveal.JS plugin) now lives in its own module so it can be used without the
Wowchemy
Bootstrap UI module
If your site uses the slides plugin to create Markdown slide decks, install the plugin in your config.yaml
:
module:
imports:
- path: github.com/wowchemy/wowchemy-hugo-themes/modules/wowchemy-plugin-reveal
Want to join these contributors and add open source to your CV? Contribute an improvement: https://github.com/wowchemy/wowchemy-hugo-themes/blob/main/CONTRIBUTING.md
i18n
- Update it.yaml by @StefanoCecere in #2803
- Bengali (Bangladesh, India) language pack by @anirbanbasu in #2802
- Lang pack for Malay (Roman & Jawi) by @niskala5570 in #2808
Improvements by the community include:
- fix: Mermaid diagram rendering in Reveal slides by @malmarz in #2765
- Flexible featured image name by @Agos95 in #2799
- Implemented Giscus commenting module and modified params.yaml for all starters by @wehs7661 in #2830
- Migration from PyYAML to Ruamel by @Agos95 in #2831
- fix: encoding of quotes in Page Sharer URL See #2726
New Contributors
- @lioutikov made their first contribution in #2779
- @malmarz made their first contribution in #2765
- @anirbanbasu made their first contribution in #2802
- @Agos95 made their first contribution in #2796
- @niskala5570 made their first contribution in #2808
- @wehs7661 made their first contribution in #2830
Full Changelog: modules/wowchemy/v5.6.0...modules/wowchemy/v5.7.0
modules/wowchemy/v5.6.0
A BIG shoutout to all the sponsors and contributors who supported this release 🙌🏻
What's Changed (highlights)
Check out the demos of the updated starter templates or Discord Announcement channel for more visual examples of these incredible improvements 🦄
The starter templates have all been updated for this shiny new release of the Wowchemy website building framework for Hugo: https://github.com/wowchemy/wowchemy-hugo-themes/tree/modules/wowchemy/v5.6.0/starters
- Re-designed Gallery shortcode creates a more consistent and beautiful grid of images
- feat: migrate from Highlight.js to Hugo's built-in syntax highlighter
Increases site performance and privacy, simplifies dependencies, and aligns with Hugo best practices. - Add Copy button to code blocks to enable users to easily copy and paste code in your tutorials, blog posts, etc.
- feat: add Cover image option to Book layout
- For Book layout, automatically-list child pages on chapter pages
- Add Slider background fit option to cover or contain image by @dbkchu in #2715
- feat: re-add link option to figures to open a link when clicking image
- feat(portfolio): add Portfolio widget filters for exclude_tags and page kind
Experimental Portfolio widget support for:content.filters.exclude_tags
andcontent.filters.kinds
(filter by Hugo's page kinds) - feat: support tooltip and PDF in new tab in about.avatar widget
- fix: post list duplicated on project page by @amistyrain in #2682
Templates:
- Added a Second Brain (Notes) template to enable you to create a private or public second-brain - integrates with second-brain apps such as Obsidian
- Re-designed Minimal template based on your feedback
Help us improve. Take the feedback survey if you haven't already: https://forms.gle/bVyDCjSpYDPPqYJH9
Hugo Compatibility
- Tested with Hugo Extended 0.101.0 (recommended)
Breaking Changes
Join us on Discord for help upgrading a site.
- The Hugo module paths in
config.yaml
andgo.mod
have been updated as required by Hugo/Go: #2754 (comment) - Migrate any Highlight.js syntax highlighting theme to Hugo and reference it using the new options:
site.Params.features.syntax_highlighter.theme_light
andsite.Params.features.syntax_highlighter.theme_dark
- Migrate any HTML hooks to the re-designed hook system (acd7495)
i18n
- Translate some Japanese words by @Tatsuki-I in #2720
- Update Italian translations by @StefanoCecere in #2738
New Contributors
- @amistyrain made their first contribution in #2682
- @nathanstpr made their first contribution in #2705
- @hofbi made their first contribution in #2709
- @Tatsuki-I made their first contribution in #2720
- @dbkchu made their first contribution in #2715
- @zyrikby made their first contribution in #2749
Want to join these contributors and add open source to your CV? Contribute an improvement: https://github.com/wowchemy/wowchemy-hugo-themes/blob/main/.github/contributing.md
Full Changelog: v5.5.0...modules/wowchemy/v5.6.0
v5.5.0
A BIG shoutout to all the sponsors and contributors who supported this release 🙌🏻
What's Changed
Check out the demos of the updated starter templates or Discord Announcement channel for more visual examples of these incredible improvements 🦄
The starter templates have all been updated for this shiny new release of the Wowchemy website building framework for Hugo: https://github.com/wowchemy/wowchemy-hugo-themes/tree/v5.5.0/starters
- New Slider widget can be used for full screen image swiping (similar to popular apps)
- Ability to choose both day and night themes, and to be able to choose them from different theme packs
- Note: Bootstrap currently has a limitation on primary color, discussed here
- Ability to create and share your own personalized listing views
- Third party, community views can be added to the new community folder, such as by creating a file at
layouts/partials/views/community/MY_VIEW.html
and referencing it in a page's front matter asview: community/MY_VIEW
whereMY_VIEW
is a unique name for your view
- Third party, community views can be added to the new community folder, such as by creating a file at
- Add math shortcode - no longer any need to escape Markdown symbols that occur within math in the body of pages
- Apply custom sorting to items in the Pages and Portfolio widgets
- with
content.sort_by
(e.g. Date or Title) andcontent.sort_ascending
(e.g. true or false)
- with
- Add content to the Pages widget based on
folders
(rather than page type) - Add content to the Portfolio widget based on
folders
(rather than page type) ortags
- Faster page loading by reducing image sizes via WEBP conversion
- Can reduce image sizes by > 5x on a typical site that previously output JPGs and PNGs
- The popular showcase view (large images) that was exclusive to the Portfolio widget can now be used universally, such as in the Pages widget
- Show name pronunciation in the About widgets (see #2489)
- Example: add
name_pronunciation: Zhang San
tocontent/authors/admin/_index.md
- Example: add
- Breadcrumb navigation supported on all pages (not just book/docs pages)
- With
show_breadcrumb: true
in front matter
- With
- Set the navbar to disappear on scroll (to provide more vertical screen space for reading)
- in page front matter or via Hugo cascades, set
header.on_scroll
todisappear
orfixed
- in page front matter or via Hugo cascades, set
- Simpler, more intuitive site configuration in
params.yaml
- Ability to hide the navbar (and just use breadcrumb navigation, for example)
- Migrate to Hugo's v0.86 cascade system for setting page collection options
- Automatic detection of Mermaid diagrams in pages (no longer need to set
diagram: true
to front matter) - Ability to have multiple contact widgets
- Move contact params from params.yaml to contact widget
- SEO contact details (phone, address, coords) now under params.yaml > marketing > seo
- Example
- To make contribution even easier, all the starter templates have moved to https://github.com/wowchemy/wowchemy-hugo-themes/tree/main/starters
- any changes will continue to be copied to their dedicated repositories
Help us improve. Take the feedback survey if you haven't already: https://forms.gle/bVyDCjSpYDPPqYJH9
Hugo Compatibility
- Hugo Extended 0.95 Required
- Tested with Hugo Extended 0.95.0 (recommended)
Breaking changes
Join the community on Discord for help upgrading.
- Update HUGO_VERSION in
netlify.toml
to0.95.0
- Update site configuration by copying across the
config/
files from the latest version of the template your site uses: https://github.com/wowchemy/wowchemy-hugo-themes/tree/v5.5.0/starters - If using Contact widget, move your contact details over to the front matter of the widget (refer to the starter template that your site is based on)
- If using a custom theme, update it to have a
light
ordark
section (or both): https://github.com/wowchemy/wowchemy-hugo-themes/tree/v5.5.0/wowchemy/data/themes - If using Portfolio view in the Pinterest-like masonry style, migrate the view to
view: masonry
- If using banner images on pages, rename old Params.header to Params.banner
- Avoids conflict with new
header
param that configures site header
- Avoids conflict with new
Community contributions
- Show name pronunciation in About widgets by @kazutoiris in #2489
- Convert Slides from
cdnjs.cloudflare.com
to JSDelivr CDN by @IceCodeNew in #2513 - Update reveal.js from 4.1.0 to 4.2.1 with MathJax 3 integration by @rodrigoalcarazdelaosa in #2566
- i18n: update Indonesian (id) by @okabrionz in #2581
- fix: migrate mr_robot font to Google Font API v2 by @Aelphy in #2583
- pack for Malagasy language by @alidipatrick in #2626
- Gets license configuration from
footer.copyright.license
by @zakkak in #2638 - feat: run PostCSS on vendor CSS by @bkrl in #2644
- feat: address Hugo v0.92 notice RE changing behaviour of .Path by @mcanouil in #2642
- feat: update Font Awesome from v5.15.3 to v6 by @rodrigoalcarazdelaosa in #2650
New Contributors
- @kazutoiris made their first contribution in #2489
- @okabrionz made their first contribution in #2581
- @Aelphy made their first contribution in #2583
- @alidipatrick made their first contribution in #2626
- @zakkak made their first contribution in #2638
- @bkrl made their first contribution in #2644
- @mcanouil made their first contribution in #2642
Full Changelog: v5.4.0...v5.5.0
v5.4.0
A BIG shoutout to all the sponsors and contributors who supported this release 🙌🏻
What's Changed
- a simpler variation of the About widget (
widget: about.avatar
)- even add your status/mood as an emoji on your avatar ☕️
- example in the Blog template
- new shortcode to display a CSV file as a table (docs)
- now you can render CSV files (e.g. MS Excel, Pandas) as tables in your pages in addition to rendering tables from Markdown or Google Sheets
- (finally!) localized dates (e.g. Chinese sites now also display dates in Chinese), facilitated by Hugo 0.87+
- video backgrounds in widgets (example in the Fitness Coach template)
- simply upload an (optimized) video, such as intro.mp4, to your
assets/media/
folder and then add it as a background in acontent/home/
widget:design: background: video: path: intro.mp4 flip: false
- simply upload an (optimized) video, such as intro.mp4, to your
- support for rCAPTCHA in Formspree forms (#2377)
- don't index private pages (where front matter
private: true
) - migrate from CDNJS to JSDelivr due to CDNJS issues in China
- a Booking widget to enable visitors to book appointments with you (for sponsors)
- great for coaching or appointment based services, such as a professor enabling students to easily schedule appointments with them, for example 👩🏻🎓
Help us improve. Take the feedback survey if you haven't already: https://forms.gle/bVyDCjSpYDPPqYJH9
Hugo Compatibility
- Hugo Extended 0.87.0 - 0.89.4 Required
- Tested with Hugo Extended 0.89.4 (recommended)
Community contributions
- Update Hebrew translation by @paazca in #2375
- Add dutch address format by @mitchellolsthoorn in #2387
- adding en-ca and fr-ca format by @JOduMonT in #2389
- docs: Fix broken link in readme by @RoneoOrg in #2385
- feat: add support for rCAPTCHA in Formspree forms by @bevsxyz in #2377
- Improved Netlify Forms by @rodrigoalcarazdelaosa in #2394
- Make zh-Hant translation more accurate by @hk7math in #2404
- feat: add shortcode to render a CSV as a table by @bevsxyz in #2393
- Remove unwanted spaces in custom page links by @rodrigoalcarazdelaosa in #2412
- Add width and height to header/featured image by @jtatum in #2463
- Don't index private pages by @jtatum in #2464
- Update Academicons font library to v1.9.1 by @mitchellolsthoorn in #2505
- Refactor Classic Font Set Google Fonts Syntax by @gavinrozzi in #2516
- Eliminate
cdnjs.cloudflare.com
; Update all SRI by @IceCodeNew in #2512 - Update publication.html by @liyao001 in #2533
New Contributors
- @mitchellolsthoorn made their first contribution in #2387
- @JOduMonT made their first contribution in #2389
- @RoneoOrg made their first contribution in #2385
- @bevsxyz made their first contribution in #2377
- @hk7math made their first contribution in #2404
- @jtatum made their first contribution in #2463
- @gavinrozzi made their first contribution in #2516
- @IceCodeNew made their first contribution in #2512
- @liyao001 made their first contribution in #2533
Full Changelog: v5.3.0...v5.4.0
v5.3.0
A BIG shoutout to all the sponsors and contributors who supported this release 🙌🏻
Features
- portable figures - display your figures in Markdown editors like VSCode and Obsidian
- Figures can now be created by using the standard, portable Markdown syntax:

where the image is in the page folder, the media library, or is a remote URI.
- Figures can now be created by using the standard, portable Markdown syntax:
- you can now personalize the content listing
view
on archive pages (_index.md
) for courses, projects, taxonomies, and custom sections in the same way that you can already specify aview
on the archives of other content types - support animated GIF in figures (3ea78d2)
- add
show_date: false
page option to hide date from a page - load all galleries from the
assets/media/albums/
folder & add gallery display options- Add gallery
order
with options "asc" or "desc" - Add gallery
resize_options
which supports Hugo image processing options. - Fixes gallery zoom opening image in new tab (#2245)
- Add gallery
- Support custom footer in site folder at
layouts/partials/hooks/footer.html
(#2335)- For example, can be used to add columns of nav links to the footer.
Fixes
fix: editorial_workflow mode for Wowchemy CMS (#2319)
Other
feat: remove deprecated Docs layout - was replaced with Book in v5.0b0
Update
As requested by a large number of users over the years, you can now update Wowchemy directly from Github. See the TLDR section at https://wowchemy.com/docs/guide/update/
BREAKING CHANGES:
- The Hugo module names have been renamed as required by Hugo's module versioning system. Learn about the new module names in the TLDR section at https://wowchemy.com/docs/guide/update/
- Move gallery album folders to
assets/media/albums/
. Continue to choose the album name in the Gallery shortcode using thealbum
option. Album names should be lowercase due to a Hugo bug: gohugoio/hugo#7686
Hugo Compatibility:
Tested with Hugo Extended v0.84.1
v5.2.0
A BIG shoutout to all the sponsors and contributors who supported this release 🙌🏻
What's new? Check out the blog post: https://wowchemy.com/blog/v5.2.0/
Features
- Add brand logos to Experience widget
- Add brand logos to Accomplishments widget
- feat: allow SVG as Hero image
- feat: support custom experience order (#1761)
- feat: only show User Group headings in People widget when multiple
- feat: add new
gradient_angle
option to page builder - feat: support Bing site verification (#2287) via params.yaml > marketing > bing_site_verification
Fixes
- fix: Language name doesn't appear for sub-codes such as zh-Hant
Other
- remove deprecated
netlify-cms-academic
module that was replaced withwowchemy-cms
Upgrade your site
Run the Hugo commands:
hugo mod get github.com/wowchemy/wowchemy-hugo-modules/wowchemy@89d079b
hugo mod get github.com/wowchemy/wowchemy-hugo-modules/wowchemy-cms@89d079b
Update the Hugo Extended version in netlify.toml
with HUGO_VERSION = "0.83.1"
Breaking Changes
- rename
assets/media/icon-pack
toassets/media/icons
(if the folder exists in your site)