sphinx-apidoc -F -o <output_dir> <project_dir>无法创建make文件:</project_dir> </output_dir>

时间:2013-12-28 01:13:52

标签: python documentation python-sphinx

我试图使用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(&#39; / Users // path / to / mypackage&#39;))是正确的

但是,当我尝试通过以下方式构建文档时(在docs目录中)

build html

我受到了欢迎:

-bash: make: command not found

我已经使用了sphinx-apidoc并与其他库一起制作html,并且从未遇到过这种情况,所以我有点不知所措。有什么想法吗?

1 个答案:

答案 0 :(得分:1)

正如@Blender在评论中所述。未安装make。我最近不得不重新安装Xcode而忘记重新安装命令行工具

为了澄清,我正在运行OSX 10.8.5。

make首先通过Xcode使用app store,然后打开Xcode并下载/安装Command Line Tools,请导航至:Xcode->Preferences->Downloads