Sphinx & reStructuredText：如何将图像链接到文档页面

Question

在RST语法中，您可以指定:target:用于设置链接的属性。我想将图像链接到“materials.rst”文档页面，其主要部分标题是“Materials”

但这些都不能作为目标值：

• :target: `materials`_
• :target: :doc: materials
• :target: materials

我怎样才能实现这个目标？

Answer 1

尽管:ref:现在跨文件工作得很好，但即使在 6 年后也没有修复。但是，您不能:ref:在图像或图形指令中使用。

尝试使用这个：

:target: materials.html

...并希望一切顺利！该:target:角色似乎只接受 HTML 链接。

假设有一些名为 doc.rst 的文件，我想通过另一个文档中的缩略图访问该文件：

.. _doc:

Some Title
==========

...然后，在另一个文档中，我使用以下解决方案：

.. image:: /media/thumbnail_of_my_doc.jpg
   :ref:`doc` <- doesn't compute
   :target: doc (or doc.rst, or doc_) <- doesn't work either
   :target: doc.html <- works im my case

最后一个选项之所以有效，是因为我假设了要生成的 HTML 的名称。如果我错了怎么办？这是一个纯粹的黑客行为。我不敢相信没有人费心去解决这个问题。

我在 Sphinx 4.2.0 上使用 RTD 主题。全部更新到最新版本。