1回答
冒着被告知我没有对此进行足够研究的风险(我已经在这方面研究了大半个星期)，我无法在sphinx中使用自动类功能。我得到了一系列导入错误。doc index.rst text2.rst任何关于问题所在
浏览 27提问于2017-08-30得票数 1
回答已采纳
我使用sphinx和intersphinx来记录我的项目。
我有一个继承自mongoengine.Document的类。当我使用sphinx-apidoc和sphinx-build (通过sphinx -quickstart自动生成的Makefile )构建sphinx文档时，对mongoengine.Document类的引用显示为有没有办法告诉sphinx在导入基类(在我的代码中，我从mongoe
浏览 10提问于2017-12-20得票数 4
回答已采纳
有什么方法可以排除模块的导入部分，然后用sphinx记录它吗？我有一个模块，它导入了另一个包(其他不同的项目)，然后斯芬克斯给出了这个错误：
“File "/usr/local/lib/python2.7/dist-packages/Sphinx-1.1.3-py2.7/mod_example1.py"，第33行，在other_pck import中，KlassStuff ImportError:
浏览 5提问于2013-02-26得票数 4
回答已采纳
为了熟悉狮身人面像，我已经习惯了使用DO2编写文档，在那里它会自动从您的源生成存根和类。对于狮身人面像在git中运行sphinx-apidoc -o dir dir一样，对于每个新的模块/文件，我需要运行git add file，这是标准还是缺少设置标志。我知道我可以自动化bash/bat文件来按顺序运行每个命令。我很好奇我是否做错了什么。import ossys.path.inser
浏览 3提问于2016-06-25得票数 1
4回答
我正在尝试使用Sphinx为我的代码库自动生成基本文档。然而，我在指示Sphinx递归扫描我的文件时遇到了困难。假定我将为代码库中的每个模块/类/函数手动创建文档文件。我修改了我的conf.py以将我的src文件夹添加到sys.path中，然后修改了我的index.rst以使用自动模块。/_buildupdating environment: 1 added, 0 changed, 0 removed
这似乎没有在我的包中<em
浏览 5提问于2011-01-06得票数 54
回答已采纳
1回答
下面是详细信息:我有一个Python项目，其中包含一个包含类agent.py的文件Agent。它运行时没有错误，但当我打开生成的HTML文件时，它只显示“代理模块”，所有内容都是空的。为什么它不显示类Agent及其成员呢？Update：最初的问题可能是由于我没有在conf.py中包括sphinx.ext.autodoc这一事实造成的。不过，现在我收到了警告，比如：
警告:自动模块的无效签名('My Project.agent')警告:不知道导入哪个
浏览 4提问于2020-01-24得票数 6
回答已采纳
2回答
Sphinx文档引擎能否成功生成导入不好的项目的文档？特别是，我的项目具有异国情调的依赖性。我不希望文档生成依赖于这种依赖关系。 Sphinx需要导入我的模块并使用内省，还是需要进行解析？
浏览 0提问于2013-06-28得票数 3
我使用Sphinx和自动摘要生成Python软件的文档。它运行良好，但是生成的.rst文件也列出了导入的函数和类，这不是我想要的行为。imported ClassImported
是否有一种方法只列出模块中定义的函数和类(而不是导入的函数和类)？这是为了防止导入类或函数的文档化。如果
浏览 3提问于2014-08-20得票数 4
回答已采纳
我安装是为了记录我正在处理的一些Python模块和类。虽然标记语言看起来很不错，但我还没有自动记录Python代码。SegLib.py但是Seg只是用粗体打印，而不是链接到类的自动生成文档。直接将类中的函数文档
浏览 3提问于2009-08-25得票数 25
回答已采纳
当我运行sphinx-apidoc，然后运行make html时，它会在目录(TOC)中的每个模块/包名称的末尾生成“子包”和“子模块”部分以及“模块”和“包”的文档页面。在不编辑Sphinx源代码的情况下，如何防止编写这些额外的标题？下面是我想要制作的一个文档页面示例(注意TOC)：
我可以手动编辑每个单独的.rst文件来删除这些标题，或者只是从脚本中删除这些代码行，但是接下来
浏览 2提问于2014-01-08得票数 18
回答已采纳
我正在努力使我的Sphinx文档构建正确，并使交叉引用(包括来自继承关系的引用)正确工作。__init__中，我声明类A和B。B继承自A。在a.__init__中，我导入了A和B，比如：from .b import A, B。我在实际项目中这样做的原因是减少模块上的导入路径，同时将特定类的实现保存在单独的文件中。
然后，在我的rst文件中，我使用a自动文档模块.. automodule:: a。因为a.b只是一个辅助模块，所以我不想<
浏览 5提问于2016-10-13得票数 8
回答已采纳
我想从 Sphinx扩展切换到，因为我发现它以更紧凑和可读性更强的方式格式化了文档字符串。但是，它没有在文档的顶部列出类的方法，这是numpydoc的一个非常有价值的特性。
浏览 18提问于2017-01-20得票数 10
我在readthedocs上遇到了问题--构建完成了，但是我的文档对于每个类都是空的。现在，我从init.py导入一个常量init.pyfrom medembed import DIR_PROCESSED
ImportError: No module
浏览 3提问于2018-04-27得票数 2
回答已采纳
我正在尝试使用sphinx-auto汇总来创建python代码的自动摘要，如下所示：├───modA| ├───modA.py 'sphinx.ext.autodoc', 'sphinx.ext.coverage',
'sphinx.ext.napol
浏览 6提问于2020-06-06得票数 6
1回答
嗨，我正在为一个使用sphinx的Django项目写一些文档。我的项目(Django 1.4)如下所示： /documentation /settings.py models.py /app2 manage.py
我在conf.py中设置了sphinxfunpro
浏览 2提问于2013-03-16得票数 2
1回答
自动生成的文档复制了Test类的Methods，如下所示。为什么会发生这种重复，如何才能阻止它？ 我在conf.py模块中尝试了几个变体，但都没有用。在文档图像之后，是此模块的编辑版本。extensions = ['sphinx.ext.autodoc', 'numpydoc','sphinx.
浏览 17提问于2020-08-07得票数 1
回答已采纳
我试图使用Sphinx1.4和sphinx-apidoc以及sphinx.ext.autodoc扩展为我的python类生成文档。我有很多模块，我希望每个模块只显示类名，而不是类中的完整方法列表(所有这些方法都在我的代码中有文档字符串)。==============
:members: :show-inheritance:
我不</em
浏览 7提问于2016-04-02得票数 8
回答已采纳
因为它是用Python编写的，所以我决定使用Sphinx，因为代码的用户已经习惯了用Sphinx创建的Python文档的设计和功能。我使用命令sphinx-apidoc自动创建.rst文件。我将模块路径导入到sys.path中，以便Sphinx可以找到代码。
到目前一切尚好。但是，当我尝试使用命令make html创建HTML时，弹出了许多回溯，并且代码库中的一些示例似乎得到了执行。
浏览 2提问于2012-09-12得票数 9
回答已采纳
我们不想维护文档和源代码，因为源代码目前正在快速发展，但是Sphinx似乎需要大量令人沮丧的设置和配置。(我们只需要一些基本的API文档。)难道没有一个命令可以在python项目中运行，它只会迭代生成HTML文档的所有包、模块、类和函数吗？sphinx将内容拆分到一个目录中，在修改conf.py使我们的包在sys.path中后，我们可以运行"make“，但它只列出包和模块，而不记录任何类或函数。
谢谢!
浏览 8提问于2013-02-26得票数 16
扫码
添加站长 进交流群
领取专属 10元无门槛券
手把手带您无忧上云
相关资讯
热门标签
云服务器
ICP备案
腾讯会议
对象存储
云直播活动推荐
腾讯云开发者
