EzJsonLocalization.Web.AspNetCore 1.0.0

JsonLocalization

A simple .NET JSON localization library

Installation

Add the Nuget packages to your project:

Install-Package EzJsonLocalization
Install-Package EzJsonLocalization.Web.AspNetCore

Usage

Set the JSON localization settings:

services.AddJsonLocalization(options => {
    options.ResourceFolders = new[] { "locale" };
    options.DefaultLocale = "en-US";
});

Create locale files at the location specified at ResourceFolders. The local files should be named in languagecode-country.json format, for example en-us.json.

Add translations in the following format:

{
  "greeting": "Hello!",
  "farewell": "Goodbye!"
}

Inject the II18N into your constructor:

public MyClass(II18N i18n) {
    _i18n = i18n;
}

Perform a translation:

_i18n.Translate("greeting")

To change the locale:

Thread.CurrentThread.CurrentCulture = new CultureInfo("fr-CA");

Fallback and substitution

You can provide a fallback string and format parameters:

{
  "greeting": "Hello {0}!"
}

_i18n.Translate("greeting", "Hi!", "John")

Outputs:

Hello John!