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

问题描述

我正在尝试创建一个可以跨越不同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
"""

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

中找不到包含内容

一个人如何在.rst个文件中实现（n）个（优雅的）“全局”替换？

解决方法

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

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

index.rst

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

.. toctree::
   :glob: 

   subfolder/subindex.rst

子文件夹/subindex.rst

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

conf.py

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