ASP.NET Core App Translator

This app helps you generate translated .cshtml files and resources files.

How to install

Requirements:

1. .NET 8 SDK

Run the following command to install this tool:

dotnet tool install --global Aiursoft.Dotlang

How does it works

• Find all files ends with .cshtml
• foreach cshtml file, replace all text in tag sround with @Localizer[""]
• Call bing translate API to translate all those content
• Save the translated file as Resource file in the Resources folder.

The Core Translator won't override any existing translation nor resources files. If your content was already surrounded with @Localizer[""], we won't touch it.

How to run locally

Build:

dotnet pack

Install:

dotnet tool install --global --add-source ./nupkg dotlang

Run:

# In your project folder
$ dotlang

Uninstall:

dotnet tool uninstall -g dotlang

Before running the translator

• Follow the document here ASP.NET Core Localization

Use the following code to register the localizer service:

// In StartUp.cs ConfigureServices method:
services.AddLocalization(options => options.ResourcesPath = "Resources");

services.AddMvc()
    .AddViewLocalization(LanguageViewLocationExpanderFormat.Suffix)
    .AddDataAnnotationsLocalization();

Use the following code to add localizer middleware:

// In StartUp.cs Configure method
var SupportedCultures = new CultureInfo[]
{
    new CultureInfo("en"),
    new CultureInfo("zh")
};
app.UseRequestLocalization(new RequestLocalizationOptions
{
    DefaultRequestCulture = new RequestCulture(defaultLanguage),
    SupportedCultures = SupportedCultures,
    SupportedUICultures = SupportedCultures
});

Use the following code to inject localizer:

@using Microsoft.AspNetCore.Mvc.Localization
@inject IViewLocalizer Localizer
@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers

Now run this app!

Caution

Running this under your project folder may ruin your project! It may change your cshtml! Do run git commit under your project before running this app.