Changes

This page is part of the [[Developer Section]].It describes how to translate BaseX is available in several languages into other (such as English, German, or Japanesenatural)languages.We are always thankful for contributions, and if you willing to contributea new translation, please proceed as follows:

==Using the JAR file==JAR files are nothing else than ZIP archives.All language files are placed in the <code>lang</code> directory inside the JAR file.# Unzip the source file <code>English.lang</code> and name it Thanks to your language (e.g. <code>Zulu.lang</code>)# Enter your name and potential contact information in the second line and translate all texts# Copy the translated file back to the <code>lang</code> directory in the JAR file# Start following contributors, BaseX and choose your language is currently available in the GUI (''Options'' → ''Preferences...'')# Restart BaseX, and you should see the changes10 languages:

==Using the sources==* '''Dutch''': Huib VerweijAll language files are placed in the <code>src/main/resources/lang</code> directory of the main project* '''English''':BaseX Team# Create a copy of the source file <code>English.lang</code> and name it to your language (e.g. <code>Zulu.lang</code>)* '''French''': Maud Ingarao* '''German''': BaseX Team* '''Hungarian''': Kiss-Kálmán Dániel# Enter your name and potential contact information in the second line and translate all texts* '''Indonesian''': Andria Arisal# Translate all given texts* '''Italian''': Massimo Franceschet# Compile the project, start BaseX * '''Japanese''': Toshio HIRAI and choose your language in the GUI (Kazuo KASHIMA* '''Mongolian'''Options: Tuguldur Jamiyansharav* '' → 'Romanian'Preferences...''): Adrian Berila# Restart BaseX, * '''Russian''': Oleksandr Shpak and you should see the changesMax Shamaev* '''Spanish''': Carlos Marcos

To 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 [[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/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 where the texts changes.# Repeat the last step if you want to revise your translations. If new strings are used within added to BaseX, it they will automatically be added to your language files in English. The history view in GitHub is recommended helpful to see which strings have recently been updated to a file. ==Updating BaseX.jar== You can directly add new languages to set the LANGKEYS property 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: # Unzip an existing translation file (e.g., <code>English.lang</code>) and rename it to your target language (e.g. <code>Hawaiian.basexlang</code>)# Enter your name and contact information in the second line and translate the texts# Update your JAR file by copying the translated file into the zipped <code>lang</code> configuration directory. Your new language file will be automatically detected.# Start BaseX.jar, choose your language via ''Options'' → ''Preferences...'' and restart BaseX to true. see the changes You will find can also directly assign a language in the <code>.basex</code> configuration file , which is placed in your [[Configuration#Home_Directory |home directory]]. The language is assigned to the {{Option|LANG}} option. In order to see where the text keys are used within BaseX, you can set {{Option|LANGKEY}} to <code>true</code>.