[i18n] localization of snippets inside shortcodes

[ymotongpoo]

What needs to be changed?

Currently, ja and zh localizations are happening. The localization is usually done in the following steps:

1. copy the original content under content/en and move them to the corresponding directory of each language. (eg. content/ja)
2. translate the content

However, some of the documents are embedded in Hugo short codes, which are out of content directory.

For example, This is the screenshot of the Japanese translation of concepts > resources page:

As you see, the first two paragraphs are not translated yet. The corresponding markdown of this page is:

## はじめに

{{% docs/languages/resources-intro %}}

オブザーバビリティバックエンドに[Jaeger](https://www.jaegertracing.io/)を使用している場合、リソース属性は**Process**タブの下にグループ化されます。

This short code is located at layouts/shortcodes/docs/languages/resources-intro.md. How can we localize these short codes?

What is the name + path of the page that needs changed?

layouts/shortcodes/docs/languages

Additional context:

• relevant discussion: Internationalization (i18n) and localization (l10n) #4302

[svrnm]

@chalin any ideas how to address this? Should we have "localized" shortcodes or should we use translated strings and put that text into some TOML files?

[chalin]

Both approaches could be useful (or even a combination of both), but my feeling is that the complexity of a shortcode warrants it being localized, something like this, PTAL:

• [i18n] ja localization of resources-intro shortocde #4787