jupyter-book
jupyter-book copied to clipboard
Change from unmaintained pyppeteer package to alternative for building PDF documents from book
Context
While exploring the option to create a download option for the whole The Turing Way as a PDF document (https://github.com/the-turing-way/the-turing-way/issues/2211), we ran into an issue where the pyppeteer package runs into a Timeout Exception. It has also been documented here in the jupyter-book community, see #1732.
While there seems to be workarounds in the #1732 issue for how to resolve the Timeout Exception, I discovered that the entire pypetteer package, which jupyter-book has the docs built on, has this notice from 2021 in their README:
Attention: This repo is unmaintained and has been outside of minor changes for a long time. Please consider playwright-python as an alternative.
Proposal
This is a suggestion to change the code + instructions for how to build a PDF from a book's HTML (see the docs) to move from the now unmaintained pyppeteer package to something else (they are proposing playwright-python as an alternative).
Tasks and updates
- [ ] Explore alternatives to
pyppeteerpackage for download of all of a book's pages, such as playwright-python or even selenium - [ ] Discuss and decide which alternative to go with
- [ ] Implement the newly selected package in the
build --builder pdfhtmlcommand's workflow
Thanks for opening your first issue here! Engagement like this is essential for open source projects! :hugs:
If you haven't done so already, check out EBP's Code of Conduct. Also, please try to follow the issue template as it helps other community members to contribute more effectively.
If your issue is a feature request, others may react to it, to raise its prominence (see Feature Voting).
Welcome to the EBP community! :tada: