i18nStronglyTypedCore 1.0.0.3

i18nStronglyTypedCore

This is the source code for the i18nStronglyTypedCore nuget package.

Github source code

About

This is a .net core port of afana's excellent i18n (internationalization) provider for MVC 5, using xml for the resource strings.

There's also some extras, such as per request language responses and multiple resource file handling (see tutorial below).

Of course, dotnet core has its' own i18n provider but like many people, I'd rather keep things strongly typed as much as possible. It's simple to get up and running.

The upsides to this package are:

1. Strongly typed
2. Seems pretty solid
3. Only takes a couple of minutes to get up and running.
4. Can handle multiple resource files.
5. Can handle "per request" language responses (see tutorial)

The downsides to this package are:

1. *Doesn't work with Attributes (the standard .net core one does)
2. If you create the c# part, but forget to put the corresponding row in the xml, the error is a bit tricky to work out.

Prerequisites

• Dotnet core 2.1+

To get up and running

(see deeper tutorial with screenshots at Github if needed)

It's really simple to get going and only takes a few minutes. Assuming an MVC Core project:

1. Via the CLR or Package Manager (View > Other Windows > Package Manager Console) enter the following, then hit enter:

Install-Package i18nStronglyTypedCore

2. In wwwroot, add a folder called 'Resources' and in that add an xml file called 'Resources.xml'.

3. In resources.xml, insert the following placeholder content:

WARNING: The following example has the default culture to be British English (en-GB). You may need en-US or another culture.

<?xml version="1.0" encoding="utf-8" ?>
<resources>
    
    <resource culture="en-GB" type="string" name="Site_Name" value="Site name (english)"></resource>
    
    
    <resource culture="fr-FR" type="string" name="Site_Name" value="Site name (Francais)"></resource>

</resources>

4. Create a class and have that class inherit from i18nStronglyTypedCore.i18n (I made a class called 'i18n.cs' in a 'Resources' folder). Include the following property in the class.

public static string Site_Name { get { return GetStringValue(); } }

5. In startup.cs 'Configure' method, add the following 2 lines to initialise the resources.

var pathToResources = System.IO.Path.Combine(env.WebRootPath, @"Resources\Resources.xml");
Resources.i18n.InitResources(pathToResources);

NOTE: If you have more than one resource file, you can add multiple files as shown below (but don't copy for this tutorial, as we only have 1 resource file)

6. In views/home/index, remove the standard content and add the following (remember to replace 'Testweb.Resources' with you own website's namespace).

@{
    ViewData["Title"] = "Home Page";
}
<h4>English Site Name</h4>
<p>@Testweb.Resources.i18n.Site_Name</p>

<h4>French Site Name</h4>
<p>@Testweb.Resources.i18n.GetLocalisedStringValue(() => Testweb.Resources.i18n.Site_Name, "fr-FR")</p>

7. Run it to see the results.

More details

If you are unsure of how to set the culture, how to add more resource files or add more properties, see the detailed tutorial at github source readme.