Skip to content

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

@m-aciek
Copy link
Contributor

@m-aciek m-aciek commented Mar 3, 2026

Fix PDF build of documentation.

  • Create a dedicated virtual environment for PDF docs build in Doc Makefile.
  • Introduce sphinxcontrib.rsvgconverter from sphinxcontrib-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.


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

@python-cla-bot
Copy link

python-cla-bot bot commented Mar 3, 2026

All commit authors signed the Contributor License Agreement.

CLA signed

@m-aciek m-aciek force-pushed the pdf-svg-dedicated-venv branch from a930739 to f6981c9 Compare March 4, 2026 22:40
@m-aciek 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 m-aciek marked this pull request as ready for review March 4, 2026 22:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant