Describe lang.Translate fallback behavior

This commit is contained in:
Joe Mooring
2023-12-15 08:54:20 -08:00
committed by GitHub
parent a6d9c362c0
commit b3b1df75d6
2 changed files with 22 additions and 1 deletions
+4 -1
View File
@@ -7,8 +7,10 @@
"flagWords": [
"alot",
"hte",
"langauge",
"reccommend",
"seperate"
"seperate",
"teh"
],
"ignorePaths": [
"**/emojis.md",
@@ -69,6 +71,7 @@
"transpile",
"transpiles",
"unmarshal",
"unmarshals",
"unmarshaling",
"# ----------------------------------------------------------------------",
"# cspell: ignore foreign language words",
+18
View File
@@ -8,9 +8,27 @@ action:
related: []
returnType: string
signatures: ['lang.Translate KEY [CONTEXT]']
toc: true
aliases: [/functions/i18n]
---
The `lang.Translate` function returns the value associated with given key as defined in the translation table for the current language.
If the key is not found in the translation table for the current language, the `lang.Translate` function falls back to the translation table for the [`defaultContentLanguage`].
If the key is not found in the translation table for the `defaultContentLanguage`, the `lang.Translate` function returns an empty string.
[`defaultContentLanguage`]: /getting-started/configuration/#defaultcontentlanguage
{{% note %}}
To list missing and fallback translations, use the `--printI18nWarnings` flag when building your site.
To render placeholders for missing and fallback translations, set
[`enableMissingTranslationPlaceholders`] to `true` in your site configuration.
[`enableMissingTranslationPlaceholders`]: /getting-started/configuration/#enablemissingtranslationplaceholders
{{% /note %}}
Let's say your multilingual site supports two languages, English and Polish. Create a translation table for each language in the `i18n` directory.
```text