v5.5.0

[gcushen]

A BIG shoutout to all the sponsors and contributors who supported this release 🙌🏻

What's Changed

Check out the Discord Announcement channel for more visual examples

• 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
• 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 as view: community/MY_VIEW where MY_VIEW is a unique name for your view
• Apply custom sorting to items in the Pages and Portfolio widgets
  • with content.sort_by (e.g. Date or Title) and content.sort_ascending (e.g. true or false)
• 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) or tags
• 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 Show name pronunciation in About widgets #2489)
• Breadcrumb navigation supported on all pages (not just book/docs pages)
  • With show_breadcrumb: true in front matter
• 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 to disappear
• Simpler, more intuitive site configuration in params.yaml
  • Example params.yaml for the Academic theme
  • Documentation on the new options
• 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
  • Example
• Automatic detection of Mermaid diagrams in pages (no longer need to set diagram: true to front matter)
• Add math shortcode - no longer any need to escape Markdown symbols that occur within math in the body of pages
• 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
  • See Simpler, more intuitive configuration #2601

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 to 0.95.0
• Update site configuration by copying across the config/ files from the latest version of the template your site uses
• Rename old Params.header to Params.banner (if using banner images on pages)
  • Avoids conflict with new header param that configures site header

Community contributions

• Show name pronunciation in About widgets by @kazutoiris in Show name pronunciation in About widgets #2489
• Convert Slides from cdnjs.cloudflare.com to JSDelivr CDN by @IceCodeNew in Convert Slides from cdnjs.cloudflare.com to JSDelivr CDN #2513
• Update reveal.js from 4.1.0 to 4.2.1 with MathJax 3 integration by @rodrigoalcarazdelaosa in Update reveal.js from 4.1.0 to 4.2.1 with MathJax 3 integration #2566
• i18n: update Indonesian (id) by @okabrionz in i18n: update Indonesian (id) #2581
• fix: migrate mr_robot font to Google Font API v2 by @Aelphy in fix: migrate mr_robot font to Google Font API v2 #2583
• pack for Malagasy language by @alidipatrick in pack for Malagasy language #2626
• Gets license configuration from footer.copyright.license by @zakkak in Gets license configuration from footer.copyright.license #2638
• feat: run PostCSS on vendor CSS by @bkrl in feat: run PostCSS on vendor CSS #2644
• feat: address Hugo v0.92 notice RE changing behaviour of .Path by @mcanouil in feat: address Hugo v0.92 notice RE changing behaviour of .Path #2642
• feat: update Font Awesome from v5.15.3 to v6 by @rodrigoalcarazdelaosa in feat: update Font Awesome from v5.15.3 to v6 #2650

New Contributors

• @kazutoiris made their first contribution in Show name pronunciation in About widgets #2489
• @okabrionz made their first contribution in i18n: update Indonesian (id) #2581
• @Aelphy made their first contribution in fix: migrate mr_robot font to Google Font API v2 #2583
• @alidipatrick made their first contribution in pack for Malagasy language #2626
• @zakkak made their first contribution in Gets license configuration from footer.copyright.license #2638
• @bkrl made their first contribution in feat: run PostCSS on vendor CSS #2644
• @mcanouil made their first contribution in feat: address Hugo v0.92 notice RE changing behaviour of .Path #2642

Full Changelog: v5.4.0...v5.5.0

---

This discussion was created from the release v5.5.0.

[ebousse]

Hi! What should we put in the go.mod file to upgrade to this version? I have tried several things but strangely I either end up in 5.3.0 or in 5.4.0, and never 5.5.0.

[ebousse]

Self-reply: I went with running

go get -u github.com/wowchemy/wowchemy-hugo-modules/wowchemy/v5