\Sexpr[results=rd]{}在rd中的确切含义是什么?
我花了几个小时在R-exts手册和\Sexpr[results=rd]{}在rd中的确切含义是什么?,r,R,我花了几个小时在R-exts手册和 parse_Rd()(以及参考资料中的PDF文档),但我 仍然没有弄清楚results=rd是什么意思或者如何使用它。我想我可以 使用R代码片段动态创建Rd片段。这是 一个示例,其中我希望输出是一个描述列表 在HTML中,但事实证明并非如此 des <- "\\describe{\\item{def}{ghi}}" con <- textConnection(c("\\title{abc}\\name{abc}",
parse_Rd()
(以及参考资料中的PDF文档),但我
仍然没有弄清楚results=rd是什么意思或者如何使用它。我想我可以
使用R代码片段动态创建Rd片段。这是
一个示例,其中我希望输出是一个描述列表
在HTML中,但事实证明并非如此
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)
des您的示例适用于以下方面:
> 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>
当我直接在一个文件中写这篇文章时,我还必须逃逸转义\
,否则我在处理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>
它使用R CMD Rd2pdf foo.Rd
进行精细渲染
在Rd文件中写入此文件时,似乎需要额外转义任何\
,如果要通过生成单个要解析和渲染的文件来尝试此操作,则需要stage=render
\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
> 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>
\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)}
}