Description
'Jupyter' Display Machinery.
Description
An interface to the rich display capabilities of 'Jupyter' front-ends (e.g. 'Jupyter Notebook') <https://jupyter.org>. Designed to be used from a running 'IRkernel' session <https://irkernel.github.io>.
README.md
IRdisplay [![b-CI]][CI] [![b-CRAN]][CRAN]
IRdisplay is a front-end package for Jupyter. It’s automatically integrated into IRkernel when you open a Jupyter notebook using that kernel.
The primary, high level functions are:
display(obj, ..., mimetypes=<from option>, error_handler=stop)
display_png(data = NULL, file = NULL, width = NULL, height = NULL)
# display_jpeg(…); display_pdf(…); display_svg(…)
display_html(data = NULL, file = NULL)
# display_javascript(…), display_json(…), display_markdown(…), display_latex(…)
Use display
to display an object in all configured mime types (see Configuration), and the display_*
functions to display raw data you have in form of a file or a variable.
Manual use is possible via the *_mimebundle
functions:
prepare_mimebundle(obj, mimetypes=<from option>, metadata=NULL, error_handler=stop)
publish_mimebundle(data, metadata = NULL)
Where prepare_mimebundle
uses repr
to create a mimebundle containing representations of objects, and publish_mimebundle
sends such mimebundles to Jupyter.
Configuration
You can add your own mime types that should be displayed via:
options(jupyter.display_mimetypes = union(getOption('jupyter.display_mimetypes'), ...))
If you want to create your own kernel reacting to display
/ publish_mimebundle
calls, you can use:
options(jupyter.base_display_func = function(data, metadata = NULL) ...)