python sphinx_python项目用sphinx文档生成

python项目用sphinx文档生成

使用内置命令

sphinx-apidoc -o doc waterfal

得到 rst 文件

localhost:doc timger$ ls

modules.rst waterfall.glblog.rst waterfall.master.rst waterfall.rst

waterfall.excepts.rst waterfall.lib.rst waterfall.p2plog.rst waterfall.slowspeed.rst

自己编辑 conf.py

或者加上 -F

localhost:waterfall timger$ sphinx-apidoc -F -o doc waterfall

Creating file doc/waterfall.rst.

Creating file doc/waterfall.excepts.rst.

Creating file doc/waterfall.glblog.rst.

Creating file doc/waterfall.lib.rst.

Creating file doc/waterfall.master.rst.

Creating file doc/waterfall.p2plog.rst.

Creating file doc/waterfall.slowspeed.rst.

Creating file doc/conf.py.

Creating file doc/index.rst.

Creating file doc/Makefile.

Creating file doc/make.bat.

然后 直接 make html

注意需要在 conf.py 里面加入项目路径让他能够 import

如果路径很深 需要 -d 10 后面参数根据情况

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值