mirror/hugo
1
0
Fork 0
mirror of https://github.com/gohugoio/hugo.git synced 2025-08-21 21:35:28 +02:00
Code Issues Packages Projects Releases Wiki Activity

Merge commit 'b3d87dd0fd746f07f9afa6e6a2969aea41da6a38'

Browse Source
This commit is contained in:
Bjørn Erik Pedersen
2025-04-24 10:23:16 +02:00
parent 6a0e04241a b3d87dd0fd
commit 61a286595e
101 changed files with 503 additions and 164 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
docs/content/en/shortcodes/ref.md
View File

@@ -10,7 +10,7 @@ keywords: []
> To override Hugo's embedded `ref` shortcode, copy the [source code] to a file with the same name in the `layouts/shortcodes` directory.
> [!note]
> When working with the Markdown [content format], this shortcode has become largely redundant. Its functionality is now primarily handled by [link render hooks], specifically the embedded one provided by Hugo. This hook effectively addresses all the use cases previously covered by this shortcode.
> When working with Markdown, this shortcode is obsolete. Instead, use a [link render hook] that resolves the link destination using the `GetPage` method on the `Page` object. You can either create your own, or simply enable the [embedded link render hook]. The embedded link render hook is automatically enabled for multilingual single-host projects.
## Usage
@@ -56,6 +56,7 @@ Rendered:
{{% include "_common/ref-and-relref-error-handling.md" %}}
[content format]: /content-management/formats/
[link render hooks]: /render-hooks/images/#default
[embedded link render hook]: /render-hooks/links/#default
[link render hook]: /render-hooks/links/
[Markdown notation]: /content-management/shortcodes/#notation
[source code]: {{% eturl ref %}}
[source code]: {{% eturl relref %}}