coderefinery
Generate pdf matches Web-Documention design but has not TOC ...
The generated pdf matches the design of the Web-Document, but has a couple of issues:
- no TOC
- since no TOC, no way to jump directly to a chapter
- "boxes" are often split over 2 pages
A pdf generated with the simplepdf extension has a clickable toc, does not split boxes over 2 pages (if possible) but:
- has a slightly different design
For others testing:
$ pip install https://github.com/useblocks/sphinx-simplepdf/archive/main.zip
$ make simplepdf
and check the output in _build/simplepdf/
What do you think? I guess we should see which can fix #272 sooner to help us decide which to use.
The sphinx_pyppeteer_builder one does have clickable links on the first page, it just is the TOC that appears inline on the index page (in the table). It seems about as detailed for the main lesson as the other one, but is missing the quick ref / instructor guide / other stuff we don't render there. Another option is to make the main index page list everything we would want in the PDF table of contents.
Thanks again for these reports! These PDF builders seem rather new still, so I hope the PDFs will improve over time. I think it's still much better than the other options. (do you know of any other working options?)
