Apache JSPWiki's language translations #

Apache JSPWiki is available in several languages. You can help us by improving, completing or adding new translations! There are two areas concerning internationalization: Apache JSPWiki itself, and the default set of core wiki pages.

Apache JSPWiki i18n texts#

The i18n-ed texts are available on the jspwiki-main module, inside the src/main/resources directory (CoreResources*.properties files), and also under the plugin and templates folders.

Adding a new language is pretty easy, just make a copy of the CoreResources.properties, plugin/PluginResources.properties and template/default.properties files suffixing them with the appropiate locale. F.ex., if you were to add the localization for the es_EU locale, the files would be named CoreResources_es_EU.properties, plugin/PluginResources_es_EU.properties and template/default_es_EU.properties. Once that is done, the translation can be performed on those files; there are over 650 entries over them, so adding a new locale will surely take some time.

It may happen that once in a while there's a need of introducing a new i18n text. To avoid having to keep up looking for new translations on every commit, you can have a look at the Translation Status page. If there are still entries to be localized, there's an utility class org.apache.wiki.TranslationsCheck on the jspwiki-main module, that will come nifty. Execute it either through your favourite IDE, or from the console like:

java -cp target/classes org.apache.wiki.TranslationsCheck <language> [<path>]

and it will report the missing entries, the ones that are duplicated and the ones outdated (the ones not currently used anymore).

Making it easy with an IDE#

If you're a developer type, many IDEs have tools to help make it easier to find missing I18N values across all languages variants. If you're using Netbeans, right click the default language properties file and press Open. You'll then get this nifty editor that lets you quickly go through all the keys (and probably paste into language translation service).

Core Wiki Pages#

They are located at the jspwiki-wikipages folder. Adding a new language is really straightforward, just copy over the en folder with the new to-be locale and translate the txt files inside the src/main/resources directory. Note that it will take some time to add a new set of localized wiki pages, as they're around 40 files.

Submitting your changes#

Once you've completed / improved / fixed the appropriate translation you can either submit a Pull Request with your changes or attach them on a new JIRA issue. In any case, we'll try to get your changes as soon as we can. And thanks in advance for your contribution! :-)

Category.Documentation