Skip to content

CIP-RIU/shiny.i18n

This branch is 1 commit ahead of, 210 commits behind Appsilon/shiny.i18n:main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

15b0964 · Oct 29, 2019

History

94 Commits
Sep 30, 2018
Mar 21, 2019
Apr 4, 2019
May 29, 2019
Oct 3, 2018
Jul 27, 2018
Oct 26, 2018
Aug 19, 2017
Sep 5, 2017
Oct 26, 2018
Sep 5, 2017
Oct 29, 2019
Aug 29, 2018
Aug 29, 2018
Apr 4, 2019
Jun 4, 2019
Oct 26, 2018
Aug 4, 2017

Repository files navigation

shiny.i18n

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.

Source code

This library source code can be found on Appsilon Data Science's Github:
https://github.com/Appsilon/shiny.i18n/

How to install?

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.

devtools::install_github("Appsilon/shiny.i18n")

To install previous version you can run:

devtools::install_github("Appsilon/shiny.i18n", ref = "0.1.0")

Example

You can find some basic examples in /inst/examples.

Translation file format

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: inst/examples/data/translation_pl.csv.

  • json - single json 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: inst/examples/data/translation.json.

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.

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.

Troubleshooting

We used the latest versions of dependencies for this library, so please update your R environment before installation.

Future enhacements

  • Format numeric data
  • Support plural forms

Appsilon Data Science

Get in touch dev@appsilon.com

About

Shiny applications internationalisation made easy

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • R 94.9%
  • Shell 5.1%