python - 使用拿破仑预处理器在狮身人面像中插入图像

Question

使用 sphinx 3.1.1，我想使用拿破仑预处理器插入图像。

似乎通过在文档字符串中使用命令：“.. image::”，它可以防止使用拿破仑预处理器进行预解释，并且文档字符串由标准 sphinx 解释器解释。

"""Func

   Args:
       var1 (number): description 1.
       var2 (string): description 2.

   Returns:
       string: description 3.

.. image:: /_images/test.png
   :width: 100
"""

我的图像被正确可视化，但参数和返回值没有被正确解释，它们看起来像纯文本。

当我删除 image 命令时，我得到了预期的解释：

"""Func

   Args:
       var1 (number): description 1.
       var2 (string): description 2.

   Returns:
       string: description 3.
"""

有没有人有办法解决吗？

备注：我不想在 sphinx 标准 reStructuredText 中编写我的文档。

Answer 1

空白很重要。image 指令必须与文档字符串中的其他段落对齐。

它看起来像这样：

"""Func

   Args:
       var1 (number): description 1.
       var2 (string): description 2.

   Returns:
       string: description 3.

   .. image:: /_images/test.png
      :width: 100
"""

或者像这样：

"""
Func
 
Args:
    var1 (number): description 1.
    var2 (string): description 2.
 
Returns:
    string: description 3.
 
.. image:: /_images/test.png
   :width: 100
"""