How To Localize UML Modeling Module

Latest Updated: 30 April 2007

Introduction

• UML Modeling Module provides UML modeling features to the NetBeans IDE. These features include forward and reverse engineering, markerless code generation, support of eight different diagrams, requirements gathering, predefined and extensible Design Patterns, and ability to generate Javadoc-style web reports from models. The module allows analysts and designers to design applications using a standard modeling language. Developers are then able to generate source code from the UML model and update the model from changes made in their source code.
• This documention is a basic guide for helping you to translate UML modeling module into new language.
  

Getting the english source for translation

• The source is provided as a zip file(properties and html compressed): uml-55-l10nkit-ui.zip
• This zip file only includes UI message files.

Tips in translation

#1 .properties file:

• insert the suffix into file name, e.g. for zh, Bundle.properties -> Bundle_zh_CN.properties.
• Run native2ascii to covert the file to Unicode escaped format

#2 .html file in UI message source kit:

• insert the suffix into file name, e.g. for zh, help.html -> help_zh_CN.html.
• use native encoding, e.g. for zh, use GB2312 as encoding and charset .
  

#3. don't translate these messages

#4. You can use your own tool for localization, but most users in this project are using OmegaT. Please try the page for your evaluation.

Local build

You can build localized jar files in your locale environment and copy them to netbeans for verifying the translation in IDE. The detail steps are below:

1. install netbeans 5.5 or 5.5.1
2. download and install UML from Update Center
3. download uml-55-local-build.zip and unzip it locally
4. copy the translated files to translatedfiles/src/uml
5. edit translatedfiles/build_uml.xml at line 30 to add "your language" , e.g. replace "ja,zh_CN" with "de" to add German
6. go to translatedfiles, run build script ant -f build_uml.xml
7. uml-ml-YYMMDD.zip created in current dirctory
8. copy zip file to netbeans user directory(~/.netbeans/5.5 or ~/.netbeans/5.5.1), unzip it.
9. restart the IDE

Contributing your files to release55 branch

• If you have Developer role, you can commit your files into cvs.
• If don't, please send zip file to  dev@translatedfiles.netbeans.org.

Getting the daily build to test

1. go to Netbeans Development Downloads
2. select "5.5" and "daily", click "Continue" button
3. click "continue" link of fresh IDE build
4. scroll down the page to "Downloads Sources and Extras" - "nbm_pack_uml"
5. download the zip file, unpress it and install nbms manually

Note: Please uninstall UML module before you install the fresh one. see below for detail steps,

1. Uninstall UML module
   • select menu "Tools" -> "Module Manager"
   • click "UML" module to be highlight, click "Uninstall" button
2. Install fresh UML module manually
   • select menu "Tools" -> "Update Center"
   • select "Install Manually Downloaded Modules(.nbm Files)." , click "Next"
   • click "Add..." button
   • find and select all nbm files you just downloaded, click "Next"
   • click "Next", accept all four License Agreement
   • click "Next"
   • click "Finish"
   • restart IDE

Translation Status and Validation

Please check the status page about which files are already translated and the validation page to find errors/warnings in your localized .properties files.

Test Case

Developing Applications Reverse Engineering Java Applications Creating Use Case Diagrams Creating Activity Diagrams

Creating Class Diagrams Creating Collaboration Diagrams Creating Sequence Diagrams

Q&A

Since the process of localizing UML Modul is almost the same as netbeans, if you have any question, you could get the reference from the netbeans localizing how-to page below or send your questions to dev@translatedfiles.netbeans.org

• http://translatedfiles.netbeans.org/
• http://translatedfiles.netbeans.org/index-l10n.html
• http://translatedfiles.netbeans.org/5.5/index.html
• http://translatedfiles.netbeans.org/docs/HOWTOs/How-to-translate-overview55.html

---