Changes

Jump to navigation Jump to search
1,034 bytes added ,  15:04, 23 January 2016
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:
==Using Working with the JAR filesources==JAR files are nothing else than ZIP archives.If you have downloaded all BaseX sources via [[Developing with Eclipse|Eclipse]] or [[Git]], 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/langsrc/main/resources/lang]</code> directory inside of the JAR filemain project:# Unzip the source Create a copy of an existing translation file (e.g., <code>English.lang</code> ) and rename it to your target language (e.g. <code>ZuluHawaiian.lang</code>).# Enter your name and potential contact information in the second line and translate all texts.# Update your JAR file by copying If you are using Eclipse, refresh the translated file into the zipped <code>lang</code> directoryproject (via ''Project'' → ''Refresh''); if you are using Maven, type in {{Code|mvn compile}}. Your new language file will be automatically scanneddetected.# Start the BaseX and GUI, choose your language in the GUI (via ''Options'' → ''Preferences...'')and close the GUI.# Restart 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 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 into the JAR file:
==Using the sources==All language files are placed in the <code>src/main/resources/lang</code> directory of the main project:# Create a copy of the source Unzip an existing translation file (e.g., <code>English.lang</code> ) and rename it to your target language (e.g. <code>ZuluHawaiian.lang</code>)# Enter your name and potential contact information in the second line and translate all the texts# Copy Update your JAR file by copying the translated file back to into the zipped <code>lang</code> directory. Your new language file will be automatically scanneddetected.# Recompile the projectStart BaseX.jar, start BaseX and choose your language in the GUI (via ''Options'' → ''Preferences...'')# Restart and restart BaseX to see the changes
You may as well change the can also directly assign a language in the <code>.basex</code> configuration file,which is placed in your [[Configuration|home directory]].To The language is assigned to the {{Option|LANG}} option. In order to see where the all text keys are used within BaseX, we recommend you to temporarilycan set the [[Options#LANGKEY{{Option|LANGKEY]] option }} to <code>true</code>.
Bureaucrats, editor, reviewer, Administrators
13,550

edits

Navigation menu