gh-139588: Docs: fix PDF build#145480

Open

m-aciek wants to merge 3 commits intopython:mainfrom

m-aciek:pdf-svg-dedicated-venv

Open

gh-139588: Docs: fix PDF build#145480
m-aciek wants to merge 3 commits intopython:mainfrom
m-aciek:pdf-svg-dedicated-venv

Conversation

Copy link

Contributor

m-aciek commentedMar 3, 2026•
edited
Loading

Fix PDF build of documentation.

Create a dedicated virtual environment for PDF docs build in Doc Makefile.
Introducesphinxcontrib.rsvgconverter fromsphinxcontrib-svg2pdfconverter for converting of SVG graphics to PDF format.
Hide GIF graphics from PDF (LaTeX) build.

Refs.python/docs-community#182.

Test build is available here:https://github.com/m-aciek/python-docs-offline/actions/runs/22693391266. Artifacts include ZIP to download.

Issue:make dist-pdf is broken #139588

📚 Documentation preview 📚:https://cpython-previews--145480.org.readthedocs.build/

Copy link

python-cla-botbot commentedMar 3, 2026•
edited
Loading

All commit authors signed the Contributor License Agreement.

bedevere-appbot mentioned this pull request

Mar 3, 2026

make dist-pdf is broken#139588

Open

m-aciek added3 commits

March 4, 2026 23:01

Docs: PDF: convert SVG to PDF using sphinxcontrib.rsvgconverter

6c6f528

Add support for PDF virtual environment in Makefile

273d2aa

Hide GIFs from PDF builds

f6981c9

m-aciek force-pushed thepdf-svg-dedicated-venv branch froma930739 tof6981c9Compare

March 4, 2026 22:40

m-aciek changed the title~~gh-139588: Docs: PDF: dedicated venv and converting SVG to PDF using sphinxcontrib.rsvgconverter~~gh-139588: Docs: fix PDF build

Mar 4, 2026

m-aciek marked this pull request as ready for review

March 4, 2026 22:53

m-aciek requested review fromAA-Turner,hugovk andpablogsal ascode owners

March 4, 2026 22:53

bedevere-appbot added the awaiting review label

Mar 4, 2026

m-aciek mentioned this pull request

Mar 4, 2026

gh-139588: Docs: PDF/LaTeX: Add Heapq docs image in PDF format#140926

Closed