EntitySystems/EntityLocalizerv0.1.7

Entity Localizer

https://github.com/EntitySystems/EntityLocalizer

Generate locales from JSON files

How to use:

Install latest package EntityLocalizer https://www.nuget.org/packages/EntityLocalizer/

Add this to .csproj.

<Project> <Target Name="CodeGen" AfterTargets="AfterBuild;AfterRebuild"> <EslGeneratorTask InputPath="./StaticResources/Locales" OutputPath="./GeneratedResources/Locales/" OutputNamespace="Entity" /> </Target> </Project>

• InputPath is the directory from where to load the locales,
• OutputPath is the directory where the output C# resource file will be generated.
• OutputNamespace is the namespace for the generated C# file.

Once you have setup your project, you can add locales by creating *.loc.json files, the file names must end in .loc.json. Format below:

{ "HelloWorld": { "EN": "Hello generated world!", "FR": "Bonjour monde!" }, "Login": { "EN": "Log in", "FR": "Connexion" } }

Then you just run a build on consumer project, you can now access your locales/translations via C# using the following:

var locales = new EntityLocales() { InstanceLanguage = "EN" }; Console.WriteLine(locales.HelloWorld); // outputs "Hello generated world!"

If you want to generate translations that accept parameters, you can do the following in the JSON file:

{ "LocaleWithArgument": { "args": [ "string:name", "number:amount", "string:currency" ], "EN": "Welcome {0}, your bill is of {1} {2}", "FR": "Bienvenue {0}, votre facture est de {1} {2}" } }

Only the 2 following types are supported: string and number. Supply a mandatory method argument name like so: [type]:[argName]

You can then access the locales and supply arguments like so:

var translated = locales.LocaleWithArgument("Jacob", 129.99m, "$"); // outputs "Welcome Jacob, your bill is of 129.99 $"

Built by Entity Systems || https://entitysystems.co