Project Wizard - Visual Studio .NET solution file

Use this sheet to set the options how to localize a .NET solution file.

Exclude all but string types

If checked only strings data types are shown on the edit sheet. All other types are excluded. You can later changed excluded types from source 's property dialog.

Items that localized resource files contain

Specifies what resource items are written to the localized resource files. Possible values are:

If you keep the default value, Translated, Sisulizer can greatly optimize the size of the resource files. This also will fully enable the build-in language fallback of the platform where you application runs. If you choose All no runtime language fallback is done but fallback is done by Sisulizer on build process. We recommend to use either Translated of Different to enabled optimization and language fallback of the platform. When localizing XAML this options is only used with resource dictionaries. All other XAML resources will always contain all items.

Right to left layout and Set reading order property

Together Right to left layout radio group and Set reading order property check boxes specify how user interface should be modified when localizing to bi-directional languages such as Arabic, Hebrew and Persian. Depending on your platform you should set the check boxes in a different way.

Sort items

If checked Sisulizer adds the resource items alphabetically to the resource string node. If unchecked the items are added in the same order as they appear in the original file. Only used with .resx resources.

Normalize white spaces

If checked Sisulizer normalizes the white spaces in the element contents. This means removing multiple soft white spaces between each words. For example if you have following XAML

<Label>This    is    a     sample  text.</Label> 

NewTool will extract the value as "This is a sample text." instead of "This     is    a     sample text.".

Combine Run, Span and text elements

If checked Sisulizer combines Run, Span and text elements that are sub elements of TextBlock. For example if we have

<TextBlock>This is a <Span>simple</Span> <Run>sample</Run>.</TextBlock>

then what is scanned depends in the value of the check box.

Private resources in satellite assemblies

If checked Sisulizer makes resources in satellite assemblies private.

Delete .resources files after the build process

If checked Sisulizer deletes the created .resources files after the build process.

Add language part into name of localized resources

If checked Sisulizer adds language specific part into the names of all localized resources. If unchecked Sisulizer adds culture specific part into the names of those resources that require it. The standard resource types such resources are ResX resources and XAML resources required the language part.

Let's have an example. You have embedded image resource called MyApplication.MyImage.png. When you read the image data on runtime you use "MyApplication.MyImage.png" name. If you check the check box Sisulizer will rename the resource in the localized satellite assembly file. The German assembly file will have MyApplication.MyImage.de.png" and Japanese file will have "MyApplication.MyImage.ja.png". In order to correctly read the image data your code must change the name it uses depending on the active locale. If you do not want this make sure that the check box is unchecked. In that case the satellite assembly files will all have the resource with the same name ("MyApplication.MyImage.png").

Compile main assembly file if it does not exist

If checked Sisulizer compiles the main assembly file before building localized files if the main assembly files does not exist.

Compile resource files

If checked Sisulizer compiles resource files (from .resx or .txt to .resources) when building localized files.

Compile on by one

If checked Sisulizer compiles resource files one by one instead of multiple together. Check this if either XAML or ResX compilation fails.

Use compatible MsBuild

If checked Sisulizer use most recent MsBuild when compiling XAML files belonging to a projec tusing tools version 14 or later. Check this if the XAML compilation fails.

Create satellite assemblies

If checked Sisulizer creates satellite assemblies when building localized files.

Delete localized .resx files after the build process

If checked Sisulizer deletes the created .resx or .txt files after the build process.