Localization

Mark Moll edited this page Jan 28, 2018 · 6 revisions

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

Short and long term team goal

Lots of people are not comfortable with English. Our goal is to distribute Gephi in French, Spanish and other languages the community requests.

Translation guide

Get started!

  1. Create an account on Transifex.
  • Join the Gephi project.
  • Ask to be part of a Translation Team.
  • If no team for your language exists, please ask to create one on the forum.
  • When accepted, begin translating!

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 translations should be made on Transifex platform, otherwise they will be overridden.

Technical Details

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

Transifex allows us 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 retrieve 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 python set_transifex.py again 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

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.