如何调整Quarto书籍项目中Table of Contents的放置顺序？

完全可以通过_quarto.yml配置实现，不需要直接编写LaTeX代码，核心是利用Quarto书籍的前置内容配置和目录位置控制参数。

具体步骤： #

1. 标记前置内容文件
   给摘要、前言、致谢对应的.qmd文件添加YAML元数据，标记它们为非章节内容，避免被纳入正式章节编号：

   # abstract.qmd 示例
   ---
   title: "摘要"
   chapter: false
   ---
   

   前言（preface.qmd）、致谢（acknowledgments.qmd）文件做同样设置。

2. 在_quarto.yml中配置顺序
   修改项目根目录的_quarto.yml，通过book字段指定前置内容顺序，并将目录位置设置在前置内容之后：

   project:
     type: book
   
   book:
     title: "我的书籍项目"
     author: "你的名字"
     # 定义标题页后要先输出的前置内容，按顺序排列
     front-matter:
       - abstract.qmd
       - preface.qmd
       - acknowledgments.qmd
     # 开启目录，并指定位置为前置内容之后
     toc: true
     toc-location: "after-front-matter"
     # 可选：自定义目录标题和层级深度
     toc-title: "目录"
     toc-depth: 3
   
   format:
     pdf:
       documentclass: book
       # 可选：添加其他PDF相关配置，比如页码样式
       pagestyle: headings
   

关键参数说明： #

• front-matter：明确列出标题页后要输出的前置内容文件，顺序就是最终PDF里的展示顺序。
• toc-location: "after-front-matter"：这是调整目录位置的核心，Quarto默认将目录放在标题页后，这个参数会把目录移到所有前置内容之后。
• chapter: false：确保这些前置内容不会被当作正式章节，也不会自动出现在目录中（如果需要让它们出现在目录里，可以额外设置toc: true在对应文件的YAML中）。

如果需要更复杂的自定义（比如目录的LaTeX样式），可以在pdf格式的include-in-header中添加LaTeX代码，但上述配置已经能满足基本的顺序调整需求。

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