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

如何在AsciiDoc中为图片添加无文本空白图注并通过Antora正常渲染

解决方案

以下是两种可直接实现需求的写法:

  • 方法1:在标题行的.后使用AsciiDoc内置的空占位符{empty}
    对应标记写法:

    .{empty}
    
    image::images/image3.png
    

    该写法的解析逻辑为:{empty}是AsciiDoc预定义的空值变量,不会输出任何可见字符,同时解析器会识别这是一个有效的图注标题,继续按序列生成编号,最终展示效果就是Figure 3,无多余后缀。

  • 方法2:直接在image宏的属性中指定空title
    对应标记写法:

    image::images/image3.png[title="{empty}"]
    

    效果和方法1完全一致,适合不想单独写一行标题的场景。

你之前尝试失败的原因:使用半角分号的写法会将分号识别为图注文本的一部分,所以会多出后缀;直接留空白的话AsciiDoc解析器会判定这是无效的图注标题,跳过编号生成逻辑,仅渲染图片本身。

内容的提问来源于stack exchange,提问作者didjek

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.21 23:06:01