我是第一次使用 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 。
1 回答

慕的地10843
TA貢獻1785條經驗 獲得超8個贊
sphinx-autobuild 是一個應用程序,它啟動 Web 服務器并探測docs
目錄中的更改,以自動刷新您在瀏覽器中開發的文檔的打開頁面。
它不是 Sphinx擴展,其文檔也沒有聲稱它是。
你得到的錯誤:
當我調用“make.bat livehtml”時,出現錯誤:構建器名稱 livehtml 未注冊或通過入口點可用
指示當您嘗試運行 時,對 make 文件的更改尚未保存make livehtml
。對 make 文件的編輯啟動sphinx-autobuild
而不是通常的sphinx-build
.?因為sphinx-build
正在正常運行,livehtml
作為無法找到的構建器名稱傳遞。
添加回答
舉報
0/150
提交
取消