Reunion 9 Localization

Reunion 9 supports International Localization.

Some translations have already been completed by Reunion users:

• Dutch (version 8 & 9)
• French (version 8 & 9)
• German
• Norwegian
• Swedish

Note: Because the translations are created by Reunion users and not Leister Productions, we cannot verify the accuracy or quality of the work.

Technical Information

The localization technology in Reunion 9 permits cosmetic adjustments to Reunion without actually altering the features and functions of the application. When a localization folder (or .lproj folder) for your language is placed inside your Reunion application, Reunion will try to use whatever resources it finds in this localization before using the resources in the default English localization, included in the released version of Reunion 9. Resources are items such as windows, menus, and text strings used in messages and reports. A localization only changes the Reunion interface (e.g., top menu bar, tool bar, button labels, etc.). The inner workings of the Reunion application are not affected.

Why would someone want to use a Localization Folder?

• To support other languages.
• To create custom narrative event formats
• To change defaults, such as the "& " string placed between couples.

Why create a new localization rather than modify the English one that is already included?

• Localizations can be selected by changing the order of the languages in the OS X International Control Panel.
• Localization folders are very small because they only contain the resources that are different from the English version.
• It's easy to share .lproj folders. If one person translates Reunion for a particular language, others can benefit.

How to create a Localization for Reunion 9...

• Visit Apple's Developer Page, and read about Internationalization and Localization.
• Download and install Apple's xCode Tools.

  You may prefer to use iLocalize -- however, the instructions on this page do not include the use of iLocalize.

• Download the Resource Minder application.
• Download and install the latest version of Reunion 9.
• From the Finder, control click on the Reunion 9 application and select "Show Package Contents."

  

• A new Finder window will open showing the Contents folder that is located inside the Reunion 9 application. Double-click this Contents folder, then double-click the Resources folder and locate and select the English.lproj folder.
• Choose File -> Duplicate (CMD-d) to duplicate the English.lproj folder, and rename the duplicated folder (English.lproj copy) to your desired localization.

  For example: Dutch.lproj, French.lproj, German.lproj, Italian.lproj, Spanish.lproj or Japanese.lproj

  

• Double-click this new folder to reveal the files to be localized.

  

Not all files need to be localized. To edit a file, simply double-click it to open the appropriate editor. There are three kinds of files to be edited:

• DefaultFields.rtf - Opens in TextEdit. This file is used to create the default fields when a new family file is created. Make sure that the TextEdit window is wide enough to prevent the lines from wrapping.
• .nib files - Open in Apple's Interface Builder (or iLocalize), which came with the xCode Tools. These files contain windows and menu bars.
  Note: .nib files that begin with 'doc' contain nothing to localize.
• .resm files - Open in Resource Minder. Only the text that appears in the 'Resource Data' window needs to be localized.
• After your .lproj folder has been localized, you should make that folder available to your users along with instructions on how to install the localization into the Reunion 9 application.