我正在尝试按照tutorial的说明来设置sphinx和Readthedocs。我在实习的时候用过Sphinx,在ubuntu上的设置非常无缝。我刚刚在我的anaconda power shell上启动了sphinx-quickstart
。当我尝试运行make html
时,出现了以下错误:
(base) PS D:\code\RaspberryServer\docs> make html
make : The term 'make' is not recognized as the name of a cmdlet, function, script file, or operable program. Check
the spelling of the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:1
+ make html
+ ~~~~
+ CategoryInfo : ObjectNotFound: (make:String) [], CommandNotFoundException
+ FullyQualifiedErrorId : CommandNotFoundException
Suggestion [3,General]: The command make was not found, but does exist in the current location. Windows PowerShell does not load commands from the current location by default. If you trust this command, instead type: ".\make". See "get-help about_Command_Precedence" for more details.
首先,我认为这是因为我从来没有安装过MinGW。但即使这样做了,我似乎没有解决这个问题,我不知道如何开始调查它。我的Python安装完全基于Anaconda。
2条答案
按热度按时间k3bvogb11#
展开上面的注解。
由sphinx生成的默认站点假定您在多个操作系统上使用
make html
来生成HTML页面。这是通过一个典型的假设来实现的
make html
会执行Makefile
中定义的任务。cmd.exe
)下,因此make html
实际上调用make.bat
。但是,您正在启动PowerShell控制台(“PS D:“表示),因此无法使
make html
正常工作。PowerShell不知道如何处理make
,也不会自动调用make.bat
。您需要改为调用.\make.bat html
。kgsdhlau2#
您可以尝试使用sphinx-build。据我所知,它可以完成工作,并且不依赖于您使用的操作系统。
sphinx-build <sourcedir> <outputdir>