{"Package":"shiny.i18n","Title":"Shiny Applications Internationalization","Version":"0.3.0","Authors@R":"c(\nperson(\"Jakub\", \"Nowicki\", email = \"opensource+kuba@appsilon.com\", role = c(\"cre\", \"aut\")),\nperson(\"Dominik\", \"Krzemiński\", email = \"raymon92@gmail.com\", role = c(\"aut\")),\nperson(\"Krystian\", \"Igras\", email = \"krystian8207@gmail.com\", role = c(\"aut\")),\nperson(\"Jakub\", \"Sobolewski\", email = \"jakub.sobolewski@appsilon.com\", role = c(\"aut\")),\nperson(\"Appsilon Sp. z o.o.\", role = \"cph\", email = \"opensource@appsilon.com\")\n)","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","URL":"https://appsilon.github.io/shiny.i18n/,\nhttps://github.com/Appsilon/shiny.i18n","BugReports":"https://github.com/Appsilon/shiny.i18n/issues","RoxygenNote":"7.2.1","Suggests":"covr, googleLanguageR, knitr, lintr, rcmdcheck, rmarkdown,\nspelling, testthat, withr, quarto","Language":"en-US","NeedsCompilation":"no","Packaged":"2023-01-13 14:30:28 UTC; kuba","Author":"Jakub Nowicki [cre, aut],\nDominik Krzemiński [aut],\nKrystian Igras [aut],\nJakub Sobolewski [aut],\nAppsilon Sp. z o.o. [cph]","Maintainer":"Jakub Nowicki ","Repository":"CRAN","Date/Publication":"2023-01-16 10:40:02 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/shiny.i18n_0.3.0.tar.gz","jsonAuthors":[{"name":"Jakub Nowicki","email":"opensource+kuba@appsilon.com","maintainer":true},{"name":"Dominik Krzemiński","email":"raymon92@gmail.com","maintainer":false},{"name":"Krystian Igras","email":"krystian8207@gmail.com","maintainer":false},{"name":"Jakub Sobolewski","email":"jakub.sobolewski@appsilon.com","maintainer":false},{"name":"Appsilon Sp. z o.o. ","email":"opensource@appsilon.com","maintainer":false}],"readme":"# shiny.i18n $\"shiny.i18n$ \n\n> _Shiny applications internationalization made easy!_\n\n\n[![CRAN status](https://www.r-pkg.org/badges/version/shiny.i18n)](https://cran.r-project.org/package=shiny.i18n)\n[![codecov](https://codecov.io/gh/Appsilon/shiny.i18n/branch/master/graph/badge.svg)](https://app.codecov.io/gh/Appsilon/shiny.i18n/)\n[![cranlogs](https://cranlogs.r-pkg.org/badges/shiny.i18n)](https://CRAN.R-project.org/package=shiny.i18n)\n[![total](https://cranlogs.r-pkg.org/badges/grand-total/shiny.i18n)](https://CRAN.R-project.org/package=shiny.i18n)\n[![R-CMD-check](https://github.com/Appsilon/shiny.i18n/workflows/R-CMD-check/badge.svg)](https://github.com/Appsilon/shiny.i18n/actions/workflows/main.yaml)\n\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 readable.\n\n*Actually, you can use **shiny.i18n** as a standalone R package - shiny app is just a perfect use-case example.*\n\nChange languages and formats easy with **shiny.i18n**.\n\n## How to install?\n\nStable version:\n\n```r\ninstall.packages(\"shiny.i18n\")\n```\n\nDevelopment version:\n\n```r\nremotes::install_github(\"Appsilon/shiny.i18n\")\n```\n\n## Examples\n\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\n5) **shiny.i18n** works seamlessly with [Quarto](https://github.com/Appsilon/shiny.i18n/tree/master/examples/quarto).\n\n6) **shiny.i18n** also works when used in interactive [Quarto + Shiny instances](https://github.com/Appsilon/shiny.i18n/tree/master/examples/quarto_interactive). Alternatively, you can also experience a [deployed version](https://connect.appsilon.com/shinyi18n-quarto-interactive-example).\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\n## `shiny.i18n` and `rhino`\n\n`shiny.i18n` can be used to add live language change feature to Shiny applications built using [Rhino framework](https://appsilon.github.io/rhino/).\nFor more details, check [this tutorial](https://appsilon.github.io/shiny.i18n/articles/rhino.html).\n\n## How to contribute?\n\nIf you want to contribute to this project please submit a regular PR, once you're done with a new feature or bug fix.\n\nReporting a bug is also helpful - please use [GitHub issues](https://github.com/Appsilon/shiny.i18n/issues) and describe your problem as detailed as possible.\n\n## Appsilon\n\n $\"\"$ \n\nAppsilon is a **Posit (formerly RStudio) Full Service Certified Partner**.
\nLearn more\nat [appsilon.com](https://appsilon.com).\n\nGet in touch [opensource@appsilon.com](mailto:opensource@appsilon.com)\n\nCheck our [Open Source tools](https://shiny.tools).\n\n $\"We$ ","jobInfo":{"package":"shiny.i18n","version":"0.3.0","parsingStatus":"success","parserVersion":2,"parsedAt":"2023-01-16T12:30:23+0000"}}

Last chance! 50% off unlimited learning

Description

Usage

Arguments