image - 狮身人面像和重构文本 : how to link an image to a document page

Question

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

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

:target: `materials`_

:target: :doc: materials

:target: materials

我怎样才能做到这一点？

Answer 1

即使在 6 年后也没有修复，尽管 :ref:现在跨文件工作就好了。但是，您不能使用 :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 主题。全部更新到最新版本。