如何翻译包内容？

Question

我想从我的包中获得多种语言的错误消息,警告和其他用户反馈.(R可以翻译的内容message,warning,stop,gettext,和ngettext.)

有关如何在这些文档中执行此操作的建议:

1. 写作R扩展的国际化部分.
2. 该消息的本地化 [R安装和管理的部分.
3. R Developer指南的翻译(R <3.0.0)页面.

该mgcv和Rcmdr(PO DIR)封装有翻译,提供如何做事的例子.

尽管如此,我仍在努力让事情顺利进行.这是一个可重现的包示例:

在Windows上,您需要下载并解压缩gettext-tools,并将该位置添加到Windows PATH环境变量中.

library(roxygen2)
library(devtools)
library(tools)

# Create the directories to hold the package content
Vectorize(dir.create)(c("test", "test/R", "test/man", "test/po"))

# Write the package DESCRIPTION file
cat(
  'Package: test
Title: Test pkg
Description: Investigate how to translate content
Version: 0.0-1
Date: 2015-03-17
Author: Richard Cotton
Maintainer: Richard Cotton <a@b.com>
License: Unlimited',
  file = "test/DESCRIPTION"
)

# Create a function go to into the package, plus its documentation
cat(
  "#' Translatable messages
#' Some strings to be translated.
#' @param n A natural number.
#' @export
translatable <- function(n)
{
  message('faucet')
  cat(gettext('napkin'), '\n')
  cat(ngettext(n, 'one', 'many', domain = 'R-test'), '\n')
}",
  file = "test/R/translatable.R"
)

# Create the master translation file (American English)
xgettext2pot("test", "test/po/R-test.pot")

# Alter the master file to make British English and French translations
en <- readLines("test/po/R-test.pot")
en_gb <- en
en_gb[which(en_gb == 'msgid "faucet"') + 1] <- 'msgid "tap"'
en_gb[which(en_gb == 'msgid "napkin"') + 1] <- 'msgid "serviette"'
writeLines(en_gb, "test/po/R-en_GB.po")

fr <- en
fr[which(fr == 'msgid "faucet"') + 1] <- 'msgid "robinet"'
fr[which(fr == 'msgid "napkin"') + 1] <- 'msgid "serviette"'
fr[which(fr == 'msgid        "one"') + 2] <- 'msgstr[0]    "un"'
fr[which(fr == 'msgid_plural "many"') + 2] <- 'msgstr[1]    "beaucoup"'
writeLines(fr, "test/po/R-fr.po")

# Build and install the package
pkg_file <- build("test")
install.packages(pkg_file, repos = NULL, type = "source")

将您的操作系统区域设置更改为English (United States)(在Windows 7下,在控制面板中 - >区域和语言 - >格式 - >格式)并重新启动R.

您应该看到默认文本:

library(test)
translatable(1)
## faucet
## napkin 
## one
translatable(2)
## faucet
## napkin 
## many

现在将您的语言环境更改为English (United Kingdom)或French (France),重新启动R,然后重新运行该示例.我希望文本能够改变,但事实并非如此.

Sys.getlocale() 报告我的语言环境发生了变化,因此肯定会有效.

capabilities("NLS")返回TRUE,因此启用自然语言支持.

使用法语语言环境,从mgcv::bam帮助页面改编的这个示例给出了法语错误消息,所以问题在于我如何生成包.

library(mgcv)
dat <- gamSim(1,n=25000,dist="normal",scale=20)
bs <- "cr";k <- 12
b <- bam(
  y ~ s(x0,bs=bs)+s(x1,bs=bs)+s(x2,bs=bs,k=k)+s(x3,bs=bs),
  data   = dat, 
  family = list(family = NULL)
)
## Erreur dans bam(y ~ s(x0, bs = bs) + s(x1, bs = bs) + s(x2, bs = bs, k = k) +  : 
##   famille non reconnue

我究竟做错了什么？

Answer 1

您还没有采取步骤来编译和安装您的翻译。并且您的 .po 文件有问题。

这是R-fr.po您的示例的工作文件：

msgid ""
msgstr ""
"Project-Id-Version: R 3.1.2\n"
"Report-Msgid-Bugs-To: bugs.r-project.org\n"
"POT-Creation-Date: 2015-03-17 09:46\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: fr\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"

msgid "faucet"
msgstr "robinet"

msgid "napkin"
msgstr "serviette"

msgid        "one"
msgid_plural "many"
msgstr[0]    "un"
msgstr[1]    "beaucoup"

请注意，您已经拥有了msgid您应该拥有的地方msgstr。您也没有指定语言或复数形式，并且“charset”变量在编译期间引发错误。

获得正确的文件后，请按照“准备和安装翻译”下的说明进行操作。具体来说，从命令行执行以下操作：

mkdir test/inst/po/fr/LC_MESSAGES
msgfmt -c --statistics -o test/inst/po/fr/LC_MESSAGES/R-test.mo R-test.po

如果出现问题，这将引发一些错误和警告。如果没有，它应该给出确认消息。

然后重建包并安装它，然后重试一切：

library("test")
translatable(1)
## faucet
## napkin
## one 
translatable(2)
## faucet
## napkin 
## many 
Sys.setenv(LANG = "fr")
translatable(1)
## robinet
## serviette
## un 
> translatable(2)
## robinet
## serviette
## beaucoup

请注意，您不需要更改操作系统语言。您只需设置LANG环境变量即可获取消息翻译。

与此相关的是，我发现这个过程真的很烦人，所以在我的中期待办事项列表中创建一个包（特别是这个），我希望它能简化这个过程。