This post (and video) will explain how to translate Kibana using the Globalization Pipeline service on Bluemix. Note that some of the steps shown here depend on kibana:8766 which was not merged as this article went to press. (Portions are based on the
development-internationalization.asciidoc document from that PR.)
A Bluemix account to access Globalization Pipeline. It's free to sign up!
Java and the latest gp-cli.jar (Globalization Pipeline tools).
- Follow the GP Quick Start Guide to create a service instance. Copy down the "credentials" into a new file,
gp-credentials.jsonwhich should look something like the following:
- Create the bundle on the GP instance. The example below uses English (
en) as the source langage and requests Spanish, Japanese, and French targets (
The bundle will show up in the Bluemix dashboard under the service’s console, but as empty.
We are going to translate the
src/core_plugins/kibana/translations/en.jsonfile in Kibana. Upload that file to the Globalization Pipeline service using the command line:
- If you head back over to the Bluemix dashboard, you can now see the populated bundle with translated content:
What you see was done with machine translation, hence the red “U” (Unreviewed). The content here can be corrected manually by clicking the Pencil icon, or marked as manually reviewed by clicking the Checkmark. It’s also possible to download the translated content for offline review or use, or to upload a corrected version of one of the translations.
Head back over to the command line, though, because it is time to create our plugin.
- See https://github.com/elastic/generator-kibana-plugin - create a
kibana-YOURNAME-translation-pluginnext to your
Something like this:
- You will notice that the generator has created a
translations/es.jsonfile. We will replace this with our translated content.
- Now, download the translated content into the correct files:
- Update the
index.jsfile in the plugin to mention the updated
You will see a section like this:
Change it to mention all of the language files we have just downloaded:
That's all the coding we'll need for today…
Copy your entire translations plugin directory to the Kibana plugins (
Fire up Kibana and you should see the translated content!
By the way, French isn’t included in the video or images becuase I ran into kibana#10580 during the production of this video. When this is fixed I will come back and edit this video, but until then, beware single quotes (
') in your translated strings.
Note that if you repeat the
exportsteps of the
gp-clitool, the Globalization Pipeline will automatically manage translation changes if, for example, translated keys are added or removed, or translated content changes.
Follow the progress of Kibana Globalization on Github: (kibana#6515).
Read more about Globalization Pipeline
Connect with the Globalization Pipeline Open Source Community