Localizing Tunnelblick

Localizing Tunnelblick

This document gives an overview of the old way to localize Tunnelblick.

For an overview of the new way to localize Tunnelblick, see Localizing Tunnelblick.

For instructions on editing the .strings files, see Translating .strings Files.

For notes about specific strings that are being translated, see Translation Notes.

How Localization Work in Tunnelblick

Although some applications have elaborate structures to specify translations, Tunnelblick's is simple:

• Inside of Tunnelblick.app there is a folder for English and a folder for each language that has been translated.
• Each of these folders contains a "Localizable.strings" file for the language. That file is used "on-the-fly" to translate the Tunnelblick application's strings, which are in English, to the language specified in the user's System Preferences.

Most language folders have as a name the ISO-639-1 two-letter abbreviation of the language and an extension of "lproj". For example, "JA.lproj" is the folder with Japanese strings, "ES.lproj" is the folder with Spanish strings, etc. One exception is English, which is named English.lproj. That is because Tunnelblick's original development language was English. Other exceptions include "ZH_CN.lproj" for simplified Chinese and "ZH_TW.lproj" for traditional Chinese.

NOTE: Prior to Tunnelblick versions 3.0b24, all .lproj folders had the English name of the language, instead of the ISO-639-1 two-letter abbreviation of the language.

Adding Your Translations to Your Copy of Tunnelblick

If you made the first translation of a language, here's how to put your modified Localizable.strings file into your copy of Tunnelblick:

1. Look up the ISO 639-1 two-character abbreviation for the language. You can do that at https://www.loc.gov/standards/iso639-2/php/code_list.php.
2. Create a folder on your Desktop named with the two-character abbreviation followed by ".lproj" (e.g., "CA.lproj" for Catalan/Valencian)
3. Put the Localizable.strings file that you have modified in the folder
4. Get a fresh copy of Tunnelblick (one that has never been used; copy from a downloaded disk image file if necessary) and put it on your Desktop
5. Control-click on the Desktop "Tunnelblick.app" and click on "Show Package Contents". A new Finder window will appear
6. Double-click on "Contents" in the new window. The window should now show several items
7. Drag the folder you created in step 2, above, and drop it on "Resources"
8. Close the Finder window

You're done. The copy of Tunnelblick.app on your Desktop now has your translations.

Note: This process invalidates Tunnelblick's "digital signature", and you will be warned about it being a modified version of Tunnelblick. If you have added translations, you are encouraged to submit them to be included in Tunnelblick; contact the developers.

If you edited an existing translation, here's how to put your modified .strings file into your copy of Tunnelblick:

1. Put the Localizable.strings file that you have modified in the folder
2. Get a fresh copy of Tunnelblick (one that has never been used; copy from a downloaded disk image file if necessary) and put it on your Desktop
3. Control-click on the Desktop "Tunnelblick.app" and click on "Show Package Contents". A new Finder window will appear
4. Double-click on "Contents" in the new window. The window should now show several items
5. Double-click on "Resources". The window will now show several (different) items.
6. Double-click on the .lproj folder of the language you have translated
7. Drag the Localizable.strings file you have modified into the window. Tell Finder to replace the existing Localizable.strings file when you are asked
8. Close the Finder window

You're done. The copy of Tunnelblick.app on your Desktop now has your translations.

Note: This process invalidates Tunnelblick's "digital signature", and you will be warned about it being a modified version of Tunnelblick. If you have added translations, you are encouraged to submit them to be included in Tunnelblick; contact the developers.