在 Sphinx 中用绝对路径替换图像

Question

我正在尝试创建一个可以跨越不同 toctree 的替代品。在 index.rst:

.. |logo| image:: _images/logo.jpg

EXAMPLE TITLE
==============
.. toctree::
   :glob:
   
   subfolder/subindex.rst

并在 subfolder/subindex.rst 中：

THE LOGO
=========
|logo|

但这并没有奏效。我尝试在 `conf.py:

中使用 epilog/prolog

rst_epilog = """
.. |logo| image:: _images/logo.jpg
"""

我还尝试在与 index.rst 相同的文件夹中创建一个 global.rst 并将其包含在两个 (.. include:: global.rst) 中，但是 subfolder/subindex.rst 的路径变成了相对路径，抱怨找不到 subfolder/global.rst

中的包含

如何实现跨 .rst 个文件的 (n)（优雅的）“全局”替换？

Answer 1

我假设您的目录中已经有一个名为 images 的文件夹。因此，您不应直接指向 sphinx 编译器创建的 _images 文件夹。

因此，您必须具有以下文件管理器：

index.rst

EXAMPLE TITLE
==============

.. toctree::
   :glob: 

   subfolder/subindex.rst

subfolder/subindex.rst

THE LOGO
=========
|logo|

conf.py

rst_prolog += '''
.. |logo| image:: /images/apluslogo.png
'''

在 Sphinx 中用绝对路径替换图像

Substitution of image with absolute path in Sphinx

python

python-sphinx

substitution

restructuredtext