Server Asset Overrides

This guide effectively documents the usage of the asset_path server configuration option.

Structure#

/config/assets/
├── favicon.ico
├── logo.png
└── locales/<lang>[-[variant]]/<namespace>.json

Assets#

locales#

The locales directory holds folders of internationalization locales. This directory can be utilized to override these locales. They are the names of locales that are returned by the navigator.language ECMAScript command. These are generally those in the RFC5646 / BCP47 Format specifically the language codes from Crowdin.

Each directory has JSON files which you can explore the format of in the internal/server/locales directory on GitHub. The important part is the key names you wish to override.

A full example for the en-US locale for the portal namespace is locales/en-US/portal.json.

Languages in browsers are supported in two forms. In their language only form such as en for English, and in their variant form such as en-AU for English (Australian). If a user has the browser language en-AU we automatically load the en and en-AU languages, where any keys in the en-AU language take precedence over the en language, and the translations for the en language only applying when a translation from en-AU is not available.

Namespaces#

Each file in a locale directory represents a translation namespace. The list of current namespaces are below:

Supported Languages#

List of supported languages and variants:

More information may be available from the Internationalization Reference Guide.