JSON Local Texts

Serenity supports local text registration through JSON files containing a simple key/value dictionary:

{
  "Forms.Administration.User.DisplayName": "Display Name",
  "Forms.Administration.User.Email": "E-mail",
  "Forms.Administration.User.EntitySingular": "User",
  "Forms.Administration.User.EntityPlural": "Users"
}

To register all local text keys and translations from JSON files in a folder , call JsonLocalTextRegistration.AddFromFilesInFolder with the path:

JsonLocalTextRegistration.AddFromFilesInFolder(@"C:\SomeFolder");

File names in the folder must follow a convention:

{Some Prefix You Choose}.{LanguageID}.json

where {LanguageID} is two or four letter language code. Use invariant as language code for invariant language.

Some sample file names are:

site.texts.en-US.json
MyCoolTexts.es.json
user.texts.invariant.json

Files in a folder are parsed and added to registry in their file name order. Thus for sample file names above, order would be:

MyCoolTexts.es.json
site.texts.en-US.json
user.texts.invariant.json

This order is important as adding a translation in some language with same key overrides prior translation.

CommonInitialization and Predetermined Folders

CommonInitialization.Run and CommonInitialization.InitializeLocalTexts calls this method for two predetermined locations under your web site:

~/Scripts/serenity/texts
~/Scripts/site/texts

Prefer using second one for your own files as first one is for Serenity resources.