Bureaucrats, editor, reviewer, Administrators
13,550
edits
Changes
Jump to navigation
Jump to search
→Updating BaseX.jar
It describes how to translate BaseX into other (natural) languages.
Thanks to the following contributors, BaseX is currently available in 10 languages: * '''Dutch''nine': Huib Verweij* ''' languages, namely Dutch, English, ''': BaseX Team* '''French, ''': Maud Ingarao* '''German, ''': BaseX Team* '''Hungarian''': Kiss-Kálmán Dániel* '''Indonesian''': Andria Arisal* '''Italian, Indonesian, ''': Massimo Franceschet* '''Japanese, ''': Toshio HIRAI and Kazuo KASHIMA* '''Mongolian, ''': Tuguldur Jamiyansharav* '''Romanian''': Adrian Berila* '''Russian''': Oleksandr Shpak and Romanian.<br/>Max Shamaev* '''Spanish''': Carlos Marcos
It is easy to translate BaseX into your native language! This is how you can proceed:
==Working with the sources==
If you have downloaded all BaseX sources via [[IntegrateDeveloping with Eclipse|Eclipse]] or [[Maven|MavenGit]], you may proceed as follows:
All language files are placed in the <code>[https://github.com/BaseXdb/basex/tree/master/basex-core/src/main/resources/lang src/main/resources/lang]</code> directory of the main project:# Create a copy of an existing translation file (e.g., <code>English.lang</code>) and rename it to your target language (e.g. <code>Hawaiian.lang</code>).# Enter your name and contact information in the second line.
# If you are using Eclipse, refresh the project (via ''Project'' → ''Refresh''); if you are using Maven, type in {{Code|mvn compile}}. Your new language file will be automatically detected.
# Start the BaseX GUI, choose your language via ''Options'' → ''Preferences...'' and close the GUI.# Translate the texts in your language file and restart BaseX in order to see the changes.# Repeat the last step if you want to revise your translations. If new strings are added to BaseX, they will automatically be added to your language files in English. The history view in GitHub is helpful to see which strings have recently been updated to a file.
==Updating BaseX.jar==
You may can directly add new languages to the JAR file. JAR files are nothing else than ZIP archives, and all language files are placed in the <code>lang</code> directory int into the JAR file:
# Unzip an existing translation file (e.g., <code>English.lang</code>) and rename it to your target language (e.g. <code>Hawaiian.lang</code>)
# Start BaseX.jar, choose your language via ''Options'' → ''Preferences...'' and restart BaseX to see the changes
You may can also change the directly assign a language in the <code>.basex</code> configuration file,which is placed in your [[Configuration|home directory]].The language is assigned to the {{Option|LANG}} option. In order to see where the all text keys are used within BaseX, you may temporarilycan set the [[Options#LANGKEY{{Option|LANGKEY]] option }} to <code>true</code>.
