Localization

How to Prepare an Ideal Localization Kit

Localization

Introduction to Localization Kit

Whenever undertaking a new project, and regardless of who will be performing your localization, the first thing to do is to create a complete localization kit and a localization project Bill Of Material (BOM).

What is a BOM?

A BOM is a localization kit containing all the files that need to be localized, with accurate instructions and any support documentation that can be helpful to the localization team.

The list below includes a comprehensive catalog with the latest technology and file formats that are typically needed in a localization kit:

1. Graphical User Interface (GUI) Files

These files from your software application contain the string tables and dialog coordinate information that the software uses to display the interface to the user. These files can come in many formats (such as Microsoft resource files (.rc), ASP.net (.resx), binary (.dll or .exe), .po, .java, .properties, PHP, and XML. Be sure that all the needed files are identified and collected.

2. Online Help Files

These are HTM, XML, or other formats that will provide the user with online instructions when they click on the help buttons in the software. Here, it is best to collect all the source files (XML, HTM, and image and project files) that are needed to recreate the help. If they are not available, the compiled help (.chm or .hlp) can be used to recreate them. It is always best to translate source files, such as the XML files that the help authoring tool uses to generate the HTM files.

3. Manuals

These are the guides (User, What’s New, Getting Started) tutorials, and any other manuals that need to be localized. They often are authored in a desktop publishing tool such as FrameMaker, InDesign, Quark, or MS Word. All source files will be needed and preferred over PDF. Make sure you include any images, fonts, and other support files that are needed to allow another party to open the files correctly.

Note:

If only the GUI requires localization, it is recommended to include still the online help and all support manuals as reference material to the translators so that they can better understand the functionality of your software and translate it correctly. This will significantly improve the end quality of your localized GUI and minimize linguistic Quality Assurance (QA) at runtime.

4. Miscellaneous Files

This could include the installation scripts, license agreements (EULA), Readme, release notes – any support documentation that you package with your software and expect the user to read when they install, run, or operate your software.

5. Web files

If you are localizing a website, or if the application is web-enabled, identify and collect the entire set of files that are needed to run the website. This includes databases, images, Flash, Java scripts, HTM, ASP, PHP, PDFs, and all other source files requiring localization.

6. Marketing Collateral

To properly address the marketing requirements, you should obtain and provide the source files in QuarkXPress, InDesign, PowerPoint, MS Publisher, MS Word, or any other authoring system the collateral was authored in. Make sure you include all special fonts and necessary art. Art should be provided in its native format, like Illustrator or Photoshop (EPS). If containing text, text should be in separate layers from the bitmap images to avoid image quality degradation.

7. Multimedia/e-Learning

Include all audio, video, Flash, transcripts, timing reports and any additional requirements specific to video formats, file formats, and details on voice-over, dubbing, subtitling and video processing.

List and document what all the files are and include all pertinent info to your localization team about your needs and requirements. Then compress them all into one zip, sit, tar or rar file while keeping the naming and directory structures intact. With that, you will be the proud creator of the ideal localization kit.

Conclusion

A localization kit requires many specialized files listed in this article for a successful localization project.

By Nabil Freij
Global Vision

MORE INFO

Localization – Problem with Translating Phrasal Verbs
Localization — Don’t Use Phrasal Verbs in Your Technical Documents
The Difference Between Globalization vs. Localization
Free Articles on Localization and Translating Technical Documents
How to Prepare an Ideal “Localization Kit”
Qualified Translators a Must for Product Localization