mirror of
https://github.com/gohugoio/hugo.git
synced 2026-08-25 15:58:53 +00:00
Describe lang.Translate fallback behavior
This commit is contained in:
+4
-1
@@ -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",
|
||||
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user