Quarto列表中使用相对路径失效问题求助

首先明确：你没有错误使用../，但Quarto的listing配置中，contents的路径解析不是基于当前qmd文件所在目录，而是基于项目根目录（也就是_quarto.yml所在的目录）。

问题原因 #

当你在dir1/index.qmd里写../dir2/test.qmd时，Quarto会从项目根目录出发解析这个路径，相当于寻找根目录上一级的dir2/test.qmd，显然不存在，所以列表为空。而如果把文件放在当前目录，路径对应项目根下的dir1/test.qmd，能被正确识别。

解决方案 #

直接使用相对于项目根目录的路径，去掉../：
修改dir1/index.qmd中的listing配置：

listing:
  - id: test
    contents:
      - dir2/test.qmd
    type: table
    fields: [title]
    field-display-names:
      title: "Title"

验证说明 #

修改后重新编译项目，Quarto会正确定位到dir2/test.qmd，列表就能正常显示该文档的标题。另外需要说明：dir2/test.qmd的revealjs格式不影响listing识别它的元数据（比如title），只要文件在项目范围内即可。

内容的提问来源于stack exchange，提问作者Stefan Hansen