Version 5.0 Beta 1 (December 2020)

Last updated on Sep 26, 2022 3 min read

What’s new?

  • Changes to Contact form
    • for Formspree forms, a Form ID is now required - check your form still works as expected
    • if email is entered in params.toml, it’s now displayed in the Contact widget (since Formspree no longer uses this option)
  • Support for both 1 and 2 column widget variations for the following widgets: pages, featured, experience, accomplishments, contact, blank, tag_cloud, portfolio
  • Support for multiple books (e.g. multiple courses, notebooks, docs, or knowledge bases) each with its own dedicated sidebar menu
    • previously, pages from all books were listed together in the sidebar
  • Support for listing multiple books (e.g. multiple courses, notebooks, docs, or knowledge bases) - by creating an _index.md of type: page in the parent folder which contains multiple book folders
  • You can now choose from an incredible 34+ languages for your site
  • We have added more safe defaults for parameters in case they are not provided. This means that you can now remove any parameters you don’t need from params.toml. For example, comments config can be removed for a site that doesn’t use comments.
  • Create call-to-action buttons with new shortcode (details below)
  • Customize the see all link in the Featured widget (details below)
  • Add support for Microsoft Clarity analytics - see Guides > Analytics
  • Push footer to window bottom for short pages (except book pages)
  • Reduce wordwrap hyphenation (similar to other blogging platforms)
  • Fix Hugo not mounting the speaker notes plugin for Markdown slides
  • There’s now a minimal test site for testing and inspiration purposes (similar to the Hello World template)
  • Add experimental require_isotope = false option. If a site doesn’t require the Isotope Layout Engine (i.e. not using filter on publication archive page or the Portfolio widget), it can be disabled in params.toml for performance increase. Useful for very minimal templates such as the Hello Starter template.
  • Removed back to top button which received limited use given the fixed navbar, ToC sidebar for Books, and smarter scrolling in browsers.

💪 Some other exciting achievements between the v5.0.0 Beta 0 and Beta 1 releases include:

Update to this version

❤️ If you upgrade, please support the significant effort which goes into this open source movement by kindly giving back and sponsoring on GitHub

Update with:

hugo mod clean
hugo mod get github.com/wowchemy/wowchemy-hugo-themes/[email protected]
hugo mod get github.com/wowchemy/wowchemy-hugo-themes/[email protected]
hugo mod tidy

Apply Breaking Changes

Required Changes

  • Require Hugo Extended v0.78.2. (Future Hugo versions may work but are untested.)
    • Update your Hugo version in netlify.toml to 0.78.2

Optional Changes

  • Changes to Contact form
    • for Formspree forms, a Form ID is now required - check your form still works as expected
    • if email is entered in params.toml, it’s now displayed in the Contact widget (since Formspree no longer uses this option)

New features

Create buttons and call-to-actions

Create buttons and call-to-actions (CTA) with new shortcodes.

Example CTA button:

{{< cta cta_text="Do something" cta_link="/" cta_new_tab="false" >}}

Example CTA with a link to an alternate action:

{{< cta cta_text="Do something" cta_link="/" cta_new_tab="false" cta_alt_text="Alternative action" cta_alt_link="/" cta_alt_new_tab="false" >}}

Want to customize the See All link in the Pages and Featured widgets? Now you can!

There’s now the choice to hide the link, change the text, or change the link itself by adding the following TOML or YAML snippet to the bottom of the front matter for your Pages or Featured widget instances:

TOML:

[content.archive]
    enable = true
    text = "See all blog posts"
    link = "post/"

YAML:

content:
  archive:
    enable: true
    text: See all blog posts
    link: post/

For details, see #1800.

Ask a question