EntityLocalizer 0.1.8

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",
    "?": "Default case override"
  }
}

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