Quarto中fig-alt含meta变量时显示异常求助

在Quarto场景下，若在图片的fig-alt属性中使用{{< meta author >}}这类短代码，会出现属性块被当成纯文本显示在图片下方、替代文本未正确嵌入HTML的问题，手动替换为具体作者名则功能正常。核心原因是Quarto短代码的解析顺序晚于Pandoc属性块的解析，导致属性内的短代码无法被识别处理。

以下是三种可行的解决方法：

• 方法一：YAML预定义替代文本变量
  在YAML头部添加预计算的image_alt变量，利用Quarto的表达式解析能力自动拼接作者名：

  ---
  title: "Title of Talk"
  author: 
    - name: Jane Doe
      affiliation: University of the Moon
  date: 2026-02-16
  image: janedoe.jpg
  categories: "Cool Stuff"
  image_alt: !expr "Photo of " .. params$author[1]$name
  ---
  

  图片引用时直接调用该变量：

  ![]({{< meta image >}}){fig-alt="{{< meta image_alt >}}"}
  

• 方法二：使用Lua过滤器自动添加替代文本
  创建名为add-fig-alt.lua的过滤器文件，内容如下：

  function Image(img)
    local author_name = quarto.metadata.author[1].name
    img.attributes["fig-alt"] = "Photo of " .. author_name
    return img
  end
  

  在YAML头部引入该过滤器：

  ---
  title: "Title of Talk"
  author: 
    - name: Jane Doe
      affiliation: University of the Moon
  date: 2026-02-16
  image: janedoe.jpg
  categories: "Cool Stuff"
  filters:
    - add-fig-alt.lua
  ---
  

  图片部分无需手动添加fig-alt，过滤器会自动为所有图片注入正确的替代文本。

• 方法三：利用内联代码块动态生成文本
  若使用R/Python作为Quarto引擎，可通过内联代码直接读取YAML元数据：

  <!-- R引擎示例 -->
  ![]({{< meta image >}}){fig-alt="Photo of `r quarto::metadata$author[[1]]$name`"}
  
  <!-- Python引擎示例 -->
  ![]({{< meta image >}}){fig-alt="Photo of `python quarto.metadata['author'][0]['name']`"}
  

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