如何在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
相关产品推荐
相关产品推荐

