当从makefile构建时,Sphinx无法定位配置文件



我正在遵循这个关于将sphinx与github页面集成的教程,似乎他们使用的Makefile不起作用。当我从项目的根目录运行make github时,我得到以下错误:

config directory doesn't contain a conf.py file (C:pathtoproject_root)

然而,我可以运行make html成功——只有make github不工作。

下面是我使用的Makefile:
# 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文档)

相关内容

  • 没有找到相关文章

最新更新