sphinx_gallery.notebook#
Parser for Jupyter notebooks#
Class that holds the Jupyter notebook information
Functions#
- sphinx_gallery.notebook.add_code_cell(work_notebook, code)[source]#
Add a code cell to the notebook
- Parameters:
code (str) β Cell content
- sphinx_gallery.notebook.add_markdown_cell(work_notebook, markdown)[source]#
Add a markdown cell to the notebook
- Parameters:
markdown (str) β Markdown cell content.
- sphinx_gallery.notebook.convert_code_to_md(text)[source]#
Rewrites code blocks using the code-block notation to use Markdownβs preferred backtick notation, which preserves syntax highlighting.
- Parameters:
text (str) β A mostly converted string of markdown text. May contain zero, one, or multiple code blocks in code-block format.
- sphinx_gallery.notebook.fill_notebook(work_notebook, script_blocks, gallery_conf, target_dir)[source]#
Writes the Jupyter notebook cells
If available, uses pypandoc to convert rst to markdown.
- Parameters:
script_blocks (list) β Each list element should be a tuple of (label, content, lineno).
- sphinx_gallery.notebook.jupyter_notebook(script_blocks, gallery_conf, target_dir)[source]#
Generate a Jupyter notebook file cell-by-cell
- sphinx_gallery.notebook.jupyter_notebook_skeleton()[source]#
Returns a dictionary with the elements of a Jupyter notebook
- sphinx_gallery.notebook.promote_jupyter_cell_magic(work_notebook, markdown)[source]#
Parses a block of markdown text looking for code blocks starting with a Jupyter cell magic (e.g. %%bash). Whenever one is found, the text before it and the code (as a runnable code block) are added to work_notebook. Any remaining text is returned.
- Parameters:
markdown (str) β Markdown cell content.
- sphinx_gallery.notebook.python_to_jupyter_cli(args=None, namespace=None, sphinx_gallery_conf=None)[source]#
Exposes the jupyter notebook renderer to the command line
Takes the same arguments as ArgumentParser.parse_args. sphinx_gallery_conf functions same as in conf.py.
- sphinx_gallery.notebook.rst2md(text, gallery_conf, target_dir, heading_levels)[source]#
Converts the reST text from the examples docstrings and comments into markdown text for the Jupyter notebooks
- Parameters:
text (str) β reST input to be converted to MD
gallery_conf (dict) β The sphinx-gallery configuration dictionary.
target_dir (str) β Path that notebook is intended for. Used where relative paths may be required.
heading_levels (dict) β Mapping of heading style
(over_char, under_char)
to heading level. Note thatover_char
is None when only underline is present.