如何让Quarto文档中定义的作者角色显示在输出文件中？

Quarto默认的HTML、DOCX模板不会自动渲染YAML头部里的roles字段，要让角色显示出来，可以用以下方法：

HTML格式解决方案 #

方法1：用内置短代码自动渲染 #

直接使用{{< meta author >}}短代码，它会自动读取YAML里的作者信息并包含角色一起渲染：

---
title: "Test"
author:
  - name: Josiah Carberry
    roles: conceptualization
format: html
---

{{< meta author >}}

## Document
content

方法2：手动自定义显示格式 #

如果需要更灵活的排版，直接在文档开头手动拼接作者和角色：

---
title: "Test"
author:
  - name: Josiah Carberry
    roles: conceptualization
format: html
---

**Josiah Carberry** | 角色：conceptualization

## Document
content

DOCX格式解决方案 #

方法1：手动插入作者角色 #

和HTML的手动方式类似，直接在文档开头写清楚作者和角色，DOCX会保留对应的文本格式：

---
title: "Test"
author:
  - name: Josiah Carberry
    roles: conceptualization
format: docx
---

**Josiah Carberry** | 角色：conceptualization

## Document
content

方法2：自定义DOCX参考模板 #

1. 先导出Quarto默认的DOCX模板，执行命令：

   quarto pandoc --print-default-data-file reference.docx > reference.docx
   

2. 用Word打开这个模板，添加或修改用于显示作者角色的样式（比如在作者姓名下方添加角色行）。
3. 在YAML头部指定这个自定义模板：

   ---
   title: "Test"
   author:
     - name: Josiah Carberry
       roles: conceptualization
   format:
     docx:
       reference-doc: reference.docx
   ---
   

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