Nov 18, 2024 · Nov 18, 2024 · Nov 18, 2024
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
      # Construcción de la documentación
      - name: Construir documentación
        run: |
          make fix_relative_paths
          # Normal build
          PYTHONWARNINGS=ignore::FutureWarning,ignore::RuntimeWarning sphinx-build -j auto -W --keep-going -b html -d cpython/Doc/_build/doctree -D language=es . cpython/Doc/_build/html
diff --git a/Makefile b/Makefile
 #        before this. If passing SPHINXERRORHANDLING='', warnings will not be
 #        treated as errors, which is good to skip simple Sphinx syntax mistakes.
 .PHONY: build
 build: setupfix_relative_pathsdo_build
 build: setup do_build

 .PHONY: do_build
 do_build:
 echo "Success! Open file://`pwd`/$(OUTPUT_HTML)/index.html, " \
 "or run 'make serve' to see them in http://localhost:8000";

 .PHONY: fix_relative_paths
 fix_relative_paths:
 # FIXME: Relative paths for includes in 'cpython'
 # See more about this at https://github.com/python/python-docs-es/issues/1844
 sed -i -e 's|.. include:: ../includes/wasm-notavail.rst|.. include:: ../../../../includes/wasm-notavail.rst|g' cpython/Doc/**/*.rst
 sed -i -e 's|.. include:: token-list.inc|.. include:: ../../../token-list.inc|g' cpython/Doc/library/token.rst
 sed -i -e 's|.. include:: /using/venv-create.inc|.. include:: ../../../../using/venv-create.inc|g' cpython/Doc/library/venv.rst

 # setup: After running "venv" target, prepare that virtual environment with
 #        a local clone of cpython repository and the translation files.
 #        If the directories exists, only update the cpython repository and
diff --git a/conf.py b/conf.py
 import sys
 import os
 import time
 from pathlib import Path

 sys.path.append(os.path.abspath('cpython/Doc/tools/extensions'))
 sys.path.append(os.path.abspath('cpython/Doc/includes'))


 if os.environ.get('SPHINX_GETTEXT') is None:
    # Override all the files from ``.overrides`` directory
    from pathlib import Path
    overrides_paths = Path('.overrides')

    for path in overrides_paths.glob('**/*.*'):
            document.insert(0, banner)

    # Change the sourcedir programmatically because Read the Docs always call it with `.`
    app.srcdir ='cpython/Doc'
    app.srcdir =Path(os.getcwd() + '/cpython/Doc')

    app.connect('doctree-read', add_contributing_banner)
Original file line number	Diff line number	Diff line change
Expand Up		@@ -88,6 +88,5 @@ jobs:
		# Construcción de la documentación
		- name: Construir documentación
		run: \|
		make fix_relative_paths
		# Normal build
		PYTHONWARNINGS=ignore::FutureWarning,ignore::RuntimeWarning sphinx-build -j auto -W --keep-going -b html -d cpython/Doc/_build/doctree -D language=es . cpython/Doc/_build/html
Original file line number	Diff line number	Diff line change
Expand Up		@@ -39,7 +39,7 @@ help:
		# before this. If passing SPHINXERRORHANDLING='', warnings will not be
		# treated as errors, which is good to skip simple Sphinx syntax mistakes.
		.PHONY: build
		build: setupfix_relative_pathsdo_build
		build: setup do_build

		.PHONY: do_build
		do_build:
Expand All		@@ -48,14 +48,6 @@ do_build:
		echo "Success! Open file://`pwd`/$(OUTPUT_HTML)/index.html, " \
		"or run 'make serve' to see them in http://localhost:8000";

		.PHONY: fix_relative_paths
		fix_relative_paths:
		# FIXME: Relative paths for includes in 'cpython'
		# See more about this at https://github.com/python/python-docs-es/issues/1844
		sed -i -e 's\|.. include:: ../includes/wasm-notavail.rst\|.. include:: ../../../../includes/wasm-notavail.rst\|g' cpython/Doc/*/.rst
		sed -i -e 's\|.. include:: token-list.inc\|.. include:: ../../../token-list.inc\|g' cpython/Doc/library/token.rst
		sed -i -e 's\|.. include:: /using/venv-create.inc\|.. include:: ../../../../using/venv-create.inc\|g' cpython/Doc/library/venv.rst

		# setup: After running "venv" target, prepare that virtual environment with
		# a local clone of cpython repository and the translation files.
		# If the directories exists, only update the cpython repository and
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -16,6 +16,8 @@
		import sys
		import os
		import time
		from pathlib import Path

		sys.path.append(os.path.abspath('cpython/Doc/tools/extensions'))
		sys.path.append(os.path.abspath('cpython/Doc/includes'))

Expand DownExpand Up		@@ -70,7 +72,6 @@

		if os.environ.get('SPHINX_GETTEXT') is None:
		# Override all the files from ``.overrides`` directory
		from pathlib import Path
		overrides_paths = Path('.overrides')

		for path in overrides_paths.glob('*/.*'):
Expand DownExpand Up		@@ -129,7 +130,7 @@ def add_contributing_banner(app, doctree):
		document.insert(0, banner)

		# Change the sourcedir programmatically because Read the Docs always call it with `.`
		app.srcdir ='cpython/Doc'
		app.srcdir =Path(os.getcwd() + '/cpython/Doc')

		app.connect('doctree-read', add_contributing_banner)

Expand Down