Lizerium.Localization.Toolkit

All-in-one localization package for .NET projects that use .resx translation files.

It includes:

• Lizerium.Localization.Core as the runtime dependency;
• an incremental source generator that creates Generated.Localization.Localization;
• analyzer diagnostics for missing localization keys;
• a Visual Studio CodeFix that creates missing .resx entries from code;
• AI CodeFix support for normal and interpolated C# strings;
• WPF XAML runtime localization through {loc:Loc Key};
• optional Visual Studio inline hints for generated C# localization calls.

Install

<PackageReference Include="Lizerium.Localization.Toolkit" Version="1.0.0" />

Project Setup

<ItemGroup>
  <AdditionalFiles Include="Resources\Localization\*.resx" />
  <Content Include="Resources\Localization\*.resx">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </Content>
</ItemGroup>

Expected files:

Resources/
  Localization/
    Strings.en.resx
    Strings.ru.resx

Usage

using Lizerium.Localization.Core;
using L = Generated.Localization.Localization;

LocalizationService.Instance.Configure(
    Path.Combine(AppContext.BaseDirectory, "Resources", "Localization"));
LocalizationService.Instance.ChangeLanguage("en");

var title = L.MainWindow.Title();

For WPF XAML values, add the namespace:

xmlns:loc="clr-namespace:Lizerium.Localization.Core;assembly=Lizerium.Localization.Core"

and use RESX keys directly:

<Button Content="{loc:Loc MainWindow_Button_English}" />
<TextBlock Text="{loc:Loc MainWindow_Title}" />

For parameterized values, use _Format keys with placeholders:

<data name="MainWindow_Message_Format" xml:space="preserve">
  <value>Current folder: {0}</value>
</data>

CodeFix

Write the generated call first, then use Ctrl + . -> Create localization key. Calls with arguments create _Format keys and TODO {0} {1} placeholder values.

The AI CodeFix also appears on string literals and interpolated strings:

var text = "Hello World";
var details = $"Log directory: {AppContext.BaseDirectory} | {5}";

For interpolated strings, the resource value is stored as Log directory: {0} | {1} and the generated call receives the original interpolation expressions as arguments.

The NuGet analyzer reads AI server settings from environment variables:

LIZERIUM_OLLAMA_URL
LIZERIUM_OLLAMA_MODEL
LIZERIUM_OLLAMA_GENERATE_ENDPOINT
LIZERIUM_LIBRETRANSLATE_URL

Direct consumers of Lizerium.AI.LocalizationAssistant.Core can use AiLocalizationOptions instead of hardcoded URLs.

XAML Conversion

Lizerium.Localization.Core.XamlLocalizationService provides the shared conversion logic used by tooling:

var xaml = new XamlLocalizationService();
xaml.LocalizeText(
    "MainWindow.xaml",
    "English",
    "MainWindow_Button_English",
    "Resources/Localization");

It replaces XAML literals like Content="English" with Content="{loc:Loc MainWindow_Button_English}", adds xmlns:loc when missing, and writes keys to Strings.en.resx and Strings.ru.resx.

For an editor light bulb in Visual Studio 2022, build and install Lizerium.Localization.Xaml.Vsix. It offers Создать ключ локализации для XAML for selected XAML text or literal attribute values.

C# Editor Hints

For inline hints in C# files, build and install Lizerium.Localization.EditorHints.

src\Lizerium.Localization.EditorHints\bin\Release\net472\Lizerium.Localization.EditorHints.1.0.4.vsix

It shows .resx values next to generated calls such as L.MainWindow.Title() and writes diagnostics to %TEMP%/Lizerium.Localization.EditorHints.log.

Project repository: https://github.com/Lizerium/Lizerium.Localization.Toolkit

This site is open source. Improve this page.