Version 7.4

See the changelog of this version for a detailed list of changes.

  • 0.126.0 Minimum required Hugo version

  • Breaking Change requiring action after upgrade

  • Change Change of behavior, may require action

  • New New behavior, often introducing new options

7.4.0 (2025-02-21)

Change

  • Change The way you link to pages in a different language has changed. Until now this was an undocumented feature.

    Previously you could prepend an URL with the language code, e.g. /pir/my-page to link to pages of other languages. This could cause problems if you have a page with the same name as the language code on the top level of your page structure.

    Now you have to set the query parameter lang to the language code, e.g. /my-page?lang=pir.

    As this was previously undocumented, most projects will not be affected. If you still need the old behavior, you can set enableLegacyLanguageLinks=true in your hugo.toml.

  • Change The target parameter of the button shortcode was deprecated.

    Use link effects on the href parameter instead. You don’t need to change anything as the old parameter still works but may generate warnings.

New

  • New The theme now allows page references (given as pageRef of a Hugo menu item, pageRef parameter of a sidebarmenus entry and the menuPageRef in a page’s front matter) to also be global resources from your assets directory.

  • New If link.errorlevel is configured, now also page references will be checked for existence.

  • New You can now configure an ignore list of regular expressions for addresses that should be ignored if an errorlevel test fails. This is configured by setting urlIgnoreCheck=[] globally in your hugo.toml for all errorlevel checks.

    This helps to remove false negatives while still benefitting from the check for all other addresses.

  • New It is now possible to add query parameter and an optional fragment part to all links. This is regardless whether it is a local or remote address and also applies to Hugo’s internal path.

    By that you can now use it on Markdown links and image links, page references and buttons.

  • New You can now link to different output formats of a page by adding a query parameter.

    For example to link to the print format of a page, write /my-page?format=print.

  • New There are two new image effects that are usable if the linked image points to a resource:

    • dataurl: resource is converted to a base64 encoded dataurl
    • inlinecontent: in case of SVG resources, the content will be used instead of an <img> element, this is useful for applying additional CSS styles to the elements inside of the SVG which is otherwise impossible

  • New This release introduces link effects which work similar to image effects and can be set as query parameter on any link.

    With that you currently can specify

    • target: set a link target individually for each link
    • download: a click on the link should result in a file download instead of a navigation

  • New The theme supports the new source output format which behaves similar in configuration as the markdown output format but allows the original Markdown source including the front matter of a page to be viewed.

    You can see this in action on the above linked page, accessible by clicking the topbar button.

  • New If you haven’t overridden layouts/partials/custom-header.html and css/custom.css and/or js/custom.js is present in your project, the theme now adds them to your pages.

    This was done to be compatible with adding custom scripts in an older version of the Hugo documentation.

  • New If you haven’t overridden layouts/partials/content-footer.html, you can now configure which page meta information - like author’s name, email address and authoring date - should be displayed. Also the date format is now configurable.

  • New The logo color is now configurable via the --MENU-HEADER-color variable in your variant stylesheets.

  • New Now favicons are also searched in the assets/images directory.

  • New Table headers are sticky now.

  • New The themes documentation has been moved from exampleSite to docs to make place for a brand new exampleSite. Welcome on board the The Purple Pulpo!

    This was done because the docs contained to much docs specific configuration and quirks. The new exampleSite is meant as a starting template for your own project with minimal initial configuration.