sphinx autobuild - 用法、makefile、扩展

Question

我是第一次使用 sphinx，所以我确信这只是一个理解基础知识的问题，对此感到抱歉。使用 Windows，部分内容make.bat如下所示：if "%SPHINXBUILD%" == "" (    set SPHINXBUILD=sphinx-build)set SOURCEDIR=.set BUILDDIR=_buildif "%1" == "" goto helpif "%1" == "deploy" goto deploy%SPHINXBUILD% >NUL 2>NULif errorlevel 9009 (    echo.    echo.The 'sphinx-build' command was not found. Make sure you have Sphinx    echo.installed, then set the SPHINXBUILD environment variable to point    echo.to the full path of the 'sphinx-build' executable. Alternatively you    echo.may add the Sphinx directory to PATH.    echo.    echo.If you don't have Sphinx installed, grab it from    echo.http://sphinx-doc.org/    exit /b 1)%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%goto endif "%1" == "livehtml" (    sphinx-autobuild %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %2) else (    %SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %2)goto end:deployrmdir /S /Q ..\..\public || truecp -r _build\html ..\..\publicgoto end:help%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%我在哪里添加了以下部分：if "%1" == "livehtml" (    sphinx-autobuild %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %2) else (    %SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %2)goto end当我打电话时make.bat livehtml，我收到错误：构建器名称 livehtml 未注册或可通过入口点使用我用谷歌搜索，这就是我找到的全部： https: //github.com/readthedocs/readthedocs-sphinx-ext/issues/27 所以看起来我可能必须将自动构建扩展添加到文件中conf.py- 但如何呢？或者也许是别的什么？我确实用 pip 安装了 sphinx-autobuild 。

Answer 1

sphinx-autobuild 是一个应用程序，它启动 Web 服务器并探测docs目录中的更改，以自动刷新您在浏览器中开发的文档的打开页面。

它不是 Sphinx扩展，其文档也没有声称它是。

你得到的错误：

当我调用“make.bat livehtml”时，出现错误：构建器名称 livehtml 未注册或通过入口点可用

指示当您尝试运行 时，对 make 文件的更改尚未保存make livehtml。对 make 文件的编辑启动sphinx-autobuild而不是通常的sphinx-build. 因为sphinx-build正在正常运行，livehtml作为无法找到的构建器名称传递。