Localization Packages Overview

A complete set of culture-specific Plesk Sitebuilder resources is called a localization package (LP).

Every localization package specifies the resources for some culture.

Culture names follow the RFC 1766 standard in the format "<languagecode2>-<country/regioncode2>", where <languagecode2> is a lowercase two-letter code derived from ISO 639-1 and <country/regioncode2> is an uppercase two-letter code derived from ISO 3166. For example, U.S. English is "en-US". In cases where a two-letter language code is not available, the three-letter code derived from ISO 639-2 is used; for example, the three-letter code "div" is used for cultures that use the Dhivehi language. Some culture names have suffixes that specify the script; for example, "-Cyrl" specifies the Cyrillic script, "-Latn" specifies the Latin script.

The cultures are generally grouped into three sets:

• Invariant culture (English default localization)
• Neutral cultures
• Specific cultures

Invariant culture is culture-insensitive. You can specify the invariant culture by name using an empty string ("") or by its culture identifier 0x007F. Invariant culture retrieves an instance of the invariant culture. It is associated with the English language but not with any country/region.

Neutral culture specifies only the language (specified by two-letter lower-case codes, e.g. "en" for English)

Specific culture specifies both language and country/region.(Specified by adding a dash and country code after the corresponding neutral culture code, e.g. "en-US" for United States English, or "en-GB" for British English.)

Note: Only one LP can be installed into a single Plesk Sitebuilder instance for any culture, but arbitrary number of LPs can be installed for different cultures simultaneously.

Automated Localization Packages Selection

Whenever a user selects their culture, Plesk Sitebuilder determines the best matching LP using the simple override algorithm:

• If there is an LP installed for the exact specific culture, it is activated ("en-GB")
• Otherwise, the LP for an appropriate neutral culture is activated if exists ("en")
• Otherwise, the default LP is activated

Localization Package Structure

From the technical standpoint, an LP is a Windows Installer package (.msi) containing all the resource files and processing instructions necessary for installation into an existing Plesk Sitebuilder instance.

Localization packages are compiled from localization package sources - XML files with .sblp extension containing entries (triplet "key-phrase-comment") grouped into sections, which fully describe the interface of the program.