aboutsummaryrefslogtreecommitdiffhomepage
path: root/content/en/content-management/multilingual.md
diff options
context:
space:
mode:
Diffstat (limited to 'content/en/content-management/multilingual.md')
-rw-r--r--content/en/content-management/multilingual.md17
1 files changed, 12 insertions, 5 deletions
diff --git a/content/en/content-management/multilingual.md b/content/en/content-management/multilingual.md
index 4529eb1c4..b8ba80dfd 100644
--- a/content/en/content-management/multilingual.md
+++ b/content/en/content-management/multilingual.md
@@ -21,16 +21,23 @@ This is the default language configuration:
In the above, `en` is the language key.
-{{% note %}}
-Each language key must conform to the syntax described in [RFC 5646]. You must use hyphens to separate subtags. For example:
+
+Language keys must conform to the syntax described in [RFC 5646]. For example:
- `en`
-- `en-GB`
-- `pt-BR`
+- `en-US`
-[RFC 5646]: https://datatracker.ietf.org/doc/html/rfc5646#section-2.1
+Artificial languages with private use subtags as defined in [RFC 5646 § 2.2.7] are also supported. Omit the `art-x-` prefix from the language key. For example:
+
+- `hugolang`
+
+{{% note %}}
+Private use subtags must not exceed 8 alphanumeric characters.
{{% /note %}}
+[RFC 5646]: https://datatracker.ietf.org/doc/html/rfc5646#section-2.1
+[RFC 5646 § 2.2.7]: https://datatracker.ietf.org/doc/html/rfc5646#section-2.2.7
+
This is an example of a site configuration for a multilingual project. Any key not defined in a `languages` object will fall back to the global value in the root of your site configuration.
{{< code-toggle file=hugo >}}