{"Package":"shiny.i18n","Title":"Shiny Applications Internationalization","Version":"0.2.0","Authors@R":"c(person(\"Dominik\", \"Krzemiński\",\nemail = \"dominik@appsilon.com\",\nrole = c(\"cre\", \"aut\")),\nperson(\"Krystian\", \"Igras\",\nemail = \"krystian@appsilon.com\",\nrole = c(\"aut\")),\nperson(family = \"Appsilon\", role = c(\"cph\")))","Description":"It provides easy internationalization of Shiny\napplications. It can be used as standalone translation package\nto translate reports, interactive visualizations or\ngraphical elements as well.","Depends":"R (>= 3.3.0)","Imports":"yaml, jsonlite, methods, stringr, R6, glue, shiny, rstudioapi,\nutils","License":"MIT + file LICENSE","Encoding":"UTF-8","LazyData":"true","URL":"https://github.com/Appsilon/shiny.i18n","BugReports":"https://github.com/Appsilon/shiny.i18n/issues","RoxygenNote":"7.1.1","Suggests":"knitr, googleLanguageR, rmarkdown, testthat, covr","NeedsCompilation":"no","Packaged":"2020-10-02 13:37:04 UTC; dominik","Author":"Dominik Krzemiński [cre, aut],\nKrystian Igras [aut],\nAppsilon [cph]","Maintainer":"Dominik Krzemiński ","Repository":"CRAN","Date/Publication":"2020-10-02 14:00:02 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/shiny.i18n_0.2.0.tar.gz","jsonAuthors":[{"name":"Dominik Krzemiński","email":"dominik@appsilon.com","maintainer":true},{"name":"Krystian Igras","email":"krystian@appsilon.com","maintainer":false},{"name":" Appsilon","email":null,"maintainer":false}],"readme":" $\"\"$ \n\n\nshiny.i18n\n==========\n\nShiny applications internationalisation made easy!\n\nUsing 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.\n\n*Actually, you can use **shiny.i18n** as a standalone R package - shiny app is just a perfect usecase example.*\n\nChange languages and formats easy with **shiny.i18n**.\n\nSource code\n-----------\n\nThis library source code can be found on [Appsilon Data Science's](https://appsilon.com) Github:
\n\nHow to install?\n---------------\n\nAt the moment it's possible to install this library with [devtools](https://github.com/r-lib/devtools).\n\n```r\ndevtools::install_github(\"Appsilon/shiny.i18n\")\n```\n\nTo install previous version you can run:\n\n```r\ndevtools::install_github(\"Appsilon/shiny.i18n\", ref = \"0.1.0\")\n```\n\nExamples\n--------\n\n\n

\nSee shiny.i18n in action live\n

\n\n\nYou can find some basic examples in `examples` folder:\n\n1) Using i18n object with [CSV translation files](https://github.com/Appsilon/shiny.i18n/blob/master/examples/basic/app_csv.R) or [JSON translation files](https://github.com/Appsilon/shiny.i18n/blob/master/examples/basic/app_json.R).\n\n2) Live language change on the [browser side](https://github.com/Appsilon/shiny.i18n/blob/master/examples/live_language_change/browser_app.R) or with the server [function renderUI](https://github.com/Appsilon/shiny.i18n/blob/master/examples/live_language_change/server_app.R).\n\n3) [RMarkdown translations](https://github.com/Appsilon/shiny.i18n/blob/master/examples/rmarkdown/report.Rmd).\n\n4) Example of translation [data format](https://github.com/Appsilon/shiny.i18n/tree/master/examples/data).\n\n#### Translation file format\n\nCurrently **shiny.i18n** supports two translation formats:\n\n- **csv** - where each translation is in separate file `translation_.csv` containing two columns: key translation, language to which it needs to be translated. Example of `translation_pl.csv` for 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:\n\n```r\nTranslator$new(translation_csvs_path = \"...\")\n```\n\n- **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`. You load the data by passing the path to json file.\n\n```r\nTranslator$new(translation_json_path = \"...\")\n```\n\nHow to contribute?\n------------------\n\nIf 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.\n\n**Changes in documentation**\n\nDocumentation is rendered with `pkgdown`. Just run `pkgdown::build_site()` after editing documentation or `README.md`.\n\n\nTroubleshooting\n---------------\n\nWe used the latest versions of dependencies for this library, so please update your R environment before installation.\n\nFuture enhacements\n------------------\n\n- Format numeric data\n- Support plural forms\n\nAppsilon Data Science\n---------------------\n\nGet in touch *dev@appsilon.com*.","jobInfo":{"package":"shiny.i18n","version":"0.2.0","parsingStatus":"success","parserVersion":2,"parsedAt":"2023-01-16T12:30:16+0000"}}

Description

Usage

Arguments