reStructuredText插入图片如何添加HTML可用alt文本且兼容PDF导出

reStructuredText 原生image指令自带:alt:配置项，专门用于定义图片的替代文本，该写法完全兼容HTML导出与PDF导出，不会出现PDF渲染失败的问题。

正确写法示例：

.. image:: https://********.jpg
   :alt: 此处填写你需要的替代文本内容

原有写法异常原因说明 #

你之前使用的替换文本语法，作用是将|alternative en plusieurs mots|标记整体替换为对应图片，并非为图片设置alt属性，该语法的渲染逻辑存在导出格式兼容问题，因此会导致PDF无法正常渲染图片。

注意:alt:参数行需要相对image指令行进行缩进，否则会被识别为普通正文内容，不会生效。

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