这篇文章主要介绍了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
再次尝试，终于成功了…
以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。
免责声明：本站文章均来自网站采集或用户投稿，网站不提供任何软件下载或自行开发的软件！ 如有用户或公司发现本站内容信息存在侵权行为，请邮件告知！ 858582#qq.com
P70系列延期，华为新旗舰将在下月发布
3月20日消息，近期博主@数码闲聊站 透露，原定三月份发布的华为新旗舰P70系列延期发布，预计4月份上市。
而博主@定焦数码 爆料，华为的P70系列在定位上已经超过了Mate60，成为了重要的旗舰系列之一。它肩负着重返影像领域顶尖的使命。那么这次P70会带来哪些令人惊艳的创新呢？
根据目前爆料的消息来看，华为P70系列将推出三个版本，其中P70和P70 Pro采用了三角形的摄像头模组设计，而P70 Art则采用了与上一代P60 Art相似的不规则形状设计。这样的外观是否好看见仁见智，但辨识度绝对拉满。