网站工具

1 页眉

常规的 HTML页面 正文结构如下。 可以给整个项目增加 页眉 ：

编辑 _quarto.yml 修改页眉的时候， 如果有长段文字，可以使用 块标量指示符 ：

2 右边距页眉

可以在右边距页眉（右侧目录上方）页眉内容 ：

3 页脚

可以在正文最后插入内容 ：

4 右边距页脚

可以在右边距页眉（右侧目录下方）增加一些页脚内容 ：

5 公告栏

在网站最顶部显示一个醒目、可自定义的横幅栏，以此来吸引访问者的注意力 ：

6 分析

适合未来有一定基础以后

7 Cookie 同意提示

适合未来有一定基础以后

8 网站资源

除了输入文件和配置文件， 网站通常还包含图片、视频、表格等资源文件， 这些文件需要随网站一同发布。Quarto 会自动检测你在网站中引用的所有文件， 并将它们复制到输出目录 _site 。 还会识别以下文件，并将它们原样复制到输出目录 ：

文件	说明
404.html	提供 404 页面的一种方式（详见 404 Page ）
robots.txt	由 Robots Exclusion Protocol定义的文件，用于告知搜索引擎爬虫可以或不可以访问网站上的哪些页面或文件
_redirects	部分发布服务商使用的页面重定向配置文件（例如 Netlify ）
CNAME	部分发布服务商用于指定自定义域名的文件（例如 GitHub Pages ）
.nojekyll	GitHub Pages 用于跳过 Jekyll 构建的文件（例如从docs/ 目录发布时）

如果这些自动检测因 bug 未能覆盖某些文件，或者希望发布一个在网站中没有链接的文件， 可以在项目级 _quarto.yml 的 project: 下添加 resources 条目。 下面的配置会将项目目录中所有的 Excel 电子表格作为网站的一部分一并包含 ：

project:
  type: website
  resources:
    - "*.xlsx"

注意 *.xlsx 这个值加了引号， 这是因为 YAML 要求以非字母数字字符开头的字符串必须用引号括起来。

也可以在单个文件的 YAML 元数据中添加resources 字段 ：

title: "My Page"
resources:
  - "sheet.xlsx"

图片是最常用的资源文件类型。全局图片（例如 Logo）需要在网站中的多个页面里引用，可以使用 站点绝对路径 来引用它，发布时 Quarto 会自动将其转换为相对路径 ：

![](/images/logo.png)

注意，语法种 /images/logo.png 第一个 / 是网站的根路径， 而不是 Linux 的根目录。 这个语法在 RStudio 的 Source 编辑模式下不能提供渲染， 但是可以正常执行

9 深色模式

可以为页面提供浅色和深色模式切换。主题 flatly 和 darkly 适合深浅搭配使用。更多内容参阅深色模式的 详细介绍 ：

模式切换开关会自动添加 ：

10 链接

• 本文