From 0856eb3d1d809783c46d9fb4e121890cb4825130 Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Fri, 14 Jan 2022 10:21:29 -0800 Subject: [PATCH] Add FAQ on images in ipynb containers. Closes #7749. --- doc/faqs.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/doc/faqs.md b/doc/faqs.md index 317153d5f..82de2d780 100644 --- a/doc/faqs.md +++ b/doc/faqs.md @@ -134,3 +134,21 @@ example, ::: +## When I convert from ipynb, some visualizations aren't showing up. + +First, unless your target is a binary format (docx, odt, epub), +you must use either `--extract-media` or (for HTML only) +`--self-contained` to make the images in the ipynb container +available to your output file. + +Second, some Jupyter extensions, especially those that use JavaScript +for visualizations, assume the presence of +[`require.js`](https://github.com/requirejs/requirejs). +To ensure that this script is available in your HTML output, you +can use: + +``` +pandoc -s -o output.html input.ipynb \ +-V header-includes='' +``` +