README.md

Fun.I18n

Source generator helper library for i18n.
Currently you can use it in your cli tool (Fun.Build etc.) to generate csharp source code.

Fun.I18n.Provider

This project provide a simple i18n provider which is based on the Titaye and Fable.JsonProvider.

The difference is that I try to support dotnet and fable at the same time and removed the node-polyglot with my own simple implementation.

I also use this project to try fsharp typeprovider and finally learned something.

Online i18n json editor is hosted on github now

How to use

// For dotnet
dotnet add package Fun.I18n.Provider

// For fable
dotnet add package Fun.I18n.Provider.Fable

let [<Literal>] I18nJsonFileTemplate = __SOURCE_DIRECTORY__ + "/test.i18n.json"

// You can fetch from server
let translatedI18nJson =
    """
    {
        "App": {
            "Title": "This is the coolest app",
            "FormatAll": "String: %{strVar}; Int: %{intVar}; Float: %{floatVar}; Any: %{anyVar}",
            "GotErrors": "You got %{smart_count} error |||| You got %{smart_count} errors"
        }
    }
    """

#if !FABLE_COMPILER
type I18N = Fun.I18n.Provider.I18nProvider<I18nJsonFileTemplate, false>
let i18n = I18N translatedI18nJson
#else
type I18N = Fun.I18n.Provider.I18nProvider<I18nJsonFileTemplate, true>
let i18n = Fun.I18n.Provider.Fable.Utils.createI18n I18N translatedI18nJson // Use createI18n to pull dependencies for fable
#endif


// Now you are good to go
i18n.App.Title // This is the coolest app
i18n.App.GotErrors(1) // You got 1 error
i18n.App.GotErrors(2) // You got 2 errors
i18n.App.FormatAll("cool string", 123, 1234., "any")

// Or you can try Translate method to get raw translation
i18n.Translate "App:Title" // This is the coolest app
// Or
i18n.App.Translate "Title" // This is the coolest app

i18n.App.TryTranslate "NotDefinedKey" // None

You can also create new i18n based on some default i18n like:

#if !FABLE_COMPILER
let newI18n = Fun.I18n.Provider.Utils.createI18nWith i18n newI18nJson
#else
let newI18n = Fun.I18n.Provider.Fable.Utils.createI18nWith i18n newI18nJson
#endif