Shiny applications internationalisation made easy!
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.
Actually, you can use shiny.i18n as a standalone R package - shiny app is just a perfect usecase example.
Change languages and formats easy with shiny.i18n.
How to install?
Or use devtools for the most recent version:
To install previous version you can run:
devtools::install_github("Appsilon/shiny.i18n", ref = "0.1.0")
You can find some basic examples in
Example of translation data format.
Translation file format
Currently shiny.i18n supports two translation formats:
- csv - where each translation is in separate file
translation_<LANGUAGE-CODE>.csvcontaining two columns: key translation, language to which it needs to be translated. Example of
translation_pl.csvfor Polish language you may find here:
inst/examples/data/translation_pl.csv. You load the data by passing the path to folder containing all the csv files:
Translator$new(translation_csvs_path = "...")
- json - single json file
translation.jsonwith 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:
inst/examples/data/translation.json. You load the data by passing the path to json file.
Translator$new(translation_json_path = "...")
How to contribute?
If you want to contribute to this project please submit a regular PR, once you're done with new feature or bug fix. Reporting a bug is also helpful - please use github issues and describe your problem as detailed as possible.
Changes in documentation
Documentation is rendered with
pkgdown. Just run
pkgdown::build_site() after editing documentation or
We used the latest versions of dependencies for this library, so please update your R environment before installation.
- Format numeric data
- Support plural forms
Appsilon is the Full Service Certified RStudio Partner. Learn more at appsilon.com.
Get in touch firstname.lastname@example.org