msg-systems/wpf-gui-localizer

.NET Library to add/edit translations of WPF-Applications from within the UI during runtime.

!!This library is still under development!!

WPF-GUI-Localizer

Introduction

This library tackles the problem many software projects face: Translations are translated in form of tables, outside of the actual application, lacking the context given inside the application. The library offers the functionality to alter translations at runtime as presented in the application using a pop-up window, as shown below.

It comes along with the ability to localize WPF applications using either human-readable Excel files or traditional Resources (.resx) files.

Install

The WPF-GUI-Localizer library can be installed through NuGet.

Additionally both the .NET Framework version 4.7.2 or higher as well as Excel have to be installed.

Trying out the library

You can run an example application with this library already integrated in the Examples folder of this repository (no IDE required).

Alternatively you can open the WPF-GUI-Localizer solution in an IDE and run or debug the Example_Excel and Example_Resources projects.

Or read more about how to get set up with your own application here or check out the quick-start-checklist for either Excel based localization or Resource file based localization.

Documentation

The full documentation can be found here

License

The WPF-GUI-Localizer library is licensed under the MIT License. See the file LICENSE for more details.

---

Authors: Martin Fabian Thomas, msg systems ag, Fabian Lewalder, msg systems ag

wpf-gui-localizer's Issues

Analyze upgrade to .NET 5.0

The library was developed primarily for the .NET Framework (4.7.x).
Since .NET 5.0 (and later 6.0) came out in the meantime, we should analyze the effort needed to migrate to .NET 5.0.

Error in ExampleView.xaml in the sample Example_Resources

When I open the XAML designer I get the following error but the app is building correctly and working.

The Instance Property was accessed without calling a LiteralProviders Initialize function beforehand. (screenshot below). Is there an easy fix ?

I take the opportunity of this issue to ask if the project is still in dev and what would be the complexity of adding database support as a resource provider ?

Create release plan

Since we are live on the usual platforms, we should plan how to proceed from here:
In which cycles do we want to deliver new Minor/Major Versions?

[Suggestion] Replace dependency on installed Microsoft Excel

With the NPOI library you can read/write Office documents easily without any dependency on an installed Office-Product. That might be a good replacement for the current dependency on an installed Microsoft Excel on the machine. Already using it in one of our projects successfully, the implementation is really straight-forward.