pkgdown::build_site() 未在 HTML 渲染中捕获 R 包徽标
pkgdown::build_site() not capturing R package logo in HTML renders
我最近买了一台新笔记本电脑 Windows 11（尽管我的 sessionInfo() 说 Windows 10) 并且我正在尝试为我正在开发的 R 包构建一个 pkgdown 站点。这不是我过去遇到的问题。 运行 命令 pkgdown::build_site() 没有正确 link 我的自定义徽标到此 R 包的 HTML 站点。
下面的自定义徽标 png，供后代使用：
brConnectR logo
man/figures/logo.png 文件是用 usethis::use_logo("path/to/logo.png") 生成的，网站图标是作为 pkgdown::build_site() 过程的一部分生成的，但是，生成的 docs/index.html 无法捕获任何徽标.下面是我的 sessionInfo():
> sessionInfo()
R version 4.1.1 (2021-08-10)
Platform: x86_64-w64-mingw32/x64 (64-bit)
Running under: Windows 10 x64 (build 22000)
Matrix products: default
locale:
[1] LC_COLLATE=English_United States.1252 LC_CTYPE=English_United States.1252
[3] LC_MONETARY=English_United States.1252 LC_NUMERIC=C
[5] LC_TIME=English_United States.1252
attached base packages:
[1] stats graphics grDevices utils datasets methods base
other attached packages:
[1] brConnectR_0.0.0.9000 usethis_2.1.3
loaded via a namespace (and not attached):
[1] tidyselect_1.1.1 xfun_0.27 remotes_2.4.1 purrr_0.3.4
[5] rcmdcheck_1.4.0 vctrs_0.3.8 generics_0.1.1 testthat_3.1.0
[9] htmltools_0.5.2 yaml_2.2.1 utf8_1.2.2 blob_1.2.2
[13] rlang_0.4.12 pkgbuild_1.2.0 pkgdown_1.6.1 pillar_1.6.4
[17] glue_1.4.2 withr_2.4.2 DBI_1.1.1 bit64_4.0.5
[21] xopen_1.0.0 dbplyr_2.1.1 sessioninfo_1.1.1 lifecycle_1.0.1
[25] stringr_1.4.0 commonmark_1.7 devtools_2.4.2 memoise_2.0.0
[29] evaluate_0.14 knitr_1.36 callr_3.7.0 fastmap_1.1.0
[33] ps_1.6.0 curl_4.3.2 fansi_0.5.0 Rcpp_1.0.7
[37] clipr_0.7.1 cachem_1.0.6 desc_1.4.0 pkgload_1.2.3
[41] magick_2.7.3 fs_1.5.0 bit_4.0.4 hms_1.1.1
[45] digest_0.6.28 stringi_1.7.5 processx_3.5.2 dplyr_1.0.7
[49] rprojroot_2.0.2 cli_3.0.1 tools_4.1.1 odbc_1.3.2
[53] magrittr_2.0.1 tibble_3.1.5 crayon_1.4.1 pkgconfig_2.0.3
[57] ellipsis_0.3.2 xml2_1.3.2 prettyunits_1.1.1 assertthat_0.2.1
[61] rmarkdown_2.11 roxygen2_7.1.2 rstudioapi_0.13 R6_2.5.1
[65] compiler_4.1.1
如有指点，将不胜感激！
我在 pkgdown::build_home() reference page 的 Package Logo 部分之后解决了这个问题：
If you have a package logo, you can include it at the top of your
README in a level-one heading:
# pkgdown <img src="man/figures/logo.png" align="right" />
init_site() will also automatically create a favicon set from your package logo.
除上述之外，我还安装了 pkgdown 的开发版本，这修复了我在 运行 pkgdown::build_site() 时收到的神秘警告（“警告已弃用：markdown_github. 使用 gfm").
从 GitHub 安装开发版本：devtools::install_github("r-lib/pkgdown")
我最近买了一台新笔记本电脑 Windows 11（尽管我的 sessionInfo() 说 Windows 10) 并且我正在尝试为我正在开发的 R 包构建一个 pkgdown 站点。这不是我过去遇到的问题。 运行 命令 pkgdown::build_site() 没有正确 link 我的自定义徽标到此 R 包的 HTML 站点。
下面的自定义徽标 png，供后代使用： brConnectR logo
man/figures/logo.png 文件是用 usethis::use_logo("path/to/logo.png") 生成的，网站图标是作为 pkgdown::build_site() 过程的一部分生成的，但是，生成的 docs/index.html 无法捕获任何徽标.下面是我的 sessionInfo():
> sessionInfo()
R version 4.1.1 (2021-08-10)
Platform: x86_64-w64-mingw32/x64 (64-bit)
Running under: Windows 10 x64 (build 22000)
Matrix products: default
locale:
[1] LC_COLLATE=English_United States.1252 LC_CTYPE=English_United States.1252
[3] LC_MONETARY=English_United States.1252 LC_NUMERIC=C
[5] LC_TIME=English_United States.1252
attached base packages:
[1] stats graphics grDevices utils datasets methods base
other attached packages:
[1] brConnectR_0.0.0.9000 usethis_2.1.3
loaded via a namespace (and not attached):
[1] tidyselect_1.1.1 xfun_0.27 remotes_2.4.1 purrr_0.3.4
[5] rcmdcheck_1.4.0 vctrs_0.3.8 generics_0.1.1 testthat_3.1.0
[9] htmltools_0.5.2 yaml_2.2.1 utf8_1.2.2 blob_1.2.2
[13] rlang_0.4.12 pkgbuild_1.2.0 pkgdown_1.6.1 pillar_1.6.4
[17] glue_1.4.2 withr_2.4.2 DBI_1.1.1 bit64_4.0.5
[21] xopen_1.0.0 dbplyr_2.1.1 sessioninfo_1.1.1 lifecycle_1.0.1
[25] stringr_1.4.0 commonmark_1.7 devtools_2.4.2 memoise_2.0.0
[29] evaluate_0.14 knitr_1.36 callr_3.7.0 fastmap_1.1.0
[33] ps_1.6.0 curl_4.3.2 fansi_0.5.0 Rcpp_1.0.7
[37] clipr_0.7.1 cachem_1.0.6 desc_1.4.0 pkgload_1.2.3
[41] magick_2.7.3 fs_1.5.0 bit_4.0.4 hms_1.1.1
[45] digest_0.6.28 stringi_1.7.5 processx_3.5.2 dplyr_1.0.7
[49] rprojroot_2.0.2 cli_3.0.1 tools_4.1.1 odbc_1.3.2
[53] magrittr_2.0.1 tibble_3.1.5 crayon_1.4.1 pkgconfig_2.0.3
[57] ellipsis_0.3.2 xml2_1.3.2 prettyunits_1.1.1 assertthat_0.2.1
[61] rmarkdown_2.11 roxygen2_7.1.2 rstudioapi_0.13 R6_2.5.1
[65] compiler_4.1.1
如有指点，将不胜感激！
我在 pkgdown::build_home() reference page 的 Package Logo 部分之后解决了这个问题：
If you have a package logo, you can include it at the top of your README in a level-one heading:
# pkgdown <img src="man/figures/logo.png" align="right" />init_site() will also automatically create a favicon set from your package logo.
除上述之外，我还安装了 pkgdown 的开发版本，这修复了我在 运行 pkgdown::build_site() 时收到的神秘警告（“警告已弃用：markdown_github. 使用 gfm").
从 GitHub 安装开发版本：devtools::install_github("r-lib/pkgdown")