Localizing
What Is SparkleDotNET? | The End User Experience | Using SparkleDotNET | Signing Your Updates | Info.plist Keys | Generating an Appcast | Anonymous User Profiles | Letting Your Users Customise SparkleDotNET | Localizing SparkleDotNET
The aim is to have SparkleDotNET localized in as many languages as possible. As SparkleDotNET is build upon KNFoundation, this is a very easy process. If you'd like to add a language to SparkleDotNET, please do - we'd really appreciate your input.
First, clone the SparkleDotNET repository to your system and open the project in Visual Studio.
Expand the "Localization" folder and duplicate the "Sample Strings" folder. This duplicate contains the files you work with as you translate the strings into your chosen language.
Next, you need to rename the duplicated .resx files to include the name of the language you're adding just before the .resx extension.
For example, a British English translation would see the file SparkleStrings.resx be renamed SparkleStrings.en-GB.resx, and a German translation would be SparkleStrings.de-DE.resx for the German dialect used in Germany, or just SparkleStrings.de.resx for generic German. The the example below, I've renamed the files for the dialect of French as used in France.
When you've renamed the files, open them and start translating! The "Name" column should not be changed - this is how SparkleDotNET looks up which string to use. Only translate the strings in the "Value" column.
It's important to note that you shouldn't translate any part of the row named "KNStringTableRepresentedClass". This is required to stay the same for SparkleDotNET to be able to apply the localisations correctly.
Once you've finished, you need to move your new strings files into the "Actual Strings" folder. Unfortuntaely, this folder will end up with hundreds of strings files in it, but as far as I can tell this is the only way to get .NET to pick them up correctly.
Finally, you need to test your translations. Open the "Region and Language" control panel and in the "Keyboards and Lanugages" tab, change your display language to the language you've translated to (if it's not the lanugage your system is already in).
Make sure you do a Build -> Clean Solution in Visual Studio before running SparkleDotNET. Hopefully, it'll all work!
