如何在Rstudio的功能帮助窗格中正确呈现LaTeX?

时间:2017-07-20 12:39:29

标签: r latex rstudio

用LaTeX编写的数学方程通常在R中通过help()?访问的函数文档中呈现,并在Rstudio的帮助窗格中显示。它们无法在我的计算机上的Rstudio的帮助窗格中正确呈现。然而,我能够在所有其他应用程序和knitR输出中成功使用LaTeX。

> sessionInfo()
R version 3.3.3 (2017-03-06)
Platform: x86_64-apple-darwin13.4.0 (64-bit)
Running under: macOS Sierra 10.12.3

locale:
[1] en_US.UTF-8/en_US.UTF-8/en_US.UTF-8/C/en_US.UTF-8/en_US.UTF-8

attached base packages:
[1] stats     graphics  grDevices utils     datasets  methods   base     

loaded via a namespace (and not attached):
[1] tools_3.3.3

来自终端的输出显示我的LaTeX版本

latex -v
pdfTeX 3.14159265-2.6-1.40.17 (TeX Live 2016)
kpathsea version 6.2.2
Copyright 2016 Han The Thanh (pdfTeX) et al.
There is NO warranty.  Redistribution of this software is
covered by the terms of both the pdfTeX copyright and
the Lesser GNU General Public License.
For more information about these matters, see the file
named COPYING and the pdfTeX source.
Primary author of pdfTeX: Han The Thanh (pdfTeX) et al.
Compiled with libpng 1.6.21; using libpng 1.6.21
Compiled with zlib 1.2.8; using zlib 1.2.8
Compiled with xpdf version 3.04

E.g。当我输入?glm()时,在Rstudio中加载以下函数描述:

glm() helpfile with incorrectly rendered LaTeX code

1 个答案:

答案 0 :(得分:2)

R 中的帮助基本上以 HTML 或 LaTeX 呈现。编写文档的 .Rd 文件呈现为 PDF 手册,在 ?topichelp("topic") 调用时显示的帮助页面是 HTML 页面,这没有任何数学呈现,它是基本上只包含在 <i> </i> 标签中。

使用最彻底的文档的 HTML 形式完全放弃了数学排版,这真是一种耻辱。有人会认为 R 作为“统计环境”绝对应该处理这个问题。长话短说 - 这种行为没有错误。

但是,实际上,如果您是软件包开发人员并且关心用户的理智,则有一种方法可以在 RStudio 帮助窗格中正确呈现数学,请参阅 https://github.com/wviechtb/mathjaxr

编辑:我创建了一个包,可以将 Rd 破解为 HTML 文档“转换”,从而为每个帮助页面启用正确的数学渲染,请参阅 https://github.com/netique/documath。这是一种猴子补丁,但效果很好。我正在与 R 开发人员联系,所以也许我们会在适当的版本中看到该功能。但是,这是长期的。