@@ -20,6 +20,7 @@ OUTPUT_DOCTREE := $(CPYTHON_WORKDIR)/Doc/build/doctree
20
20
OUTPUT_HTML := $(CPYTHON_WORKDIR ) /Doc/build/html
21
21
LOCALE_DIR := $(CPYTHON_WORKDIR ) /locale
22
22
POSPELL_TMP_DIR := .pospell
23
+ SPHINX_JOBS := auto
23
24
24
25
25
26
.PHONY : help
@@ -38,22 +39,15 @@ help:
38
39
# before this. If passing SPHINXERRORHANDLING='', warnings will not be
39
40
# treated as errors, which is good to skip simple Sphinx syntax mistakes.
40
41
.PHONY : build
41
- build : setup
42
- # FIXME: Relative paths for includes in 'cpython'
43
- # See more about this at https://github.com/python/python-docs-es/issues/1844
44
- sed -i -e ' s|.. include:: ../includes/wasm-notavail.rst|.. include:: ../../../../includes/wasm-notavail.rst|g' cpython/Doc/** /* .rst
45
- sed -i -e ' s|.. include:: ../distutils/_setuptools_disclaimer.rst|.. include:: ../../../../distutils/_setuptools_disclaimer.rst|g' cpython/Doc/** /* .rst
46
- sed -i -e ' s|.. include:: ./_setuptools_disclaimer.rst|.. include:: ../../../_setuptools_disclaimer.rst|g' cpython/Doc/** /* .rst
47
- sed -i -e ' s|.. include:: token-list.inc|.. include:: ../../../token-list.inc|g' cpython/Doc/** /* .rst
48
- sed -i -e ' s|.. include:: ../../using/venv-create.inc|.. include:: ../using/venv-create.inc|g' cpython/Doc/** /* .rst
49
- sed -i -e ' s|.. include:: ../../../using/venv-create.inc|.. include:: ../../using/venv-create.inc|g' cpython/Doc/** /* .rst
50
- sed -i -e ' s|.. include:: /using/venv-create.inc|.. include:: ../../../../using/venv-create.inc|g' cpython/Doc/** /* .rst
42
+ build : setup do_build
43
+
44
+ .PHONY : do_build
45
+ do_build :
51
46
# Normal build
52
- PYTHONWARNINGS=ignore::FutureWarning,ignore::RuntimeWarning $(VENV ) /bin/sphinx-build -j auto -W --keep-going -b html -d $(OUTPUT_DOCTREE ) -D language=$(LANGUAGE ) . $(OUTPUT_HTML ) && \
47
+ PYTHONWARNINGS=ignore::FutureWarning,ignore::RuntimeWarning $(VENV ) /bin/sphinx-build -j $( SPHINX_JOBS ) -W --keep-going -b html -d $(OUTPUT_DOCTREE ) -D language=$(LANGUAGE ) . $(OUTPUT_HTML ) && \
53
48
echo " Success! Open file://` pwd` /$( OUTPUT_HTML) /index.html, " \
54
49
" or run 'make serve' to see them in http://localhost:8000" ;
55
50
56
-
57
51
# setup: After running "venv" target, prepare that virtual environment with
58
52
# a local clone of cpython repository and the translation files.
59
53
# If the directories exists, only update the cpython repository and
0 commit comments