Join GitHub today
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.
- 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.
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.
Initialize Transifex for Gephi (done only once and for all):
python set_transifex.pyto scan recursively the Gephi repository and add Bundle.properites files to the local Transifex config file (in .tx/config).
tx push -s -tto 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.pyagain to update sources configuration.
tx push -sto push new and updated sources (Bundle.properties files) to Transifex platform.
Synchronize the repository
tx pull -fto 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.
- Translation memory to search in past open source translations with Open-tran
- Automatic translation with Wordreference or BabelFish
Read the Vocabulary page.
How to get in contact with the team
How to force UI language in Gephi
gephi/nbproject/private, then edit platform-private.properties by adding the line (French for instance):
Search for a string by doing Edit > Find in Projects (Ctrl + Maj + F), with the file name pattern *.properties.