knitr виньетки .Rmd не появляются с виньеткой()

Question

В пакете я разрабатываю с R Studio, я создаю виньетки с помощью devtools::use_vignette("mydoc.Rnw"), что дает стандартную виньетка заголовок как

--- 
title: "Title" 
author: "Michael Friendly" 
date: "`r Sys.Date()`" 
output: rmarkdown::html_vignette 
vignette: > 
    %\VignetteIndexEntry{Title} 
    %\VignetteEngine{knitr::rmarkdown} 
    %\VignetteEncoding{UTF-8} 
--- 

Я следовал всем инструкции в http://yihui.name/knitr/demo/vignette/ и http://r-pkgs.had.co.nz/vignettes.html. Виньетки являются, перечисленными на странице CRAN для пакета, однако они кажутся недоступными в сеансе R с загруженным пакетом.

> browseVignettes("matlib") 
No vignettes found by browseVignettes("matlib") 

> library(tools) 
> names(vignetteEngine(package = 'matlib')) 
Error in getEngine(name, package) : 
    None of packages ‘matlib’ have registered vignette engines 

Я знаю, что другие пакеты с knitr -processed виньеток .Rmd доступны из пакета, но не могу понять, почему мои не являются. Что не хватает?

В моем vignettes/ каталоге содержатся только файлы .Rmd (без файлов PDF), но это похоже на то, что, например, https://github.com/yihui/knitr/tree/master/vignettes.

Answer 1

Примечание DevTools не строит виньетки по умолчанию, когда вы devtools::install() (то же самое для некоторых функций, таких как install_*install_github()) пакет из каталога. При установке пакета необходимо указать аргумент build_vignettes = TRUE. В настоящее время нет способа создать виньетки, используя devtools, если вы просто используете кнопку RStudio Build & Reload. Вы должны Build Source Package, и запустите R CMD INSTALL на tarball. Или запустите devtools::install(build_vignettes = TRUE) в консоли R.