WinSCP Translation How To

When you want to start a translation, contact me. Send me your name, contact email address and the language you want to work on. Also specify, whether you want your email address to be published on the translations page. Optionally I may display your URL instead of your email. Note that I may provide your email address to other translators of the same language (if any) without explicitly asking you.

If I need your help (the language is either not being translated at all or there is still lot of work to do on it or the translation is abandoned and I need a maintainer for it), I’ll create a translator account for you. Your username is always your e-mail address.

Once you have a translator account, you may login to the translation web-interface. Once there, download INI file with strings to translate.

Format of the file is like the INI file, for example:

; file comment
[file]
; "original english string"
key="translated string"
; "original english string2"
key2="translated string2"

Where the file is either a form (dialog) definition (.dfm extension), a resource strings file (.rc extension) or strings for setup application (.isl extension). The key should give you some idea about the purpose of the string. For the form definitions it is a context and the name of a component using the string. The strings that need to be translated have the keyword <translate> instead of “translated string” (initially all strings).

Example:

[SiteAdvanced.dfm]
MainPanel.PageControl.ScpSheet.ShellGroup.Caption="Shell"

The “Shell” is the title (caption) of the shell group box on SCP/Shell page of Advanced Site Settings dialog.

Section [default.isl] contains general strings for the setup application (Inno Setup). The application has already been translated to several languages. If your language is among them, I’ll copy the translation to this section. Please check for typos and other mistakes in this section.

Use UTF-8 encoding when editing the INI file.

Some strings contain parameter placeholders like %s or %d. These are replaced by the actual value at run-time. Make sure that you keep the same order as in the English string. I know it can be difficult sometimes, because some languages have different word-orders, but it has to be so. Also translated strings should have approximately the same length as the original string. This applies mainly for strings that appear on dialogs. The error messages etc, might be usually as long as necessary.

Some strings use the & character to mark the accelerator character (the one after &). When the user presses Alt+X, where X is the accelerator character, the associated control (button, edit box, menu, etc.) receives the focus (cursor moves to it, etc.). The accelerator character should be unique for each screen (window). It can be difficult to maintain this also, as the dialogs often use strings from different sources. So you’ll probably require several attempts to get it right.

Also, please, if you encounter strange sequences like #13#10, include it in the translation too. For these strings I recommend that you to copy the English one and replace the words only, keeping the “strange” patterns. Please never use double quotes ("), use always single-quotes ('), following the way the original English string is written. Double quotes are used to mark the beginning and the end of the string.

In section [TextsWin1.rc], the first two strings have the keys TRANSLATOR_INFO and TRANSLATOR_URL. They will appear on the About dialog. You may include there anything you want. Such as, “Translation © 2009 Your name”, or anything else. For URL, you can use both HTTP URL and e-mail address.

You do not have to translate all the strings at once. You may translate them in any number of steps. Upload, what you have done so far to translation web-interface. I’ll do regular updates of the translation DLLs.

You can generate translation DLL on your own to test the translation before uploading. For that download “Translator” tool from translation web-interface. Extract the downloaded ZIP file and follow instructions in contained readme.txt file.

Read documentation.

Translations are also stored on the project CVS. CVS is updated in regular intervals (every few hours).

Use CVS only to access historical translations. To download the current translation, always use translation web-interface. The web-interface updates the most recent translation (as stored on CVS) on-the-fly to the last WinSCP version, e.g. it adds new strings to translate (that did not exist, when the translation was updated the last time), removes obsolete strings, etc.

See project page on SourceForge for learn how to access CVS.

In addition to translating the application itself you are welcome to prepare a localised introduction page for the WinSCP documentation.

For a start there is simple template (in English) covering the very basic information about WinSCP. However you are welcome to go more into details. Also if you know of or maintain personally a site in your language about WinSCP, you are welcome to link it.

To create the translated introduction page type URL http://winscp.net/eng/docs/lang:<lang> where <lang> is your language ID (i.e. extension of the translation DLL) and press the Create this page button on the right.

Do not add another localized pages apart from the introduction one.

To start you may copy the source of the template page (open it, press Edit this page and copy the content). But remove the NOINDEX directive (which prevents search engines indexing the template) and all footnotes (in double round-brackets).

Before editing, create an account for the wiki. Firstly, you will receive some credit for your contributions. Secondly, I will be able to recognise your edits from wiki vandalism. Wiki authentication is linked to support forum, so in fact you need to register on the forum.

As a last step, add your language (local name, not in English) to a list to give me a hint about the title of the language icon (flag).

Once you have created the localized version I’ll give it a shortcut address in the form http://winscp.net/<lang>/ and add the “flag” link to the page header. Also address http://winscp.net/ will automatically redirect to the localized page, if browser/visitor has the corresponding language set as preferred.

If I do not do so, it may be because your translation does not qualify for public usage yet due to some shortcomings and I had have no means to contact you, because you have not registered. Then, please post a message on support forum.

You are also welcome to register on support forum (if you have not done already to create an introduction page) to become a translation forum moderator. If you send me your login name, I’ll grant you a moderator status and tag your account as “Translator”. You will have rights to moderate (delete, edit, etc.) posts in the forum.

There is already dedicated thread for each language. Please keep with the thread, unless you have a good reason to start a new one.