标签: pkgdown

我有一个pkgdown网站,我在其中将许多功能分组到参考.yml文件中的类别中.我想知道是否有办法将我没有明确归类的所有功能都归入他们自己的类别.我唯一的想法是使用这样的matches功能:

reference:
- title: "someCategory"
  contents:
  - myFunction
- title: "other"
  contents:
  - matches(".*")

但是,它myFunction同时包含"someCategory"和"other"类别.我想做的是匹配所有不在类别中的功能.

谢谢!

我有一个带有多个参考书目 (MB) 的 R 包小插图，使用lua 过滤器。当我尝试将带有 MB 的小插图变成 pkgdown 文章时，我收到了 .lua 和 .bib 文件的错误，这些错误没有与小插图一起出现。

pkgdown::build_article("index", pkg = ".", data = list(), lazy = FALSE,
  quiet = FALSE) # build index.Rmd vignette (located in vignettes folder) as article

openBinaryFile: does not exist (No such file or directory

变通方法：如果我使用整个文件路径，问题就会消失： /home/user..

注意：对于 pandoc >2.11，每个参考书目只接受一个 .bib

带有 MB 的 Vignette (index.Rmd)，示例 yaml 部分：

pkgdown:
  as_is: true
output:
  rmarkdown::html_vignette:
    toc: true
    toc_depth: 1
    number_sections: true
    pandoc_args: --lua-filter=multiple-bibliographies.lua

bibliography_normal: [allrefs.bib]
bibliography_software: [packages.bib, Rrefs.bib]
bibliography_docs: …

我pkgdown向我的包中添加了一个站点vcdExtra，但无法弄清楚如何控制由 pkgdown 构建的主页上显示的包十六进制徽标的大小，https://friend.github.io/vcdExtra/index.html

该README.md文件包含一行以 200 像素插入图像

# vcdExtra <img src="man/figures/vcdExtra-logo.png" align="right" height="200" />

在 GitHub 上出现如下所示

pkgdown然而，当由index.html构建页面时，它看起来像这样，忽略了该height =属性。我怎样才能解决这个问题？我查看了其他网站的来源pkgdown，没有看到任何实质性的不同。

为了解决我的 R 包中的问题，我希望尝试使用svglite图形设备来渲染ggplot绘图：

knitr::opts_chunk$set(dev = "svglite")

但是，如果我这样做，{pkgdown} 工作流程将失败（失败日志）并显示警告消息：

1: 'mode(bg)' differs between new and previous
     ==> NOT changing 'bg' 
2: 'mode(bg)' differs between new and previous
     ==> NOT changing 'bg' 

如果我理解正确的话，这些警告消息来自par()，它抱怨无法更改背景颜色 ( bg)。但我没有明确调用par()，也没有更改相关图的背景颜色。

所以我想知道为什么我会收到此错误以及如何解决它？

到目前为止，我已经pkgdown为我的 R 包（例如ggstatsplot、kittyR等）创建了 6 个不同的网站，但它们都没有出现以下问题。

第一次，运行以下命令

pkgdown::build_site(
  lazy = FALSE,
  run_dont_run = TRUE,
  seed = 123,
  devel = TRUE
)

不呈现README徽章，我不知道为什么，因为yaml我使用的与我的其他软件包相似。我在GitHub repo上提出了问题pkgdown，但没有帮助。

更明确地说，这是我的README样子-

• 自述文件：https : //github.com/IndrajeetPatil/ipmisc/blob/master/README.md

这是pkgdown输出的样子-

• pkgdown：https ://indrajeetpatil.github.io/ipmisc/

在构建网站时，我没有收到任何警告或错误。但正如这里所见，主页上根本没有呈现徽章。关于为什么会发生这种情况或如何解决它的任何想法？

提前致谢。

一段时间以来，我一直很高兴使用 Github 的 Actions 来运行我的库R CMD check并部署包的文档。突然，打包操作开始失败，并出现以下错误：

\xe2\x94\x80\xe2\x94\x80 Commiting updated site \xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\xe2\x94\x80\nRunning git add -A .\nRunning git commit --allow-empty -m \'Built site for lares: 4.9.0@d936943\'\n\n*** Please tell me who you are.\n\nRun\n\n  git config --global user.email "you@example.com"\n  git config --global user.name "Your Name"\n\nto set your account\'s default identity.\nOmit --global to set the identity only in this repository.\n\nfatal: unable to auto-detect email address (got \'runner@Mac-1594850189701.(none)\')\n\nError: System command \'git\' failed, exit status: 128, stdout & stderr were printed\n\n …

由于某种原因pkgdown无法解析我的包中的 .Rd 文件之一。roxygen2当我使用@examples标签或替代方案向文档添加示例时，我发现它失败了@example inst/example/add.R。我将函数最小化为两个参数，以便使其更加“可重现”，但仍然出现相同的错误。请在下面找到错误消息、使用该消息生成的 .Rd 文件 devtools::document()以及该函数的 roxygen2 文档。正如您所看到的，我正在使用一个非常简单的示例，运行应该不会出现任何问题...还要说的是，当我运行devtools::check()所有示例时都通过了，所以我不明白为什么pkgdown会失败。

非常感谢你的帮助。

最好的，

错误信息

Reading 'man/merge.Rd'
Error : Failed to parse Rd in merge.Rd
i unused argument (output_handler = evaluate::new_output_handler(value = pkgdown_print))
Error: callr subprocess failed: Failed to parse Rd in merge.Rd
i unused argument (output_handler = evaluate::new_output_handler(value = pkgdown_print))

.Rd 文件

% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/merge.R
\name{merge}
\alias{merge} …