Question

我花了几个小时在R-exts手册和文档上 parse_Rd()（以及参考文献中的PDF文档），但我仍然没有弄清楚results=rd的含义或使用方法。我以为我可以使用R代码片段动态创建Rd片段。这是一个例子，我期望输出是一个描述列表 HTML中的<DL>，但结果并非如此。

des <- "\\describe{\\item{def}{ghi}}"
con <- textConnection(c("\\title{abc}\\name{abc}",
                       "\\details{\\Sexpr[results=rd,stage=build]{des}}"))
z <- parse_Rd(con)
Rd2HTML(z, stages = "build")
close(con)

R 2.13.2下的输出：

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><title>R: abc</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link rel="stylesheet" type="text/css" href="R.css">
</head><body>
<table width="100%" summary="page for abc"><tr><td>abc</td><td
align="right">R Documentation</td></tr></table>
<h2>abc</h2>
<h3>Details</h3>
<p>defghi</p>
</body></html>

我实际上正在构建一个包含\Sexpr{}的Rd的包而不是真正使用Rd2HTML();内容未在之后呈现我运行R CMD构建。

有没有人试图用\Sexpr{}动态生成Rd片段？谢谢！

答案摘要

有些人已经确认这在R 2.13.1下有效，但不是更高版本（2.13.2或更高版本）

Answer 1

您的示例适用于我：

> sessionInfo()
R version 2.13.1 Patched (2011-07-08 r56332)
Platform: x86_64-unknown-linux-gnu (64-bit)

locale:
 [1] LC_CTYPE=en_GB.UTF-8       LC_NUMERIC=C              
 [3] LC_TIME=en_GB.UTF-8        LC_COLLATE=en_GB.UTF-8    
 [5] LC_MONETARY=C              LC_MESSAGES=en_GB.UTF-8   
 [7] LC_PAPER=en_GB.UTF-8       LC_NAME=C                 
 [9] LC_ADDRESS=C               LC_TELEPHONE=C            
[11] LC_MEASUREMENT=en_GB.UTF-8 LC_IDENTIFICATION=C       

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

我明白了：

> Rd2HTML(z, stages = "build")
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><title>R: abc</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link rel="stylesheet" type="text/css" href="R.css">
</head><body>

<table width="100%" summary="page for abc"><tr><td>abc</td><td align="right">R Documentation</td></tr></table>

<h2>abc</h2>

<h3>Details</h3>

<p><dl>
<dt>def</dt><dd>ghi</dd></dl>
</p>


</body></html>

我认为我现在已经理解了一些更好的排列。

这个

\name{foo}
\alias{foo}
\title{foo bar}
\description{
blah blah blah
}
\details{
\Sexpr[results=rd, stage=render]{"\\\\describe{\\\\item{def}{ghi}}"}

\Sexpr[results=rd, stage=render]{(des <- "\\\\describe{\\\\item{def}{ghi}}")}

\Sexpr[results=rd, stage=render]{tools:::Rd_expr_PR(1234)}
}

有效，例如通过以下方式处理：

R CMD Rd2pdf foo.Rd

当我直接在文件中写这个时，我不得不逃避转义\，否则我在处理Rd文件时会遇到错误。

我使用了stage=render，因为在这些演示期间，因为我没有构建一个包（但正如我所说，你的例子适用于我）。

当解析并呈现为HTML时，这也可以正常工作：

> foo <- parse_Rd("foo.Rd")
> Rd2HTML(foo)
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><title>R: foo bar</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link rel="stylesheet" type="text/css" href="R.css">
</head><body>

<table width="100%" summary="page for foo"><tr><td>foo</td><td align="right">R Documentation</td></tr></table>

<h2>foo bar</h2>

<h3>Description</h3>

<p>
blah blah blah
</p>


<h3>Details</h3>

<p>

</p>
<p>
<dl>
<dt>def</dt><dd>ghi</dd></dl>

</p>
<p>
<a href="https://bugs.R-project.org/bugzilla3/show_bug.cgi?id=1234">PR#1234</a>
</p>


</body></html>

稍微长一点的例子，展示了几种可以使用它的方法，对主题采用三种变体：

手工制作角色矢量图]
制作角色矢量并安排打印(....)
在一个\Sexpr语句中生成一个字符向量，不产生任何输出，但是通过第二个\Sexpr语句打印此向量。

这是现在文件的内容：

\name{foo}
\alias{foo}
\title{foo bar}
\description{
blah blah blah
}
\details{
\Sexpr[results=rd, stage=render]{"\\\\describe{\\\\item{abc}{ghi}}"}

\Sexpr[results=rd, stage=render]{(des <- "\\\\describe{\\\\item{def}{ghi}}")}

\Sexpr[results=hide, stage=render]{des2 <- "\\\\describe{\\\\item{xyz}{ghi}}"}
\Sexpr[results=rd, stage=render]{des2}

\Sexpr[results=rd, stage=render]{tools:::Rd_expr_PR(1234)}
}

使用R CMD Rd2pdf foo.Rd呈现正常。

在Rd文件中编写此文件时，您似乎需要额外转义任何\，如果您通过生成要解析和呈现的单个文件来尝试此操作，则需要stage=render。

什么\ Sexpr [results = rd] {}在Rd中的确切含义？

1 个答案: