神剑山庄资源网 Design By www.hcban.com
这篇文章主要介绍了Python Sphinx使用实例及问题解决,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
描述
使用 pip 安装sphinx后,按照教程建立了一个新的py文件,如下
# run.py def run(name): """ this is how we run :param name name of people who runs """ print(name, 'is running')
随后新建一个目录,使用 sphinx-quickstart 新建了sphinx环境,此时目录结构如下:
- doc - Makefile - build/ - make.bat - source/ - run.py
此时进入 source目录,在conf.py 中添加文件路径,如下:
import os import sys sys.path.insert(0, os.path.abspath('../..'))
然后在 doc 下执行下面命令:
make html or sphinx-build -b html ./doc/source ./doc/build
发现两个命令都可以正常生成文档的模版,但并没有生成注释;即有生成的html,但没有代码的注释/API文档
尝试解决
开始以往是版本不一致,就重新建了virtualenv,还是不行;
使用了一个docker镜像,重试,结果是同样的错误
尝试看非官方的教程,发现还需要更改 source 下的 index.rst;
例如我们的代码文件是 run.py ,需要把他加到 index.rst中,如下(run就是模块名称):
API === .. automodule:: run :members:
再次执行,发现还有错,只不过提示不一样了:提示
Unknown directive type “automodule” or “autoclass”
谷歌之,发现还要改一个配置的地方;位于 conf.py 里,增加一个扩展……如下:
extensions = [ 'sphinx.ext.autodoc' ]
此处参考了 https://stackoverflow.com/questions/13516404/sphinx-error-unknown-directive-type-automodule-or-autoclass
再次尝试,终于成功了…
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
神剑山庄资源网 Design By www.hcban.com
神剑山庄资源网
免责声明:本站文章均来自网站采集或用户投稿,网站不提供任何软件下载或自行开发的软件!
如有用户或公司发现本站内容信息存在侵权行为,请邮件告知! 858582#qq.com
神剑山庄资源网 Design By www.hcban.com
暂无Python Sphinx使用实例及问题解决的评论...
更新日志
2024年09月30日
2024年09月30日
- 孙悦.1996-伙伴【正大国际】【WAV+CUE】
- 纪钧瀚《钢琴阅读时光 雨中书店聆听轻音乐》[FLAC/分轨][399.62MB]
- 证声音乐图书馆《走向自然 疗心爵士乐》[320K/MP3][87.4MB]
- 证声音乐图书馆《走向自然 疗心爵士乐》[FLAC/分轨][184.94MB]
- 陈慧娴.2018-Priscilla-Ism演唱会3CD(2024环球红馆40复刻系列)【环球】【WAV+CUE】
- 郑秀文.1999-我应该得到(国)【华纳】【WAV+CUE】
- 陈家慧.2011-钢琴酒吧2CD【龙吟唱片】【WAV+CUE】
- 证声音乐图书馆《雨季 蓝调吉他 Rainy Blues》[320K/MP3][45.01MB]
- 证声音乐图书馆《雨季 蓝调吉他 Rainy Blues》[FLAC/分轨][109.13MB]
- 赞多《序章》[320K/MP3][45.54MB]
- 许巍.2004-每一刻都是崭新的【步升大风】【WAV+CUE】
- 群星.2024-四方馆影视原声带【韶愔音乐】【FLAC分轨】
- 陈雷.1997-安锁咧【金圆唱片】【WAV+CUE】
- 关淑怡.2013-MY.FAVORITE.SK.3CD【环球】【WAV+CUE】
- Sweety.2006-花言乔语【丰华】【WAV+CUE】