Releases: HugoBlox/hugo-blox-builder
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:
![screen reader text](image.jpg "caption")
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)