@echo offsetlocalpushd %~dp0set this=%~n0call ..\PCbuild\find_python.bat %PYTHON%if not defined PYTHON set PYTHON=pyif not defined SPHINXBUILD (%PYTHON% -c "import sphinx" > nul 2> nulif errorlevel 1 (echo Installing sphinx with %PYTHON%%PYTHON% -m pip install sphinxif errorlevel 1 exit /B)set SPHINXBUILD=%PYTHON% -c "import sphinx.cmd.build, sys; sys.exit(sphinx.cmd.build.main())")%PYTHON% -c "import python_docs_theme" > nul 2> nulif errorlevel 1 (echo Installing python-docs-theme with %PYTHON%%PYTHON% -m pip install python-docs-themeif errorlevel 1 exit /B)if not defined BLURB (%PYTHON% -c "import blurb" > nul 2> nulif errorlevel 1 (echo Installing blurb with %PYTHON%%PYTHON% -m pip install blurbif errorlevel 1 exit /B)set BLURB=%PYTHON% -m blurb)if "%1" NEQ "htmlhelp" goto :skiphhcsearchif exist "%HTMLHELP%" goto :skiphhcsearchrem Search for HHC in likely placesset HTMLHELP=where hhc /q && set "HTMLHELP=hhc" && goto :skiphhcsearchwhere /R ..\externals hhc > "%TEMP%\hhc.loc" 2> nul && set /P HTMLHELP= < "%TEMP%\hhc.loc" & del "%TEMP%\hhc.loc"if not exist "%HTMLHELP%" where /R "%ProgramFiles(x86)%" hhc > "%TEMP%\hhc.loc" 2> nul && set /P HTMLHELP= < "%TEMP%\hhc.loc" & del "%TEMP%\hhc.loc"if not exist "%HTMLHELP%" where /R "%ProgramFiles%" hhc > "%TEMP%\hhc.loc" 2> nul && set /P HTMLHELP= < "%TEMP%\hhc.loc" & del "%TEMP%\hhc.loc"if not exist "%HTMLHELP%" (echo.echo.The HTML Help Workshop was not found. Set the HTMLHELP variableecho.to the path to hhc.exe or download and install it fromecho.http://msdn.microsoft.com/en-us/library/ms669985exit /B 1):skiphhcsearchif "%DISTVERSION%" EQU "" for /f "usebackq" %%v in (`%PYTHON% tools/extensions/patchlevel.py`) do set DISTVERSION=%%vif "%BUILDDIR%" EQU "" set BUILDDIR=buildrem Targets that don't require sphinx-buildif "%1" EQU "" goto helpif "%1" EQU "help" goto helpif "%1" EQU "check" goto checkif "%1" EQU "serve" goto serveif "%1" == "clean" (rmdir /q /s "%BUILDDIR%"goto end)%SPHINXBUILD% >nul 2> nulif errorlevel 9009 (echo.echo.The 'sphinx-build' command was not found. Make sure you have Sphinxecho.installed, then set the SPHINXBUILD environment variable to pointecho.to the full path of the 'sphinx-build' executable. Alternatively youecho.may add the Sphinx directory to PATH.echo.echo.If you don't have Sphinx installed, grab it fromecho.http://sphinx-doc.org/popdexit /B 1)rem Targets that do require sphinx-build and have their own labelif "%1" EQU "htmlview" goto htmlviewrem Everything elsegoto build:helpecho.usage: %this% BUILDER [filename ...]echo.echo.Call %this% with the desired Sphinx builder as the first argument, e.g.echo.``%this% html`` or ``%this% doctest``. Interesting targets that areecho.always available include:echo.echo. Provided by Sphinx:echo. html, htmlhelp, latex, textecho. suspicious, linkcheck, changes, doctestecho. Provided by this script:echo. clean, check, serve, htmlviewecho.echo.All arguments past the first one are passed through to sphinx-build asecho.filenames to build or are ignored. See README.rst in this directory orecho.the documentation for your version of Sphinx for more exhaustive listsecho.of available targets and descriptions of each.echo.echo.This script assumes that the SPHINXBUILD environment variable containsecho.a legitimate command for calling sphinx-build, or that sphinx-build isecho.on your PATH if SPHINXBUILD is not set. Options for sphinx-build canecho.be passed by setting the SPHINXOPTS environment variable.goto end:buildif not exist "%BUILDDIR%" mkdir "%BUILDDIR%"rem PY_MISC_NEWS_DIR is also used by our Sphinx extension in tools/extensions/pyspecific.pyif not defined PY_MISC_NEWS_DIR set PY_MISC_NEWS_DIR=%BUILDDIR%\%1if not exist "%PY_MISC_NEWS_DIR%" mkdir "%PY_MISC_NEWS_DIR%"if exist ..\Misc\NEWS (echo.Copying Misc\NEWS to %PY_MISC_NEWS_DIR%\NEWScopy ..\Misc\NEWS "%PY_MISC_NEWS_DIR%\NEWS" > nul) else if exist ..\Misc\NEWS.D (if defined BLURB (echo.Merging Misc/NEWS with %BLURB%%BLURB% merge -f "%PY_MISC_NEWS_DIR%\NEWS") else (echo.No Misc/NEWS file and Blurb is not available.exit /B 1))if NOT "%PAPER%" == "" (set SPHINXOPTS=-D latex_elements.papersize=%PAPER%%SPHINXOPTS%)if "%1" EQU "htmlhelp" (set SPHINXOPTS=-D html_theme_options.body_max_width=none %SPHINXOPTS%)cmd /S /C "%SPHINXBUILD%%SPHINXOPTS% -b%1 -dbuild\doctrees . "%BUILDDIR%\%1" %2 %3 %4 %5 %6 %7 %8 %9"if "%1" EQU "htmlhelp" ("%HTMLHELP%" "%BUILDDIR%\htmlhelp\python%DISTVERSION:.=%.hhp"rem hhc.exe seems to always exit with code 1, reset to 0 for less than 2if not errorlevel 2 cmd /C exit /b 0)echo.if errorlevel 1 (echo.Build failed (exit code %ERRORLEVEL%^), check for error messagesecho.above. Any output will be found in %BUILDDIR%\%1) else (echo.Build succeeded. All output should be in %BUILDDIR%\%1)goto end:htmlviewif NOT "%2" EQU "" (echo.Can't specify filenames to build with htmlview target, ignoring.)cmd /C %this% htmlif EXIST "%BUILDDIR%\html\index.html" (echo.Opening "%BUILDDIR%\html\index.html" in the default web browser...start "" "%BUILDDIR%\html\index.html")goto end:checkcmd /S /C "%PYTHON% tools\rstlint.py -i tools"goto end:servecmd /S /C "%PYTHON% ..\Tools\scripts\serve.py "%BUILDDIR%\html""goto end:endpopd
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。