在Windows 10中使HTML不适用于Sphinx文档

ruoxqz4g  于 2022-11-18  发布在  Windows
关注(0)|答案(2)|浏览(141)

我正在尝试按照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。

k3bvogb1

k3bvogb11#

展开上面的注解。
由sphinx生成的默认站点假定您在多个操作系统上使用make html来生成HTML页面。
这是通过一个典型的假设来实现的

  • 您使用的是安装了(GNU)make的macOS或Linux,因此make html会执行Makefile中定义的任务。
  • 您使用的是Windows,并处于命令提示符(cmd.exe)下,因此make html实际上调用make.bat

但是,您正在启动PowerShell控制台(“PS D:“表示),因此无法使make html正常工作。PowerShell不知道如何处理make,也不会自动调用make.bat。您需要改为调用.\make.bat html

kgsdhlau

kgsdhlau2#

您可以尝试使用sphinx-build。据我所知,它可以完成工作,并且不依赖于您使用的操作系统。
sphinx-build <sourcedir> <outputdir>

相关问题