我正在遵循这个关于将sphinx与github页面集成的教程,似乎他们使用的Makefile不起作用。当我从项目的根目录运行make github
时,我得到以下错误:
config directory doesn't contain a conf.py file (C:pathtoproject_root)
然而,我可以运行make html
成功——只有make github
不工作。
# Minimal makefile for Sphinx documentation
#
# You can set these variables from the command line.
SPHINXOPTS =
SPHINXBUILD = sphinx-build
SOURCEDIR = source
BUILDDIR = build
# Put it first so that "make" without argument is like "make help".
help:
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
.PHONY: help Makefile
github:
@make html
@cp -a build/html/. ./docs
# Catch-all target: route all unknown targets to Sphinx using the new
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
%: Makefile
@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
下面是我的文件夹结构:
project_root
├─ build
├─ docs
├─ source
│ └─ conf.py
└─ Makefile
编辑:make github
实际上在git bash窗口中工作。我在Windows上,所以我怀疑这是一个平台相关的问题。是否有一种方法可以修改Makefile,让它在windows powershell中成功运行make github
?
显然在Windows中根本不使用Makefile,只有make.bat。
我也在这上面浪费了很多时间。请看李彦宏的回答:https://stackoverflow.com/a/65471768/2040843
(使HTML无法在windows 10中用于Sphinx文档)