Welcome to sphinx-k3d-screenshot documentation!
sphinx-k3d-screenshot is a Sphinx extension to capture a screenshot of a
K3D Jupyter plot
and include it into a Sphinx documentation page.
This extension aims to solve the following problem: including the html (and JS+CSS) of a K3D-Jupyter plot into a Sphinx documentation page could slow down the loading of the page. Further, if multiple plots were to be included, an unnecessarily huge bandwith might be used. In this situations, a better approach is to include a small resolution screenshot of the application, which conveys almost the same information to the final user. The extension also exposes an URL to the HTML file containing the plot, in case someone is interested in a closer look.
Currently, the following output types are supported:
html: creates an HTML file of the application.
small.png: loads the html file to an headless browser and creates a screenshot based on a customizable small-screen device. This is the picture that will be shown on the documentation page.
large.png: loads the html file to an headless browser and creates a screenshot based on a customizable large-screen device.
pdf: creates a PDF starting from one of the screenshots.
Note that this extension is based on Matplotlib’s plot directive.