gpt4 book ai didi

python - 在 Sphinx 文档生成器中,我可以将整个包(递归地)添加到索引中吗?

转载 作者:太空狗 更新时间:2023-10-29 17:28:57 26 4
gpt4 key购买 nike

我想为我的包生成文档。项目中的每个文件都包含大量文档。有没有办法快速将我的整个项目添加到文档索引中?

我想用尽可能少的工作为整个项目自动生成一些文档。我首先将以下内容添加到 index.rst:

.. automodule:: mymodulename
:members:

似乎所做的只是 __init__.py 文件中的文档元素(只是一个文档字符串)——有什么方法可以让它记录其他所有内容吗?我希望添加包中定义的所有内容,并将包中的每个类、常量、函数(等)添加到适当的索引中。

这可以做到吗?

最佳答案

您可以使用sphinx-apidoc
来自official documentation : sphinx-apidoc 是一个自动生成 Sphinx 源代码的工具,它使用 autodoc 扩展,以其他自动 API 文档工具的风格记录整个包。

一个用法示例可以是(从您的项目根目录):

$ sphinx-apidoc . --full -o doc -H 'MyProject' -A 'MyName' -V '1.0'

一个 doc 目录将被创建,里面的所有东西都准备好了。
您还可以调整文档的设置,编辑自动生成的 conf.py 文件。

其他有用的信息可以在 similar question posted here 中找到.

关于python - 在 Sphinx 文档生成器中,我可以将整个包(递归地)添加到索引中吗?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/8792643/

26 4 0
Copyright 2021 - 2024 cfsdn All Rights Reserved 蜀ICP备2022000587号
广告合作:1813099741@qq.com 6ren.com