Versions Compared

Version Old Version 14 New Version 15
Changes made by

Stefan Spiegel

Stefan Spiegel

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Handling Resx Files in Visual Studio

The MarineLMS.Web.Main project is currently the only project using resx files and translations with Sisulizer. Resx files in any other VS project are ignored.In  In general, you only need to pay attention to default (English) resx files in project MarineLMS.Web.Main. All translation (other language specific) resx files (translations) are maintained by Sisulizer. There are a few exceptions when adding new /or removing resx files (see below for more details). Changes /and updates of names/values within a translation resx file are ignored and overwritten by Sisulizer. Any update to a translation text must be done in Sisulizer instead. Having said that, changes to default resx files must be done in VS solution because Sisulizer uses all default resx files as truth (see 'Information Flow Between VS Solution and Sisulizer with Respect to Resx Files' below).

Sisulizer matches default resx values to allow translation of that value. That means a default resx value is treated as a read-only key by Sisulizer. If a resx file has moved but the values are the same, the translations known by Sisulizer remain and don't have to be translated again. However, if the default resx value changes, that value needs to be translated in Sisulizer as it shows up as a new (unknown) entry.

Important: Please let Stefan (stefan@marinels.com) know about any changes to/new resx files so he can run Sisulizer to update the translation resx files and get new text translated. This will keep Core up to date with any translations. 

Information Flow Between VS Solution and Sisulizer with Respect to Resx Files

...

Add new Default Resx File

If you need to add a new resx file needs to be added, only add the default resx file only (i.e. AssessmentSelectorControllerRx.resx). Any translation resx files and their names/values are handled/created by Sisulizer (i.e. AssessmentSelectorControllerRx.fr-CA.resx and AssessmentSelectorControllerRx.en-US-Disney.resx).

Note: Sisulizer generates the translation resx files for any new default resx file. The translation resx files need to be added to the VS solution once (see Update Resx Files and/or Create Translations for Core).

Edit Existing Resx Name/Value

...

Trips and Pitfalls

  • Make sure that the default resx file and their translation resx files have the same Custom Tool Namespace and Custom Tool = PublicResXFileCodeGenerator (the designer resx file must exist)

...