hugo-theme-relearn/docs/content/introduction/releasenotes/7/4.en.md
Sören Weber 5f9fee85c4
Some checks are pending
docs-build-deployment / Run deploy (push) Waiting to run
docs-build / Run build (push) Waiting to run
link: change cross language URL format #850
2025-02-08 02:20:22 +01:00

4.1 KiB

+++ disableToc = false hidden = true title = "Version 7.4" type = "releasenotes" weight = -4 +++

7.4.0 (XXXX-XX-XX)

Change

  • {{% badge style="note" title=" " %}}Change{{% /badge %}} 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.

  • {{% badge style="note" title=" " %}}Change{{% /badge %}} 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

  • {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} 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.

  • {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} If link.errorlevel is configured, now also page references will be checked for existence.

  • {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} 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.

  • {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} 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

    • a link target individually for each link
    • that a link should result in a file download in your browser
  • {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} You can now configure an ignore list of addresses that should be ignored if an errorlevel test fails. This is configured by setting errorignore=[] 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.

  • {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} 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 {{% button style="transparent" icon="file-code" %}}{{% /button %}} topbar button.

  • {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} 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.

  • {{% badge style="info" icon="plus-circle" title=" " %}}New{{% /badge %}} Table headers are sticky now.