Internationalization

In datamods: Modules to Import and Manipulate Data in 'Shiny'

knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "#>",
  eval = FALSE
)

library(datamods)

When using {datamods} modules, a simple way to modify labels display is provided for using a different language or simply use other labels. There are 4 different ways to use new labels:

# Using a supported language
set_i18n("fr")

# Using a named list
set_i18n(list("Some label" = "Its translation", ...))

# Using a data.framewith 2 columns
set_i18n(data.frame(label = c(...), translation = c(...)))

# Using a CSV file
set_i18n("path/to/file.csv")

Integrated languages

The following languages are integrated in {datamods} :

• {height=16, style="height:16px"} english, the default.

• {height=16, style="height:16px"} french, activate with:

set_i18n("fr")

• {height=16, style="height:16px"} macedonian, activate with:

set_i18n("mk")

• {height=16, style="height:16px"} {height=16, style="height:16px"} brazilian portuguese, activate with:

set_i18n("pt")

• {height=16, style="height:16px"} albanian, activate with:

set_i18n("al")

• {height=16, style="height:16px"} chinese, activate with:

set_i18n("cn")

• {height=16, style="height:16px"} spanish, activate with:

set_i18n("es")

• {height=16, style="height:16px"} german, activate with:

set_i18n("de")

• {height=16, style="height:16px"} turkish, activate with:

set_i18n("tr")

• {height=16, style="height:16px"} korean, activate with:

set_i18n("kr")

• {height=16, style="height:16px"} polish, activate with:

set_i18n("pl")

• {height=16, style="height:16px"} japanese, activate with:

set_i18n("ja")

If you want another language to be supported, you can submit a Pull Request to add a CSV file like the one used for french (file is located in inst/i18n folder in the package, you can see it here on GitHub).

Using a list

You can change labels with a named list, where names correspond to the labels and values to the translation to use:

options("datamods.i18n" = list(
  "Import a dataset from an environment" = "Importer un jeu de données depuis l'environnement global",
  "Select a data.frame:" = "Sélectionner un data.frame :",
  ...
))

Using a data.frame

You can change labels with a data.frame with two columns label (the original label) and translation (the new label to display):

set_i18n(data.frame(
  label = c("Import a dataset from an environment", "Select a data.frame:", ...),
  translation = c("Importer un jeu de données depuis l'environnement global", "Sélectionner un data.frame :", ...)
))

Using a file

Use a CSV file with same structure than data.frame above:

set_i18n("path/to/file.csv")

An example of file is shown below.

All labels

Here's the file used for french translation with all labels used in the package:

cat(readLines(system.file("i18n", "fr.csv", package = "datamods"), encoding = "UTF-8"), sep = '\n')

datamods documentation built on Sept. 26, 2023, 5:07 p.m.