Pentaho Language Pack Installer: plugin for installing language packs
The installer works by massively copying files to your Pentaho installation, eventually overwriting existing files. It also patches files in your installation.
We heavily recommend that you test the installer in a dedicated BI server before using this installer in a production setting. Please backup both your server and your solution!
The Language Pack Installer requires Pentaho 5+, and depends on the following CTools:
- Community Dashboard Framework (CDF)
- Community Dashboard Editor (CDE)
You can install these packages from the marketplace, or by manually downloading them from Pentaho's Continuous Integration server and unzipping the .zip file to your pentaho-solutions/system
folder.
-
If you downloaded a zip file, simply unzip it to your
pentaho-solutions/system
If your are using the git repository, then, in a command line:
- Go to your
pentaho-solutions/system
folder git clone [email protected]:webdetails/pentahoLanguagePacks.git languagePackInstaller
- Go to your
-
Restart the biserver
-
Assuming you are working in your local machine, visit: http://localhost:8080/pentaho/plugin/languagePackInstaller/api/main
-
Please fork the Webdetails repository
https://github.com/webdetails/pentahoLanguagePacks.git
. To merge your changes, please issue a pull request. -
Please save all files using UTF8 encoding.
-
Do not bother to edit the
supported_languages.properties
files, their contents will be ignored by the language pack installer. -
The information in the file
data/${languageCode}/metadata.json
will be used by the installer to patch Pentaho with your translation, so please make sure the fieldslanguageCode
andlanguage
are consistent with your modifications. -
The installer installs whatever
languageCode
is defined indata/metadata.json
. To test different translations, simply modify this file accordingly. -
The script
endpoints/kettle/generate_language_bundle.py
can be used to generate a language pack from scratch. It works by copying the default tokens and appending a<TRANSLATE ME>
to each string. -
Individual language packs can be generated by running
ant -DlangCode=pt_PT clean resolve build-language-pack
(replacept_PT
with the appropriate language code).
- In the particular case of the automatically generated files
biserver/tomcat/webapps/pentaho/mantle/mantleMessages_*.properties
, the symbols < and > can break the Pentaho User Console, yielding an errorError generating XUL: Failed to parse: <?xml version="1.0" encoding="UTF-8"?>
. This error disappears as soon as these symbols are eliminated.