Add .Site.Language.I18n method (or .Translate?)

[nekr0z]

Following the support question in this forum thread: it would be nice to have site.Translation method to leverage i18n information from the .Translations range.

[bep]

I'm not totally sure about the method name. Since it should behave the same as the current i18n func, maybe we should just name it site.I18n so people don't get other expectations.

[martignoni]

Without a capitalized "I", I'd suggest: site.i18n.

[nekr0z]

.site.i18n with an alias of .site.T — for full consistency, you know...

[bep]

Without a capitalized "I", I'd suggest: site.i18n.

• As this would be a method on the Site interface, the Go spec forces first character to be uppercase for public/exported methods.
• site.i18n is technically a function and could be all lowercase (I think), but that is just an alias for .Site.I18n, which is the useful method in this setting, as in: .Sites.First.I18n "foo"

And also, I don't want to fill the Site interface up with aliases.

[gitauris]

Was this ever added? I can't seem to find it in the current documentation.
Or, if not, is there any other way to retrieve a translation for a string in a different language than the current one?
Thanks, Michael

[jmooring]

No, not added... this issue is still open.

If you are using a simple (no pluralization rules) translation table, you can mount the i18n directory to the data directory.

i18n/en.toml

privacy = 'privacy'
security = 'security'

i18n/pl.toml

privacy = 'prywatność'
security = 'bezpieczeństwo'

site config

[[module.mounts]]
source = 'data'
target = 'data'

[[module.mounts]]
source = 'i18n'
target = 'data'

Then in your template:

{{ index .Site.Data "pl" "privacy" }} --> always returns polish translation

{{ T "privacy" }} --> translated to the current language, falling back to the default language

I don't know of any (simple¹) way of handling this if your translation tables include pluralization rules, for example:

i18n/pl.toml

[day]
few = 'miesiące'
many = 'miesięcy'
one = 'miesiąc'
other = 'miesiąca'

Footnotes

1. There's a convoluted way to do this with a partial, a content view, and a page scratch, but I think the complexity far outweighs the functional benefit. ↩

[hekuli]

+1 for this to support my use case:
https://discourse.gohugo.io/t/iterate-and-display-a-message-for-all-languages-regardless-of-current-pages-language/49322/