You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在Quarto中使用section-bibliography扩展自定义章节参考文献的位置?

如何在Quarto中使用section-bibliography扩展自定义章节参考文献的位置?

我明白你现在的困扰——用section-bibliographies扩展默认把参考文献放在章节末尾,但你想手动指定它的位置(比如讨论之后、补充结果之前)。之前试了section-bibs-level和:::refs:::没效果,大概率是配置或者用法细节没做对,我来一步步帮你解决:

第一步:修正并完善_quarto.yml配置

首先检查你的配置文件,确保格式和参数正确,这里有几个关键点:

  • 修复part部分的语法错误(你原配置里"Part II:"的引号没闭合,子chapters的缩进也不对)
  • 明确设置section-bibs-level为"chapter",告诉扩展按章节维度生成参考文献
  • 全局的reference-section-title可以保留,后续单个章节也能自定义标题覆盖

修正后的_quarto.yml示例:

book:
  title: "booktitle"
  author: "My Name"
  chapters:
    - introduction.qmd
    - part: "Part I"
      chapters:
        - chapter_one.qmd
        - chapter_two.qmd
    - part: "Part II"
      chapters:
        - chapter_three.qmd
        - chapter_four.qmd
filters:
  - section-bibliographies
section-bibs-level: "chapter"  # 核心参数:指定按章节生成参考文献
reference-section-title: "References"
bibliography: references.bib
csl: https://www.zotero.org/styles/springer-vancouver
format: docx

第二步:在章节中手动指定参考文献位置

现在打开每个章节的.qmd文件,找到你想要插入参考文献的位置(比如讨论模块结束后),插入:::refs:::块。如果需要给当前章节的参考文献自定义标题,还可以写成:::refs "本章参考文献" :::的形式。

举个chapter_one.qmd的示例:

## 讨论
这里是你的章节讨论内容...

# 把参考文献插在这个位置
:::refs:::

## 补充结果
这里是你的补充结果内容...

设置完成后,扩展会自动收集该章节中所有引用过的文献,生成对应的参考文献列表插入到你指定的:::refs:::位置,而不是默认的章节末尾。

常见问题排查

如果按上述步骤操作后还是没效果,检查这几点:

  • 确保扩展是最新版本:可以用quarto install extension quarto-ext/section-bibliographies命令更新
  • 确认章节中的引用有效:所有@citekey都能在你的references.bib文件中找到对应条目
  • 不要在全局配置中设置reference-section: false,这会直接禁用章节参考文献功能

备注:内容来源于stack exchange,提问作者MC26

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.04.21 11:14:36