我试图使用Sphinx来记录我一直在研究的Python库。我一直在使用this post作为粗略的指南。但是,我在让Sphinx正常工作方面遇到了问题。
设置完所有内容后,已经安装了Sphinx,并且我已经从我项目的根目录输入了我的代码文档:
sphinx-apidoc -F -o docs/ mypackage/
输出:
Creating file docs/mypackage.rst.
Creating file docs/mypackage.helpers.rst.
Creating file docs/conf.py.
Creating file docs/index.rst.
Creating file docs/Makefile.
Creating file docs/make.bat.
接下来,我分别编辑docs / conf.py以确保我的sys.path.insert(0,os.path.abspath(' / Users // path / to / mypackage'))是正确的
但是,当我尝试通过以下方式构建文档时(在docs目录中)
build html
我受到了欢迎:
-bash: make: command not found
我已经使用了sphinx-apidoc并与其他库一起制作html,并且从未遇到过这种情况,所以我有点不知所措。有什么想法吗?
答案 0 :(得分:1)
正如@Blender在评论中所述。未安装make
。我最近不得不重新安装Xcode而忘记重新安装命令行工具。
为了澄清,我正在运行OSX 10.8.5。
要make
首先通过Xcode
使用app store
,然后打开Xcode并下载/安装Command Line Tools
,请导航至:Xcode->Preferences->Downloads