Localisation Instructions Print button

This guide will help you to translate My Family Tree in to your language.

1. Getting started

  • Download the My Family Tree Localisation Toolkit.
  • Extract the files to a folder on your computer.

    Files included in the toolkit

  • If a partial translation does not already exist for your language, make a copy of the 'Resources.xx-XX.resx' file replacing 'xx-XX' with the language code of the translation.  A full list of language codes can be found here.
  • Double click on the 'Resx Editor.exe' and click the open icon open icon image and select both the original 'Resources.xx-XX.resx' and your newly created resx file (hold the Ctrl key down to select multiple files).
  • This will load all the text for translation alongside the original English translation.

    Files ready for translation

2. Making the translation

  • To translate a value, double click the relevant cell, clear the English text and enter the translated value.
  • Once a value has been changed, the cell will change colour.  Remember to regularly save your changes.

filter Be sure to read the translation tips section before you get started.

4. Relationship Calculator

  • The Relationship Calculator often requires special logic to correctly handle culture specific ways of describing relationships between people.
  • To ensure this feature of the application works as expected, you should refer closely to the details contained in the Relationship matrix file.

5. On This Day

  • Translators do not need to translate the On This Day database.

6. Testing translations

  • Once your translations are complete, compress the new .resx file in a zip archive.
  • Please contact support for instructions on how to send your translations to us.
  • Once we receive your translations we will being testing them and discuss any issues or corrections before supplying a compiled translation for testing prior to release.

Important tips

  • Review the Microsoft™ Style Guide for your language from the Microsoft Language Portal.
  • Review the GEDCOM specifications for the meaning of GEDCOM specific phrases.
  • The first part of the key describes the view where the string is used in the user interface.  The second part of the key describes the text of the key.  For example, the 'ExportImageDialog_Instructions' key refers to the insturctions text on the export image dialog.  Keys which do not have two parts are generally enumerations which are reused across different views.
  • Translate the English text associated with the key rather than the key itself.  For example with the 'ExportImageDialog_Instructions' key, translate the phrase 'Save a copy of the chart as an image.' rather than the key's short hand description of this text 'Instructions'.
  • Check the comment box before translating.  The meaning of special comment codes are shown below:

    CodeMeaning
    ****An untranslated string.
    MFTThe phrase 'My Family Tree' should not be translated.
    CSThe phrase 'Chronoplex Software' should not be translated.
    GEDCOM/LDS   A GEDCOM/LDS specific phrase.  Check the GEDCOM specifications for the translation context.
    GBA phrase which takes a slightly different spelling in non-US English.
    Language codeThis key is only translated for the specified language.

  • New strings which have been added for later versions are simply recorded as **** in partial translations.  You can quickly filter missing strings using the filter button or highlight them using the highlight button.
  • Preserve the case of the words as appropriate for your language e.g. 'Date of Birth' may not be the same as 'Date of birth'.
  • Preserve punctuation e.g. ? . , ( ) as appropriate for your language.
  • Some text is repeated several times throughout the program.  Single click on the Resources.xx-XX.resx column header to sort the strings.  Any groups of identical strings should have the same translation.

    Same translations

  • There are several strings which contain curly brackets and numbers e.g. {0} or {0} {1}.  These represent variables which will be inserted into the string e.g. 'A father {0} times' becomes  'A father 6 times'.

    It is vital that these remain in the translations.  Depending on the language, the position of these may need to change e.g. '{0}'s mother' in English may become 'Madre de {0}' in Spanish.

  • For all other queries, please contact support.