【问题标题】:Using sphinx to auto-document a python class, module使用 sphinx 自动记录 python 类、模块
【发布时间】:2023-04-04 06:36:01
【问题描述】:

我已经安装了Sphinx 以记录我正在处理的一些 Python 模块和类。虽然标记语言看起来很不错,但我还没有设法自动记录 Python 代码。

基本上,我有以下 Python 模块:

SegLib.py

还有一个名为Seg 的类。我想在生成的 Sphinx 文档中显示类和模块的文档字符串,并在其中添加更多格式化文本。

我的index.rst 看起来像这样:

Contents:

.. toctree::
:maxdepth: 2

chapter1.rst

chapter1.rst:

This is a header
================
Some text, *italic text*, **bold text**

* bulleted list.  There needs to be a space right after the "*"
* item 2

.. note::
   This is a note.

See :class:`Seg`

Seg 只是以粗体打印,并没有链接到自动生成的类文档。

尝试以下方法也无济于事:

See :class:`Seg`
Module :mod:'SegLib'
Module :mod:'SegLib.py'

编辑:将 SegLib 更改为分段(感谢 iElectric!),并将 chapter1.rst 更改为:

The :mod:`segments` Module
--------------------------

.. automodule:: segments.segments

.. autoclass:: segments.segments.Seg

仍然无法让 Sphinx 直接记录类中的函数,或者更好的方法 - 自动将类中的所有函数添加到文档中。试过了:

.. autofunction:: segments.segments.Seg.sid

得到:

autodoc can't import/find function 'segments.segments.Seg.sid', it reported error: "No module named Seg"

任何想法如何使用简短的命令自动记录函数和类?

【问题讨论】:

    标签:
    python
    python-sphinx
    autodoc