我想在 reStructuredText 中创建一个图像，它将在 html 中有一个替代 (<alt>) 并且仍然可以在 pdf 中工作

Question

所以我正在编写 reStructuredText，它会同时创建一个 HTML 页面和一个 PDF。我想为 HTML 中的图像添加替代文本，但是当我在我的代码中添加它时，图像在 PDF 中不起作用！

我的代码没有替代文本（在两种情况下都有效）：

.. image:: https://********.jpg

我的代码在 PDF 中不起作用：

|alternative en plusieurs mots|

.. |alternative en plusieurs mots| image:: https://*********.jpg

Answer 1

根据 docutils 的文档 image directive，以下应该有效：

.. image:: https://********.jpg
    :alt: alternative en plusieurs mots

I want to create an image in reStructuredText, which will have an alternative (<alt>) in html and still work in pdf