AMR/R/get_locale.R

91 lines
4.1 KiB
R
Raw Normal View History

2018-11-05 13:20:32 +01:00
# ==================================================================== #
# TITLE #
# Antimicrobial Resistance (AMR) Analysis #
# #
2019-01-02 23:24:07 +01:00
# SOURCE #
# https://gitlab.com/msberends/AMR #
2018-11-05 13:20:32 +01:00
# #
# LICENCE #
2019-01-02 23:24:07 +01:00
# (c) 2019 Berends MS (m.s.berends@umcg.nl), Luz CF (c.f.luz@umcg.nl) #
2018-11-05 13:20:32 +01:00
# #
2019-01-02 23:24:07 +01:00
# This R package is free software; you can freely use and distribute #
# it for both personal and commercial purposes under the terms of the #
# GNU General Public License version 2.0 (GNU GPL-2), as published by #
# the Free Software Foundation. #
# #
# This R package was created for academic research and was publicly #
# released in the hope that it will be useful, but it comes WITHOUT #
# ANY WARRANTY OR LIABILITY. #
2019-04-05 18:47:39 +02:00
# Visit our website for more info: https://msberends.gitlab.io/AMR. #
2018-11-05 13:20:32 +01:00
# ==================================================================== #
2019-05-10 16:44:59 +02:00
#' Translate strings from AMR package
2018-11-05 13:20:32 +01:00
#'
2019-05-10 16:44:59 +02:00
#' For language-dependent output of AMR functions, like \code{\link{mo_fullname}} and \code{\link{mo_type}}.
2019-06-01 20:40:49 +02:00
#' @details Strings will be translated to foreign languages if they are defined in a local translation file. Additions to this file can be suggested at our repository. The file can be found here: \url{https://gitlab.com/msberends/AMR/blob/master/data-raw/translations.tsv}.
2019-05-10 16:44:59 +02:00
#'
2019-06-01 20:40:49 +02:00
#' Please suggest your own translations \href{https://gitlab.com/msberends/AMR/issues/new?issue[title]=Translation\%20suggestion}{by creating a new issue on our repository}.
2019-05-10 16:44:59 +02:00
#'
2019-06-01 20:40:49 +02:00
#' This file will be read by all functions where a translated output can be desired, like all \code{\link{mo_property}} functions (\code{\link{mo_fullname}}, \code{\link{mo_type}}, etc.).
2019-05-10 16:44:59 +02:00
#'
#' The system language will be used at default, if supported, using \code{\link{get_locale}}. The system language can be overwritten with \code{\link{getOption}("AMR_locale")}.
2019-01-02 23:24:07 +01:00
#' @inheritSection AMR Read more on our website!
2019-05-10 16:44:59 +02:00
#' @rdname translate
#' @name translate
2018-11-05 13:20:32 +01:00
#' @export
2019-05-10 16:44:59 +02:00
#' @examples
#' # The 'language' parameter of below functions
#' # will be set automatically to your system language
#' # with get_locale()
#'
#' # English
#' mo_fullname("CoNS", language = "en")
#' #> "Coagulase-negative Staphylococcus (CoNS)"
#'
#' # German
#' mo_fullname("CoNS", language = "de")
#' #> "Koagulase-negative Staphylococcus (KNS)"
#'
#' # Dutch
#' mo_fullname("CoNS", language = "nl")
#' #> "Coagulase-negatieve Staphylococcus (CNS)"
#'
#' # Spanish
#' mo_fullname("CoNS", language = "es")
#' #> "Staphylococcus coagulasa negativo (SCN)"
#'
#' # Italian
#' mo_fullname("CoNS", language = "it")
#' #> "Staphylococcus negativo coagulasi (CoNS)"
#'
#' # Portuguese
#' mo_fullname("CoNS", language = "pt")
#' #> "Staphylococcus coagulase negativo (CoNS)"
2018-11-05 13:20:32 +01:00
get_locale <- function() {
2019-05-10 16:44:59 +02:00
if (getOption("AMR_locale", "en") != "en") {
return(getOption("AMR_locale"))
2018-11-05 13:20:32 +01:00
}
2019-05-10 16:44:59 +02:00
2018-11-05 13:20:32 +01:00
lang <- Sys.getlocale("LC_COLLATE")
# grepl with case = FALSE is faster than like
2018-11-12 15:07:43 +01:00
if (grepl("^(English|en_|EN_)", lang, ignore.case = FALSE)) {
# as first option to optimise speed
2018-11-05 13:20:32 +01:00
"en"
2018-11-12 15:07:43 +01:00
} else if (grepl("^(German|Deutsch|de_|DE_)", lang, ignore.case = FALSE)) {
2018-11-05 13:20:32 +01:00
"de"
2018-11-12 15:07:43 +01:00
} else if (grepl("^(Dutch|Nederlands|nl_|NL_)", lang, ignore.case = FALSE)) {
2018-11-05 13:20:32 +01:00
"nl"
2018-11-12 15:07:43 +01:00
} else if (grepl("^(Spanish|Espa.ol|es_|ES_)", lang, ignore.case = FALSE)) {
2018-11-05 13:20:32 +01:00
"es"
2018-11-12 15:07:43 +01:00
} else if (grepl("^(Italian|Italiano|it_|IT_)", lang, ignore.case = FALSE)) {
2018-11-05 13:20:32 +01:00
"it"
2018-11-12 15:07:43 +01:00
} else if (grepl("^(French|Fran.ais|fr_|FR_)", lang, ignore.case = FALSE)) {
2018-11-05 13:20:32 +01:00
"fr"
2018-11-12 15:07:43 +01:00
} else if (grepl("^(Portuguese|Portugu.s|pt_|PT_)", lang, ignore.case = FALSE)) {
2018-11-05 13:20:32 +01:00
"pt"
2018-11-12 15:07:43 +01:00
} else {
2018-11-15 12:42:35 +01:00
# other language -> set to English
2018-11-12 15:07:43 +01:00
"en"
2018-11-05 13:20:32 +01:00
}
}