最近需要将API中的doc生成html给前端工程师参考调用。
Sphinx 是用 Python 编写的,并且最初是为 Python 语言文档而创建,但它并不一定是以语言为中心,在某些情况下,甚至不是以程序员为中心。Sphinx 有许多用处,比如可以用它来编写整本书! 要求
语法
实战
sphinx-apidoc具体用法参考:
http://zh-sphinx-doc.readthedocs.org/en/latest/invocation.html#sphinx-apidoc
安装readthedocs主题
# pip install sphinx_rtd_theme
编辑conf.py
import sphinx_rtd_theme
html_theme = "sphinx_rtd_theme"
html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
在下一步生成html时,会尝试将你的项目导入并运行,因此需要将你的项目添加至python的环境变量中 编辑conf.py
sys.path.append(os.path.join([os.getcwd(), "../ops/api"]))
根据生成的rst文件生成html
# cd docs
# mkdir html
# sphinx-build . html
sphinx-build具体用户参考:
http://zh-sphinx-doc.readthedocs.org/en/latest/invocation.html
自定义生成文档的类或方法
生成domains类中get, post, put, delete方法
指定只生成这几个方法的文档