<分区>
我有一个包含多个大型应用程序的项目,其中设置和应用程序文件是分开的。
目录结构是这样的:
项目名称
- _初始化_.py
- 应用
- _初始化_.py
- 应用1
- 应用2
- 第三方
- _初始化_.py
- lib1
- lib2
- 设置
- _初始化_.py
- installed_apps.py
- 路径.py
- 模板.py
- 语言环境.py
- ...
- urls.py
每个应用都是这样
- _初始化_.py
- 管理员
- _初始化_.py
- 文件1.py
- 文件2.py
- 模特
- _初始化_.py
- 模型1.py
- 模型2.py
- 测试
- _初始化_.py
- 测试1.py
- 测试2.py
- 观点
- _初始化_.py
- view1.py
- view2.py
- urls.py
如何使用 Sphinx 自动生成文档?
我想要这样的东西 对于每个设置模块或 INSTALLED_APPS(不是以 django.* 或 3rdparty.* 开头)给我一个基于文档字符串的自动文档输出。
在 git commit 之前自动生成文档并运行测试
顺便说一句。 我尝试用
手动处理 .rst 文件.. automodule:: module_name
:members:
但是对于这么大的项目来说很糟糕, 它不适用于设置
有没有autogen方法之类的?
我不依赖于 Sphinx,是否有更好的解决方案来解决我的问题?