Execute docs examples in CI

[MartinThoma]

I want the docs to be complete, meaning all code blocks have all imports.

See https://pypi.org/project/pytest-examples/ - I think it's used by pydantic

That should also ensure that we don't have deprecated code in there + that no typos happen.

[stefan6419846]

Sphinx seems to have some built-in support for something like this as well: https://www.sphinx-doc.org/en/master/usage/extensions/doctest.html

[j-t-1]

In the first example of Cropping and Transforming PDFs, does the JavaScript part work when opening the created file?

I do not have a printer, so it not displaying could simply be because of this.

[stefan6419846]

It probably depends on the application as well - not all viewers tend to support Javascript as far as I know.

[j-t-1]

I tried with Adobe Acrobat Reader. Thinking about it I should have also tried with Microsoft Edge.