如何结合 sphinx docstring 在 numpy docstring 中正确添加嵌套列表

Question

我想知道如何实现以下目标。我将 numpy 文档字符串样式与 sphinx autodoc 结合使用来生成自动文档。但是，我很难在输出中包含一个嵌套列表：

Attributes
----------
attribute 1: pandas data frame
    * `index:` Array-like, integer valued representing
          days. Has to be sorted and increasing.
    * `dtype:` float64. Value of temperature.
    * `columns:` location description, e.g. 'San Diego'
attribute 2: `int`
    nice and sunny days in California

此文档字符串的输出已完成。它无法识别属性 1 的列表。

另一方面，函数描述跨越多行：

def generate_temp(self, n, freq, very_long_variable_name,
                  type_temp=None, method=None):

此外，这里的 sphinx 无法识别完整的函数，而是将第二行与第一行分开处理。

我的格式有什么问题？

Answer 1

对于NumPy docstrings in Napoleon，你需要在冒号两边加一个space。试试这个：

Attributes
----------
attribute 1 : pandas data frame
    * `index:` Array-like, integer valued representing
      days. Has to be sorted and increasing.
    * `dtype:` float64. Value of temperature.
    * `columns:` location description, e.g. 'San Diego'
attribute 2 : `int`
    nice and sunny days in California

我不知道这是否可行，因为 example NumPy strings 表示仅支持段落。它没有提到任何关于列表的内容。