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)
  • Demo
• 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 as view: community/MY_VIEW where MY_VIEW is a unique name for your view
• Add math shortcode - no longer any need to escape Markdown symbols that occur within math in the body of pages
  • Example
• 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 #2489)
  • Example: add name_pronunciation: Zhang San to content/authors/admin/_index.md
• 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 or fixed
• 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)
  • 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)
• 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 to 0.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 or dark 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

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