如何在Quarto书籍页脚添加GitHub Pages可用的LICENSE相对链接

核心需求回顾 #

• 链接为Quarto站点内URL，不依赖GitHub仓库外部链接
• 仅维护一份LICENSE文件，无需重复拷贝

推荐解决方案（直接复用原LICENSE文件） #

这种方法无需额外创建页面，直接将LICENSE标记为站点资源，利用Quarto内置指令生成适配环境的正确链接：

1. 配置站点资源
   在_quarto.yml中添加资源声明，告诉Quarto将根目录的LICENSE文件纳入站点输出：

project:
  type: website
  resources:
    - LICENSE  # 标记LICENSE为站点资源，渲染/发布时自动复制到输出目录

2. 在页脚生成正确链接
   使用Quarto的{{< resource_path >}}指令生成适配baseURL的资源链接，替换硬编码的相对路径：

website:
  # 若为项目站点（非用户/组织主页），需设置正确的baseURL
  baseURL: "/你的仓库名/"
  footer:
    left: |
      <a href="{{< resource_path LICENSE >}}">License</a>

3. 测试与发布

• 本地执行quarto render，验证页脚链接指向正确的LICENSE文件
• 执行quarto publish gh-pages部署后，GitHub Pages上的链接会自动适配站点根路径，不会出现404

备选方案（将LICENSE转为美化页面） #

如果需要对LICENSE的展示样式进行调整（比如添加标题、格式化文本），可以将其转为Quarto页面，同时复用原LICENSE内容：

1. 创建license.qmd页面
   在根目录新建license.qmd，通过{{< include >}}指令引入原LICENSE内容，保证单一数据源：

---
title: "站点许可证"
---

<pre>
{{< include LICENSE >}}
</pre>

2. 页脚使用交叉引用链接
   利用Quarto的交叉引用指令{{< ref >}}生成页面链接，自动适配baseURL：

website:
  baseURL: "/你的仓库名/"
  footer:
    left: |
      <a href="{{< ref license.qmd >}}">License</a>

原方法失效原因 #

之前直接使用相对链接LICENSE时，部署到GitHub Pages项目站点后，站点根路径为/仓库名/，但硬编码的相对链接会解析为GitHub主页根目录，而实际LICENSE文件位于项目站点目录下，导致404错误。使用Quarto内置的resource_path或ref指令，会自动根据配置的baseURL生成正确的路径，解决环境适配问题。

内容的提问来源于stack exchange，提问作者bitt.j