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

Question

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

imagehyperlinkpython-sphinxrestructuredtext

6

在RST语法中，您可以为设置链接指定:target:属性。我想将图像链接到一个名为“Materials”的“materials.rst”文档页面。

但是以下两个值都无法作为目标值：

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

我该如何实现这个功能？

- galinette

我还没有找到一种方法来实现它 - 我相信这是不可能的。(同样，我也看不到链接到 :ref: 的方法。) - Daniele Procida

如果你只是在构建HTML文档，那么:target: materials.html是有效的。 - Matt Hancock

1个回答

网页内容由stack overflow 提供, 点击上面的

可以查看英文原文，
原文链接

- Dare The Darkness · Accepted Answer

即使经过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 的名称是正确的。如果我错了怎么办？这是一种纯粹的 hack。我无法相信没有人被打扰到修复这个问题。

我在 Sphinx 4.2.0 上使用 RTD 主题，所有内容都已更新到最新版本。