Quarto子文档多次渲染时如何正确引用图表？

核心原因 #

尽管设置了options(knitr.duplicate.label = "allow")允许重复标签，但Quarto的交叉引用系统默认会将相同标签的最后一个实例作为引用目标，无法自动区分不同章节内的同标签元素。

解决方案：参数化图表标签 #

利用传入子文档的日期参数，为每个章节的图表标签添加唯一标识，从根源上避免标签冲突：

• 在调用子文档的每日文档中，传入日期参数：

  ---
  title: "2024-05-20"
  params:
    date: "2024-05-20"
  ---
  
  {{< include day-template.qmd >}}
  

• 在day-template.qmd子文档中，通过params$date动态生成唯一图表标签：

  ```{r fig-a-{{< params date >}}, fig.cap="每日数据图表"}
  plot(rnorm(100))
  

  查看当日图表：@fig-a-{{< params date >}}

• 确保Quarto配置文件（_quarto.yml）开启交叉引用支持：

  book:
    chapters:
      - index.qmd
      - 2024-05-20.qmd
      - 2024-05-21.qmd
  crossref:
    figPrefix: "图"
  

补充说明 #

通过给标签添加日期后缀，每个章节的图表标签都成为唯一标识，Quarto交叉引用系统就能精准匹配对应章节的图表，无需依赖knitr.duplicate.label设置。

内容的提问来源于stack exchange，提问作者Matt Pollock