外部资源

概述

在Shiny交互式文档中可能引用两种类型的外部资源文件:

  1. 从R代码引用的文件(例如R脚本、数据集、配置文件等);以及

  2. 从网页文档引用的静态资源(例如CSS样式表、图片等)

下面我们将描述这些资源类型在交互式文档中的处理方式。

代码资源

对于从R代码引用的文件,你可以引用位于主.qmd文件目录(或其子目录)中的任何内容。这与任何其他.qmd文件或R脚本没有区别。

同样,由执行R代码创建的文件(例如代码块生成的图表)会自动位于文档_files目录中,与HTML输出文件放在一起。这些文件不需要特殊处理。

资产资源

许多交互式文档将仅由生成的HTML和位于_files目录中的图表组成。然而,在某些情况下,你可能希望向文档添加静态图片、CSS文件或其他资源。

在这些情况下,你需要确保将文件放置在以下特殊命名的子目录之一中,以确保Shiny服务器可以找到它们:

目录 描述
images/ 图片文件(例如PNG、JPEG等)
css/ CSS样式表
js/ JavaScript脚本
www/ 任何其他文件(例如可下载的数据集)

.qmd目录中的所有文件不能从网页文档中引用的原因是,这些文件中的许多是应用程序源代码和数据,这可能不是你希望最终用户下载的内容。通过将可引用的文件限制在上面的目录中,你可以控制哪些文件是可下载的,哪些不是。