草庐IT

python - 狮身人面像自动摘要 "toctree contains reference to nonexisting document"警告

我正在尝试使用Sphinx为大型python代码库自动创建api文档。我尝试过使用build_modules.py和sphinx-apidoc。使用任何一个,我都可以在我的输出目录中为包和顶级模块成功创建第一个文档。但是,当我使用构建时makehtml它给出了数千个这种类型的错误::None:WARNING:toctreecontainsreferencetononexistingdocument'rstDocs/src.Example1.class1.method1'对于代码库中的每个类和方法。通过一些实验,我想我发现autosummary/autoclass指令正在创建期望每个类和

python - 狮身人面像浮点格式

我正在使用Sphinx从代码生成文档。有谁知道是否有办法控制从默认参数生成的float的格式。例如,如果我有以下功能:deff(x=0.97):returnx+1生成的文档最终看起来像:foo(x=0.96999999999997)显然这是一个浮点精度问题,但是有没有办法让文档看起来不那么难看? 最佳答案 您可以使用..autofunction::指令覆盖函数签名。因此,为了解决您的示例,在模块bar中定义为foo(x=0.97)的函数:..automodule::bar..autofunction::foo(x=0.97)生成的文