sphinx automodule:如何引用同一模块中的类？
在Python中，使用Sphinx文档生成器时，可以使用automodule指令来自动生成模块的文档。如果需要在文档中引用同一模块中的类，可以使用:class:角色来实现。
假设我们有一个名为my_module的模块，其中包含一个名为MyClass的类。要在文档中引用该类，可以使用以下语法：
:class:`MyClass`这将在文档中生成一个指向MyClass的超链接，并将其显示为MyClass。
例如，在以下文档中，我们引用了my_module中的MyClass类：
This is an example of using :class:`MyClass` in the `my_module` module.这将在生成的文档中显示为：
This is an example of using MyClass in the my_module module.其中，MyClass将作为一个超链接，指向my_module中的MyClass类。
需要注意的是，在使用:class:角色时，必须使用反引号将类名包含起来，并且类名必须在模块中定义。此外，如果类名包含模块名称，可以使用以下语法来引用：
:class:`my_module.MyClass`这将在文档中生成一个指向my_module.MyClass的超链接，并将其显示为my_module.MyClass。
相关·内容
我正在尝试使用sphinx扩展，特别是automodule指令，为我正在开发的应用程序自动生成文档。问题是，我希望在模块中创建对不同类的内部引用，而不必在项目中的每个类/函数上使用autoclass和autofunction。对于这样的源文件：
# source_code.py
class A:
"""docs for A
"""
pass
class B:
"""docs for B with
:ref:`internal reference to A <XXXX-som
浏览 95提问于2011-10-13得票数 31
回答已采纳
在用sphinx-apidoc.生成RST文件时，无法正确添加__main__.py文件及其函数其他文件和类是正确生成的。
只有当我使用包含私有模块的-P参数运行sphinx时，我才能工作。但是我不想添加其他模块的私有方法，我只需要从__main__.py获得这些方法。
__main__.py看起来是这样的：
def main():
"""
main() description here
"""
f1()
f2()
if __name__ == '__main__':
main()
浏览 0提问于2019-01-11得票数 1
回答已采纳
我有下面的包结构作为一个最小的例子(为了方便，所有都上传了)：
.
├── sphinx
│ ├── build
│ ├── Makefile
│ └── source
│ ├── conf.py
│ ├── index.rst
│ └── train.rst
└── train
├── __init__.py
└── train.py
在编写package时，必须在任何包的__all__中指定__init__.py常量，以便狮身人面像能够将引用(如train.DatasetMeta )映射到train.train.Dataset
浏览 0提问于2018-08-16得票数 16
2回答
我有一个Python模块，my_module.py，如下所示：
import numpy
class A(numpy.ndarray):
""" Extension for illustration. """
pass
class B:
""" My base class. """
def x():
""" Does the thing. """
pass
class C(B):
浏览 10提问于2017-08-15得票数 2
回答已采纳
4回答
我正在尝试使用Sphinx为我的代码库自动生成基本文档。然而，我在指示Sphinx递归扫描我的文件时遇到了困难。
我有一个Python代码库，它的文件夹结构如下：
<workspace>
└── src
└── mypackage
├── __init__.py
│
├── subpackageA
│ ├── __init__.py
│ ├── submoduleA1
│ └── submoduleA2
│
└── subp
浏览 5提问于2011-01-06得票数 54
回答已采纳
1回答
我希望Sphinx文档的左边菜单有我的项目的模块，我想从主模块的__init__.py文件中定义这个内容。这就是我想要做的：
__init__.py
'''
Components platform:
--------------------
* language: python
* rest framework: flask-restful
* testing: pytest
* documentation: sphinx
.. toctree::
:maxdepth: 1
:caption: Contents:
.. automodule::
浏览 0提问于2021-04-12得票数 0
1回答
嗨，我正在为一个使用sphinx的Django项目写一些文档。
我的项目(Django 1.4)如下所示：
/funproject
/documentation
# this is where sphinx files live
/source
conf.py
...
/funproject
__init__.py
settings.py
admin.py
models.py
/app1
/app2
fabfile.py
mana
浏览 2提问于2013-03-16得票数 2
在autodoc中，我知道您可以为所有模块隐藏文档字符串，如下所述：
但是，是否有一种方法可以对某些模块而不是其他模块这样做，可能会将一些参数传递给automodule？换句话说，对于给定的模块，我希望有时包含文档字符串，有时跳过它。如果我这样做了：
.. automodule:: foo
:members: foo, foo.bar
Sphinx为foo和foo.bar生成文档字符串。不过，
.. automodule:: foo
:members: foo.bar
不会隐藏模块文档字符串。
浏览 2提问于2017-03-22得票数 3
我有一个python包，即将从epydoc迁移到sphinx。这个包本身包含了sphinx的automodule函数。现在，我希望在我的文档模块开头的一个简单列表/表中列出模块中所有类的摘要，或者更好(？)在toc-tree中。
我的自动模块部分(在pymunk.rst中)如下所示
.. automodule:: pymunk
:members:
:undoc-members:
:show-inheritance:
:inherited-members:
然后在pymunk.constraint.rst中
.. automodule:: pymunk.const
浏览 3提问于2012-08-28得票数 6
回答已采纳
我正在使用rST/Sphinx来记录我的Python，但是在构建它时会抛出警告，比如
...Code/doc/code.rst:3: SEVERE: Duplicate ID: "module-toast".
我的Python源文件的文档如下：
#!/usr/bin/env python
'''
.. module:: toast
:synopsis: Processes the blobs produced by :mod:`bread`.
'''
# my inline-rST documented code...
r
浏览 2提问于2013-05-10得票数 5
1回答
:data:`~package._module._DICT_NAME`
不工作，_DICT_NAME呈现为引用，但没有超链接。:obj:也是如此。将其放入函数中是不可接受的解决办法。
极小conf.py
extensions = ['sphinx.ext.autodoc']
templates_path = ['_templates']
exclude_patterns = []
html_static_path = ['_static']
def skip(app, what, name, obj, would_skip, options)
浏览 3提问于2020-06-06得票数 1
回答已采纳
2回答
我正在尝试使用狮身人面像作为我的文档。令人惊讶的是，它适用于某些类和模块，而对于一些类和模块则不起作用。
下面可以找到一个源文件和.rst文件，其中sphinx不添加类。
我使用狮身人面像'sphinx.ext.autodoc‘扩展。
为什么狮身人面像不将我的类添加到文档中？如何在这种情况下调试狮身人面像？
我的狮身人面像: my_project.analyzers.content_ascii.rst
my_project.analyzers.content_ascii package
==========================================
Submod
浏览 3提问于2014-05-27得票数 0
回答已采纳
我使用sphinx和autodoc扩展从python模块中的docstring自动生成文档。
我目前使用automodule指令来记录该模块的所有公共成员。
.. automodule::
:members:
我的模块也有许多私有属性。我想把其中一个写进文件里。
有没有一种方法可以告诉automodule记录所有的公共成员，以及这一个私有成员？我尝试过使用:private-members:选项，但这包括所有私有成员。我也尝试过手动指定私有属性，但是它没有记录任何公共成员。
.. automodule::
:members: _PRIVATE_ATTR
我想避免手动列出每个公共成
浏览 1提问于2019-01-31得票数 4
回答已采纳
3回答
我使用的是Sphinx，我真的很喜欢它，但它不能提取模块概要。没有错误或任何东西，只是简单的.没什么。这是我试图自动创建文档的模块：
# vim: set fileencoding=utf-8 :
"""
.. module:: CONF
:synopsis: Configuration module, tells where data files are.
.. moduleauthor:: Mr Anderson <mr@matrix.com>
"""
这是ReST索引文件中的Sphinx指令：
.. automodule
浏览 1提问于2013-01-16得票数 5
5回答
这是的通用版本。
有没有一种方法可以递归地自动创建包含类和函数的模块或包？
我认为为每个函数添加autofunction或automodule指令是愚蠢的；必须有一种方法来自动化这个过程，否则我根本看不到使用Sphinx的意义。
Clarification:而不是：
.. automodule:: segments.segments
.. autoclass:: segments.segments.Seg
.. automethod:: Seg.method_1
.. automethod:: Seg.method_2
.. au
浏览 74提问于2009-08-25得票数 18
回答已采纳
在Sphinx文档中，我定义了如下所示的参考文档：
Reference
=========
.. toctree::
reference_api
reference_cli
reference_client
reference_downloads
reference_options
reference_stats
reference_utils
reference_api文档如下所示：
API module
==========
.. automodule:: aria2p.api
:no-members:
API
---
.. au
浏览 5提问于2019-10-21得票数 7
回答已采纳
1回答
Gooday，我在自动生成python文档方面遇到了麻烦。我的项目布局如下：
project_folder
封装
module1.py
module2.py
博士
make.bat
构建
源
index.rst
package.rst
modules.rst
conf.py
在module1.py和module2.py中有一些类(带有docstring)。我在conf.py中添加了以下一行：
sys.path.insert(0, os.path.abspath('../../package'
浏览 3提问于2015-07-17得票数 4
回答已采纳
它是否可以从sphinx中删除包和模块名？
示例:如果在模块foo.bar中存在一个名为waa的函数，则使用rst代码
.. automodule:: foo.bar
:members:
会产生
foo.bar.waa()
我想要输出
waa()
浏览 4提问于2013-12-31得票数 31
回答已采纳
1回答
我决定使用autosummary来创建我的模块的文档。在index.rst中，我“导入”了我想要文档的所有相关模块和子模块。这些模块是按预期记录的，但有一件事困扰着我。模块路径相当长，在文档旁边的树中它们看起来很讨厌。
index.rst
Documentation
*************
Documentation of things.
.. toctree::
.. autosummary::
:toctree: _autosummary
module
module.submodule
module.submodule.sub
module.lo
浏览 1提问于2019-02-05得票数 1
回答已采纳
5回答
我试图使用Sphinx在Python中记录一个5,000+行项目。它有大约7个基本模块。据我所知，为了使用autodoc，我需要为项目中的每个文件编写如下代码：
.. automodule:: mods.set.tests
:members:
:show-inheritance:
这太乏味了，因为我有很多文件。如果我可以指定我希望“mods”软件包被记录下来，那就容易多了。Sphinx可以递归地遍历包并为每个子模块创建一个页面。
有这样的特色吗？如果不是，我可以编写一个脚本来创建所有的.rst文件，但是这需要花费大量的时间。
浏览 9提问于2010-04-23得票数 213
回答已采纳
我有一些在python中使用元类的代码。但是当运行sphinx autodoc时，它给出了错误：
WARNING: py:class reference target not found: type
错误发生在自动生成的.rst文件的一行中：
.. automodule:: API.list.blockList
:members: # this is the line in error
:show-inheritance:
blockList扩展了API.list.list，它将\__metaclass__设置为我的元类。
据我所知，sphinx并不认为内置类型类存在。我曾尝试
浏览 4提问于2012-07-10得票数 20
1回答
我已经开始在django项目中使用Sphinx了，我碰到了一块砖墙：
这些模块的文档如下所示：
:mod:`models` Module
--------------------
.. automodule:: userprofile.models
:members:
:undoc-members:
:show-inheritance:
相关代码如下：
# models is django.db.models
class ProfileQuerystring(models.Model):
[..]
问题是ProfileQuerystring没有出现在HTML中。
浏览 1提问于2011-12-21得票数 3
回答已采纳
我有一个文件布局，如下所示：
/my_module
__init__.py
submodule1.py
submodule2.py
我使用Sphinx的automodule指令如下：
.. automodule:: my_module.submodule1
它生成的文档显示我的命令名类似于：my_module.submodule1.my_function。但是我的__init__会将submodule1拉入my_module名称空间。因此，我真正想要的是让文档改为my_module.my_function。省略submodule1，因为它不是用户要使用的。
有没有办法做
浏览 0提问于2017-11-14得票数 0
我正在尝试使用Sphinx来记录一个Python项目，但是我在将autodoc扩展与namedtuple生成的类组合在一起时遇到了问题。
在一个文档gammatone.rst中，我有：
:mod:`gammatone` -- gammatone filterbank toolkit
================================================
.. automodule:: gammatone
:members:
.. automodule:: gammatone.coeffs
:members:
在我的gammatone/coeffs.py中
浏览 0提问于2012-12-09得票数 12
回答已采纳
2回答
阅读不使用自动模式的文档
、、、
我为我的项目编写了一些文档(在Python中)，并在本地计算机上用Sphinx测试了所有东西--一切正常工作，所有导入工作都正确，等等。因此，我在Read (Python 3、numpydoc和我的库)上设置了一个自定义环境，将docs目录(和docs/source子目录)添加到我的Github中，然后读取文档的构建就通过了，但是没有创建任何东西( View Docs链接只是显示了一个Nginx404页面)。日志如下：
State: Finished
Outcome: Passed
Version: latest
Type: html
Sphinx Standard Output
浏览 2提问于2014-07-29得票数 11
2回答
我开始研究python模块，并希望将代码记录为“就位”。因此，我在一个带有sphinx-quickstart的子目录中设置了sphinx，从而形成了这个目录结构(只显示了我编辑的文件)：
myproject/
__init__.py
main.py
docs/ (sphinx目录)
建造/建造
源/
conf.py
index.rst
setup.py
我的index.rst包含：
Welcome to My Module's documentation!
=================
浏览 1提问于2019-03-07得票数 11
回答已采纳
我安装是为了记录我正在处理的一些Python模块和类。虽然标记语言看起来很不错，但我还没有自动记录Python代码。
基本上，我有以下Python模块：
SegLib.py
还有一个叫Seg的类。我想在生成的Sphinx文档中显示类和模块的docstring，并向其中添加进一步格式化的文本。
我的index.rst看起来是这样的：
Contents:
.. toctree::
:maxdepth: 2
chapter1.rst
和chapter1.rst
This is a header
================
Some text, *italic text*, **bold t
浏览 3提问于2009-08-25得票数 25
回答已采纳
我试图为一个项目创建一个html文档，其中包含数千个类，使用sphinx和它的autodoc插件。狮身人面像-apidoc创建了很好的rst文件，但是缺少自动类和自动方法的自动创建。
在狮身人面像中有一种方法/命令/实用程序可以自动地在文档中包含所有变量、函数、类和装饰器吗？
一个rst文件的一些示例代码：
tagger Package
=================
:mod:`tagger` Package
------------------------
.. automodule:: project.tagger
:members:
:mod:`client` Mod
浏览 0提问于2013-01-02得票数 16
回答已采纳
我正在尝试使用Sphinx为大型python代码库自动创建api文档。
我尝试过使用build_modules.py和sphinx-apidoc。无论使用哪种方法，我都可以在我的输出目录中成功地为包和顶级模块创建rst文档。
但是，当我使用
make html
它会给出数千个这种类型的错误：
<autosummary>:None: WARNING: toctree contains reference to nonexisting document 'rstDocs/src.Example1.class1.method1'
对于代码库中的每个类和方法。通过一些实验，
浏览 18提问于2012-08-31得票数 47
回答已采纳
我已经使用Sphinx为我的Django应用程序创建了一组文档。我使用readthedocs.org创建该文档的公共版本。这很好用，但有一个奇怪的地方。在readthedocs.org上，我的一些文档生成方式与本地构建不同。例如，我为我的models.py创建了models.rst，如下所示：
Models
======
.. automodule:: my_app.models
Agents
------
Agent
。。自动分类：：代理
：成员：
等等。
对于本地构建，这将创建一个以模型名称作为标题的文档，它们的文档字符串及其成员带有添加了#: comment...的文档字符串。
浏览 3提问于2014-04-22得票数 5
如果我包含以下文档
The xxx API reference
===============================
.. automodule:: sphinx_test
:members:
在我的Sphinx文档中，它在每次'make html‘时运行模块sphinx_test.py。
这是正常的吗？有没有什么标志可以关闭我遗漏的这种行为？
浏览 2提问于2017-08-04得票数 0
回答已采纳
我正在尝试使用Sphinx为一些python类生成文档，我有一个带有一个类的python脚本(带有一些文档) 我的python脚本在这里: D:\sphynx\scripts\src\test.py 我不确定这是否正确，但这是我的test.rst .. automodule:: src
Base Class
----------
.. autoclass:: Test
:members: modules.rst scripts
=======
.. toctree::
:maxdepth: 4
test class Test(object):
""
浏览 35提问于2019-09-12得票数 1
使用Sphinx's automodule指令，我从模块中的所有函数各自的文档字符串中为它们创建了一个API文档。相应的.rst文件仅由以下几行组成： API Reference
=============
.. automodule:: pkg_name.module_name
:members:
:undoc-members:
:show-inheritance: 我还使用nbSphinx将Jupyter笔记本集成到文档中。 如何从Jupyter notebook中的markdown单元格交叉引用自动模块指令创建的函数？
浏览 23提问于2021-03-23得票数 0
我正在努力使我的Sphinx文档构建正确，并使交叉引用(包括来自继承关系的引用)正确工作。
在我的项目中，我有一个在下面的示例中描述的情况，为了方便，我在上复制了它
$ tree .
.
├── a
│ ├── b
│ │ └── __init__.py
│ └── __init__.py
├── conf.py
├── index.rst
└── README.md
在a.b.__init__中，我声明类A和B。B继承自A。在a.__init__中，我导入了A和B，比如：from .b import A, B。我在实际项目中这样做的原因是减少模块上的导入路径，同时将特定类的实
浏览 5提问于2016-10-13得票数 8
回答已采纳
如何在狮身人面像中定义应该使用哪些.rst文件和目录？
我想在我的测试/构建/文档脚本中包含一个自动文档生成器。在我的工作区中执行，并创建了index.rst-文件。由于Sphinx在文档中使用重构的文本文件，我在工作区中导航，并使用sphinx手动创建它们。它的结果是tasks.rst文件(见下文)。
当我使用“make”时，我会收到几个警告：
警告：自动模块的无效签名(u‘任务/add_to_’)
警告：autodoc无法导入/查找模块'tasks.add_to_config'，它报告了错误：“没有模块名为wl_build.tasks"，请检查拼写和sys.pat
浏览 1提问于2012-10-30得票数 4
回答已采纳
我正在尝试实现的一个答案。但是，我没有成功，因为当我跑
> sphinx-autogen -o generated *.rst
我明白错误
导入“MyMod.X”失败:没有名为MyMod.X的模块
未能导入“MyMod.Y”：没有名为MyMod.Y的模块
导入“MyMod.Z”失败:没有名为MyMod.Z的模块
在我的.rst文件中，有一个包含以下一行：
。。自动模块：：MyMod.X
( MyMod.Y和MyMod.Z也是如此)。
我正在子目录docs中运行这个程序。在包含docs的父目录中，还有一个子目录MyMod，它包含__init__.py、X.py、Y.py和
浏览 6提问于2017-04-24得票数 2
1回答
我试图运行Sphinx来记录以下芹菜任务，但是在生成Sphinx文档时将得到一个空文档：
@celery.task(name='taskname')
def taskname(data):
"""
Some documentation
"""
...
...whereas --以下内容将得到详细记录：
def non_decorated_function(data):
"""
Some documentation
"""
浏览 1提问于2015-10-29得票数 4
2回答
我正在使用Sphinx来记录我的Python项目。这向我展示了项目的所有方法，但没有显示任何变量。我也希望能够列出所有的变量。
我的code.rst是-
Code Documentation
=====================
.. automodule:: sql_fn
:members:
目前，我的python项目是这样的：
#test variable
var=0
test_fn():
'''test function'''
print "hello world"
如何更改code.rst或我的
浏览 0提问于2014-07-24得票数 0
1回答
我正在测试两个python脚本plants.py和interpolate.py。这两个脚本打印在同一页上。 如何将这两个脚本记录在两页合流中。 目前，这两个脚本文档都保存在名为"plants“的页面中。 index.rst文件： .. spectRRa documentation master file, created by
sphinx-quickstart on Fri Apr 24 11:55:57 2020.
You can adapt this file completely to your liking, but it should at least
浏览 47提问于2021-11-09得票数 1
回答已采纳
2回答
包的结构和文件设置如下：
$ tree .
.
├── doc
│ ├── Makefile
│ ├── README.md
│ ├── _build
│ ├── _static
│ ├── conf.py
│ ├── foo.rst
│ ├── index.rst
│ └── make.bat
└── foo
├── __init__.py
└── spam.py
$ cat foo/__init__.py
r'''
The Foo module
==============
.. autosummary::
浏览 1提问于2016-01-17得票数 6
2回答
我有一些模块级变量，它们的值很长而且没有兴趣，我想将它们排除在自动生成的文档之外。有办法这样做吗？
例如，在我的Python源代码中，我有如下所示
#:This is a variable with a log value.
long_variable = "Some really long value that is not really of interest and just kind of gets in the way of reading and understanding what's going on."
在我的狮身人面像源里
.. automodule
浏览 3提问于2014-09-24得票数 5
回答已采纳
我正在尝试使用sphinx为我的python包生成文档。我在我的所有函数中都包含了文档记录良好的文档字符串。我调用了sphinx-quickstart来创建模板，填充了模板，并调用了make html来生成文档。我的问题是，我的python模块中也有注释，这些注释也显示在呈现的文档中。注释不在函数中，而是作为.py文件顶部的头文件。我被要求有这些注释块，不能删除它们，但我不希望它们出现在我的文档中。
我目前正在使用automodule将所有函数从模块中提取出来。我知道我可以使用autofunction一个接一个地获取各个函数，这样就避免了文件头，但我有很多函数，肯定有更好的方法。
如何调整我的
浏览 22提问于2018-02-08得票数 0
回答已采纳
当使用斯芬克斯的自动模块()时，
我只是在一个.rst文件中写道：
.. automodule:: my_module
:members:
它很好地记录了my_module，但是找不到像my_module.inner_module0和my_module.inner_module1这样的内部模块。除了__all__变量之外，还需要在__init__.py文件中指定什么内容吗？
另外，我知道sphinx-apidoc。但是该命令文档太多(暴露了每个函数/文件夹，包括未记录的函数/文件夹)。
浏览 66提问于2012-07-17得票数 34
1回答
一个星期以来，我一直在寻找这个问题的答案。希望你能帮助我：
我正在用Sphinx记录，这是我项目的结构：
-folder
__init__
-main_tool_folder
__init__
main.py
-docs_folder
-modulefolder
__init__
fileIwanttodocument
我的main.py内部
sys.path.append('../')
from modulefolder.fileIwanttodocument i
浏览 5提问于2018-07-17得票数 4
我无法理解Python域中交叉引用角色的使用，特别是:py:const:，请有人提供一个更清楚的解释和它的使用示例？
例如，我有一个文件module.rst，它包含以下指令：
.. default-role:: any
.. automodule:: CommonSymbols
:members:
:py:const: Success
:py:mod: CommonSymbols
从我所期望的文档中可以看到:py:const: SUCCESS，其中SUCCESS是在模块CommonSymbols中定义的变量，用于生成指向CommonSymbols中成功定义的链接。类似地，当遇到
浏览 0提问于2017-07-02得票数 1
1回答
我正在尝试使用Sphinx为我的Python/Flask应用程序构建文档，但是我无法导入该文件。
我在views.py上导入views.rst文件，但是出现了一条错误消息：No module named 'catalog'。
在catalog文件夹中有一个__init__.py文件，但是无论如何错误不会改变。
有人知道这是怎么回事吗？
提前谢谢你。
views.rst
.. automodule:: catalog.views
:members:
conf.py
sys_path.insert(0, os_path.abspath('../catalog'
浏览 0提问于2019-04-17得票数 3
回答已采纳
我用狮身人面像做文件。当我使用“”时，我从index.rst文件中得到以下警告。
如何删除这些警告？此外，由于这些警告，内容表没有在汇合中工作，但是文档正在代码中创建。
任何建议/帮助都是非常值得赞赏的。
[4px@learning-2 docs]$ make confluence
Running Sphinx v4.2.0
loading pickled environment... done
building [mo]: targets for 0 po files that are out of date
building [confluence]: targets for 0 so
浏览 4提问于2021-10-26得票数 2
回答已采纳
我正在使用Sphinx来记录我的Python包。当我在我的模块上使用自动模块指令时：
.. automodule:: mymodule
:members:
它打印文档字符串中的所有内容，包括GPL通知。有没有办法告诉Sphinx忽略docstring/GPL，或者我应该把它包含在文档中？
浏览 0提问于2013-06-20得票数 8
回答已采纳
我第一次尝试使用Sphinx从代码中的docstring获取文档。我目前正在使用py魅力运行一个斯芬克斯任务，但我也没有运气的命令行。问题是，在不返回任何错误的情况下，该过程将被执行：
Running Sphinx v1.2.2
loading pickled environment... done
building [html]: targets for 1 source files that are out of date
updating environment: 0 added, 1 changed, 0 removed
reading sources... [100%] index
浏览 2提问于2016-06-14得票数 1
1回答
如何修正“意想不到的章节标题”？
、、、、
这个docstring：
"""
Returns
-------
out: int
Output.
Bad title
---------
Text.
"""
生产：
C:\module.py:docstring of my_pkg.module.func:5: CRITICAL: Unexpected section title.
Bad title
---------
我能让它尊重Bad title吗，或者至少压制一下这个警告？我不是用numpydoc或者拿破仑，只是
extensions = ['sphinx.ext.
浏览 11提问于2022-10-21得票数 -1
回答已采纳
扫码
添加站长 进交流群
领取专属 10元无门槛券
手把手带您无忧上云
相关资讯
热门标签
云服务器
ICP备案
对象存储
即时通信 IM
实时音视频活动推荐
腾讯云开发者
