Template for shortcode not found

[doompadee]

What version of Hugo are you using (hugo version)?

v0.147.4-84c8426f328a946b2e10611431c450b352cecd11+extended linux/amd64 BuildDate=2025-05-20T10:41:19Z VendorInfo=gohugoio

Does this issue reproduce with the latest release?

Yes

As I'm not sure notifications of comments in closed tickets are sent, here is the additional information regarding the recently reported shortcode issue #13699 that still happens for me.

I've created a minimal example that triggers the issue for me:

$ git clone https://github.com/doompadee/hugo-13699
$ cd hugo-13699
$ hugo 

Ouput:

Start building sites … 
hugo v0.147.4-84c8426f328a946b2e10611431c450b352cecd11+extended linux/amd64 BuildDate=2025-05-20T10:41:19Z VendorInfo=gohugoio

Total in 10 ms
Error: error building site: process: readAndProcessContent: "hugo-13699/content/index.md:7:1": failed to extract shortcode: template for shortcode "fr" not found

Please let me know if you need further information. Thanks.

[jmooring]

@doompadee Your forum topic 54670 lead to the creation of issue 13699 which was closed via 5a81a3a with this commit message:

I'm not able to reproduce this, but leaving it [the integration test] in.

We were unable to reproduce the problem because you added this critical detail after we created issue 13699:

Actually I didn’t have fr enabled. I forgot that in order to speed up rebuilding during development, the secondary languages were disabled in the development config

You should have added that detail to the issue.

Having said that, I'm having a difficult time understanding why you named your shortcodes with a language code. We parse the template file names for a number of things, including language. If I were you I we rename these and be done with it.

It seems to me that, if you disable language xx, then shortcodes xx.html and foo.xx.html should be disabled as well.

[doompadee]

@jmooring

You should have added that detail to the issue.

I see. My apologies.

Having said that, I'm having a difficult time understanding why you named your shortcodes with a language code.

It's a part of a language selector that uses a tabbed inferface to switch between different languages inline:

{{<localized>}}
 {{<de>}}
 ...
 {{</de>}}
 {{<fr>}}
 ...
 {{</fr>}}
{{</localized>}}

It seems quite natural to me to use the language codes for localized content. Now, this is an older site that initially did only provide one main language and some localized sections. Automatic translation has only been added later, that's why there are several languages now, but a few localized sections still remain where it's necessary to be able to switch on the spot.

It seems to me that, if you disable language xx, then shortcodes xx.html and foo.xx.html should be disabled as well.

That would be welcome, but instead the server does not start! I did not anticipate that Hugo would interpret the shortcode names for localization in quite this way. I think, the language code should only be extracted if it is not the name itself (i.e. if there are at least three parts separated by dots).

[jmooring]

Your use case is uncommon, and the problem is limited to when the corresponding language is disabled. Is there some reason you can't do something like this instead?

layouts/
├── _shortcodes/
│   ├── _de.html
│   └── _en.html
└── all.html

{{< localized >}}
 {{< _de >}}
 ...
 {{< /_de >}}
 {{< _fr >}}
 ...
 {{< /_fr >}}
{{< /localized >}}

[doompadee]

Is there some reason you can't do something like this instead?

I can of course rename the shortcodes. Feel free to close if you think the issue is too obscure to fix. I was under the impression that this differing behavior from prior versions was recognized as a bug, therefore I wanted to provide further input.

Either way, thanks much for your help! It's amazing to provide this level of attention.

[bep]

@doompadee there's a fix underway.