我们使用sphinx来记录烧瓶api。它做得很好,但是我们在导航它生成的文档时遇到了一个问题。我们分别记录每个蓝图。我们的蓝图相当大。每一行大约有1000行,我们的docstring非常详细。结果是一个列出端点的sphinx页面,但是端点之间有太多的中间文档,因此很难理解该页面。通常在这里创建一个目录在顶部。我相信sphinx autosummary也可能在这里被调用,尽管我不确定,因为我从未使用过它。在
不幸的是,autosummary不起作用,因为它似乎并不是为处理与autoflask相同类型的输入而构建的(sphinxcontrib.autohttp.flask). 告诉任何人用哪种方式创建一个与sphinx页面中的所有内容兼容的sphinx页面?在
结果是在构建文件夹中生成了一个html文件,名为
http-routingtable.html
,它完成了我上面的要求。考虑到斯芬克斯(文档)的目的,你会认为这将是。。。记录在案。。。很明显。希望其他经历过这个问题的人将来也会遇到这个问题。在由于sphinxcontrib.httpdomain的
v1.5.0
,因此可以使用sphinxcontrib.autohttp.flaskqref相关问题 更多 >
编程相关推荐