It provides easy internationalization of Shiny applications. It can be used as standalone translation package to translate reports, interactive visualizations or graphical elements as well.
Shiny applications internationalisation made easy!
Actually, you can use shiny.i18n as a standalone R package - shiny app is just a perfect usecase example.
Using it is very simple: just prepare your translation files in one of the supported formats, read them into your app using user-friendly shiny.i18n interface and surround your expressions to translate by a translator tag. Thanks to that your app will remain neat and readible.
For more informations check the Example section below!
Change languages and formats easy with shiny.i18n.
Note! This library is still in its infancy. Api might change in the future.
At the moment it's possible to install this library through devtools.
To install previous version you can run:
devtools::install_github("Appsilon/shiny.i18n", ref = "0.1.0")
You can find some basic examples in
Currently shiny.i18n supports two formats:
csv - where each translation is in separate file
translation_<LANGUAGE-CODE>.csv. Example of
translation_pl.csv for Polish language you may find here:
json - single file
translation.json with mandatory fields:
"languages" with list of all language codes and
"translation" with list of dictionaries assigning each translation to a language code. Example of such a json file for Polish language you may find here:
If you want to contribute to this project please submit a regular PR, once you're done with new feature or bug fix.
Changes in documentation
Both repository README.md file and an official documentation page are generated with Rmarkdown, so if there is a need to update them, please modify accordingly a README.Rmd file and run a build_readme.R script to compile it.
We used the latest versions of dependencies for this library, so please update your R environment before installation.
Get in touch [email protected]