编织HTML不保存html in vignettes /

时间:2014-05-15 16:34:12

标签: r knitr rstudio r-markdown

所以我有一个小插图,vignettes/test-vignette3.Rmd

---
title: "Sample Document"
output:
  html_document:
    highlight: kate
    theme: spacelab
    toc: yes
  pdf_document:
    toc: yes
---

Header
=========

当我点击knit HTML按钮时,我得到以下内容:

processing file: test-vignette3.Rmd
output file: test-vignette3.knit.md


Output created: /tmp/RtmpKVpegL/preview-5ef42271c0d5.dir/test-vignette3.html

但是,如果我将此文件复制到inst/doc并点击knit HTML按钮,我会:

processing file: test-vignette3.Rmd
output file: test-vignette3.knit.md


Output created: test-vignette3.html

我的问题是:

  1. 如何让RStudio将knit HTMLvignettes/test-vignette3.Rmw的输出保存到vignettes目录?
  2. 如何在test-vignette3.knit.md程序中让RStudio不删除knit HTML? (我想要.md所以人们可以在我的github回购中阅读。)
  3. 我正在运行RStudio版本0.98.836,rmarkdown版本0.1.98和knitr版本1.5。

1 个答案:

答案 0 :(得分:6)

实际上你应该将.html输出保存在vignettes/下,因为插图输出应该由R CMD build生成。如果在构建源包时HTML输出文件已经存在,则R可能无法重新编译您的晕影,这意味着您可能会看到旧的(可能是错误的)结果,因为HTML文件不是从最新版本的.Rmd个文件。因此,RStudio有意避免在vignetttes目录中编写HTML文件。

如果您选择忽略上述警告,您当然可以在R控制台中运行rmarkdown::render('your-vignette.Rmd')

对于第二个问题,我也不建议您这样做,因为Github以不同的方式呈现降价格式(与通过 rmarkdown 包完成的Pandoc转换相比)。通常,程序包晕影显示在CRAN上,例如,请参阅CRAN上的the knitr page。但是,由于rmarkdown软件包还没有在CRAN上,你现在不能使用晕影引擎knitr::rmarkdown(我想我们现在距离CRAN版本不太远)。但是,您可以考虑将HTML文件推送到Github页面。