如何在 {pkgdown} 站点中手动创建链接？答案

【问题标题】：How can I manually create links within a {pkgdown} site?如何在 {pkgdown} 站点中手动创建链接？
【发布时间】：2021-06-26 05:27:06
【问题描述】：

pkgdownautolinking vignette 详细介绍了该软件包如何在网站中创建链接，包括到网站本身的其他页面和其他软件包的文档。我想知道是否有一种简单的方法可以复制它。例如。是否有可以在构建站点时运行的函数，例如generate_pkgdown_link("my_function") 将创建这样的链接。这将非常有用，例如用于创建描述包结构的 HTML 流程图等。

请注意，查看自动生成的链接并生成看起来相同的内容相对简单。主要困难在于生成一个无论网站托管在哪里都可以工作的链接 - 例如。无论是托管在本地还是在 RStudio Connect 服务器上。

【问题讨论】：

标签： html r pkgdown

【解决方案1】：

对于任何试图回答相同问题的人，有一个记录在案的解决方案，我在写这个问题时不知何故错过了 - 使用downlit::downlit_html_no()，例如

node <- xml2::read_xml("<p><code>base::t()</code></p>")
node
#> {xml_document}
#> <p>
#> [1] <code>base::t()</code>

# node is modified in place
downlit::downlit_html_node(node)
node
#> {xml_document}
#> <p>
#> [1] <code>\n  <a href="https://rdrr.io/r/base/t.html">base::t()</a>\n</code>

^{由reprex package (v2.0.0) 于 2021-04-09 创建}

【讨论】：