Quarto DOCX输出中目录位置调整及DOCX合并方法咨询

方法1：修改_quarto.yml调整目录位置 #

要把目录移到标题页之后，只需两步操作：

1. 关闭默认自动目录
   在_quarto.yml的book节点下添加toc: false，禁用开头自动生成的目录：

   project:
     type: book
   
   book:
     title: "客户报告"
     author: "你的名称"
     chapters:
       - title: "标题页"
         file: title-page.qmd  # 单独存放标题页内容的文件
       - title: "目录"
         file: toc-section.qmd
       - title: "核心内容章节1"
         file: content-1.qmd
       # 其他章节按需添加...
     toc: false  # 关键配置：关闭默认开头目录
   

2. 手动插入目录到指定位置
   创建toc-section.qmd文件，仅需一行代码即可插入目录：

   {{< toc >}}
   

   渲染后，目录会自动出现在标题页之后的指定章节。标题页内容直接编写在title-page.qmd中即可，无需特殊格式。

方法2：合并两个DOCX文件 #

如果已生成单独的标题页DOCX和Quarto渲染好的Book DOCX，可通过以下两种方式合并：

手动合并（适合非技术场景） #

打开标题页DOCX文件，点击插入 → 对象 → 文件中的文字，选择Quarto渲染生成的DOCX文件，按需选择是否保留格式，确认后即可完成合并。

脚本合并（适合批量/自动化场景） #

使用Python的python-docx库编写简单脚本实现自动合并：

1. 先安装依赖：

   pip install python-docx
   

2. 编写合并脚本：

   from docx import Document
   
   # 加载两个目标文档
   title_doc = Document("your-title-page.docx")
   quarto_doc = Document("your-quarto-book.docx")
   
   # 将内容文档的所有元素追加到标题页文档末尾
   for elem in quarto_doc.element.body:
       title_doc.element.body.append(elem)
   
   # 保存合并后的最终报告
   title_doc.save("final-client-report.docx")
   

   替换脚本中的文件名后运行，即可生成合并完成的完整报告。

内容的提问来源于stack exchange，提问作者M. Wood