Localization

Eduardo Ramos edited this page Jun 3, 2016 · 5 revisions
Clone this wiki locally

Gephi has a localization program to provide the software in your language: this page describes how to get in! We use the Transifex platform.

Short and long term team goal

Lots of people are not ease with English. The goal is to distribute Gephi also in French, Spanish and other languages the community will ask for.

Translation guide

Get started!

  1. Create an account on Transifex.
  2. Join the Gephi project.
  3. Ask to be part of a Translation Team.
  4. If no team is set for your language, please ask to create one on the forum.
  5. When accepted, start translating it!

Note: when you start to translate a resource, Transifex grants you a "write lock" on it for 48h. It means that you will be the only one able to edit this resource in your language during this period, thus avoiding conflicts.

Important Note: only English texts should be written directly in the .properties files. All the translations should be made on Transifex platform otherwise they will be overridden.

Technical Details

Language strings are stored in Bundle.properties files, the common format used in Java world. We want to keep this simple mechanism, as Gephi has more than 240,000 lines of code now. Luckily now Transifex supports properties files so we can synchronize them directly.

Transifex allows to manage the translation process: each language has a user interface, like the French one. Translators simply translate English strings on a web page. Once done, Gephi admins retreive the translated strings and push them to the Gephi trunk.

Workflow for admins

The Transifex client is available here. All the following commands are executed from the Gephi repository root.

Setup

Initialize Transifex for Gephi (done only once and for all):

  • Execute python set_transifex.py to scan recursively the Gephi repository and add Bundle.properites files to the local Transifex config file (in .tx/config).
  • Execute tx push -s -t to push sources and local translations (Bundle.properties files) to the Transifex platform.

Update template files

  • After modifying a Bundle.properties file or creating a new Gephi module, execute again python set_transifex.py to update sources configuration.
  • Execute tx push -s to push new and updated sources (Bundle.properties files) to Transifex platform.

Synchronize the repository

  • Execute tx pull -f to pull the translations (Bundle_.properties files) once translations are done. The local repository does now contain the up-to-date translations.

After removing a Gephi module

  • Delete the related lines in .tx/config
  • Manually remove its resources on the Transifex platform.

Tools

Common terminology

Read the Vocabulary page.

How to get in contact with the team

Forum

How to force UI language in Gephi

Go to gephi/nbproject/private, then edit platform-private.properties by adding the line (French for instance):

run.args.extra=--locale fr:FR

Netbeans Tips

Search for a string by doing Edit > Find in Projects (Ctrl + Maj + F), with the file name pattern *.properties.

Resources