Localization best practices for Dynamo developers

Add localizable resources to a new project

Making a project localizable includes the following steps:

• Adding *.resx and *.en-US.resx files to project
• Updating AssemblyInfo.cs of the project
• Referencing the string resource in *.cs files
• Referencing the string resource in *.xaml files

These steps are detailed in the following sections.

Adding *.resx and *.en-US.resx files

TODO: Add images for steps to add these files...

Note that both *.resx and *.en-US.resx files must always be kept completely in-sync. The process of updating these files typically includes adding the desirable strings into *.resx file, and then copy it to overwrite *.en-US.resx file. This way they are always 100% identical.

Updating AssemblyInfo.cs file

With *.resx and *.en-US.resx files added to the project, the AssemblyInfo.cs must be updated to specify a fallback assembly in the event that a desirable localized *.resources.dll cannot be found during runtime (typically the fallback is on en-US resources). This can be done in either of the following ways.

Option 1

This is the preferred way for any development work under DynamoDS/Dynamo repository. In addition to the existing Properties/AssemblyInfo.cs file that came with the project, add a link reference to AssemblySharedInfo.cs file at this location:

Dynamo/src/AssemblySharedInfoGenerator/AssemblySharedInfo.cs

Having this reference ensures that the version number always matches that of the main Dynamo build. This is how a link reference can be added:

TODO: Add an image with screenshot

Option 2

If for some reason Option 1 is not feasible, then the existing Properties/AssemblyInfo.cs can be updated by adding the following line:

//In order to begin building localizable applications, set 
//<UICulture>CultureYouAreCodingWith</UICulture> in your .csproj file
//inside a <PropertyGroup>.  For example, if you are using US english
//in your source files, set the <UICulture> to en-US.  Then uncomment
//the NeutralResourceLanguage attribute below.  Update the "en-US" in
//the line below to match the UICulture setting in the project file.

[assembly: NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.Satellite)]

Referencing the string resource in *.cs files

To reference a string by its ID SettingsMigrationDialogTitle in a CSharp file, do this:

string dialogTitle = Properties.Resources.SettingsMigrationDialogTitle;

Referencing the string resource in *.xaml files

To reference the same string in *.xaml file, do this:

<Window xmlns:p="clr-namespace:Dynamo.Wpf.Properties"
        ...
        Title="{x:Static p:Resources.SettingsMigrationDialogTitle}" 
        ...>

    <Button Content="{x:Static p:Resources.MigrationAcceptButton}" ... />

</Window>

Updating resources of an existing project

Miscellaneous

Use string.Format instead of string concatenation.

Adding description for a NodeModel

1. Move Get a color given a color range string into the corresponding *.resx file.
2. Give an Id of ColorRangeDescription to the newly added string.
3. Copy the *.resx file to overwrite *.en-US.resx file so they match up.
4. Add a NodeDescription attribute like so:

[NodeDescription("ColorRangeDescription",typeof(DSCoreNodesUI.Properties.Resources))]
public class ColorRange : NodeModel
{
    // ...
}

3. Adding search terms for a NodeModel
4. Localizing enum values for display