jupyter-templates 0.1.0

notebook templates for jupyter and jupyterlab

Support for notebook templates in jupyter and jupyterlab

Install

PyPI

jupyter-templates is available on PyPI:

pip install jupyter-templates

Conda

jupyter-templates is also available on conda-forge:

conda install -c conda-forge jupyter-templates

Jupyter Server/JupyterLab Extension

jupyter-templates is available as a prebuilt extension, so no further action should be necessary in JupyterLab.

To install it explicitly, run:

jupyter labextension install jupyter-templates
jupyter server extension enable --py jupyter-templates

For classic Notebook, run:

jupyter nbclassic-extension enable jupyter_templates/extension

Adding templates

install the server extension, and add the following to jupyter_notebook_config.py

c.JupyterLabTemplates.allowed_extensions = ["*.ipynb"]
c.JupyterLabTemplates.template_dirs = ['list', 'of', 'template', 'directories']
c.JupyterLabTemplates.include_default = True
c.JupyterLabTemplates.include_core_paths = True
c.JupyterLabTemplates.template_label = "Template"

Templates for libraries

The extension will search subdirectories of each parent directory specified in template_dirs for templates. Note! Templates in the parent directories will be ignored. You must put the templates in subdirectories, in order to keep everything organized.

If include_default = True the notebook_templates directory under the jupyter data folder is one of the default parent directories. Thus, if you have tutorials or guides you'd like to install for users, simply copy them into your jupyter data folder inside the notebook_templates directory, e.g. /usr/local/share/jupyter/notebook_templates/bqplot for bqplot.

If you want to exclude templates from a specific directory, please add a file .jupyter_templates_ignore to to this location. All notebooks in this directory will be ignored (but has no effect on subdirectories).

Flags

• allowed_extensions: a list of extensions to allow templates for. (optional, default ["*.ipynb"])
• template_dirs: a list of absolute directory paths. All files matching allowed_extensions in any subdirectories of these paths will be listed as templates
• include_default: include the default Sample template (default True)
• include_core_paths: include jupyter core paths (see: jupyter --paths) (default True)
• template_label: set label for template UI icon (default "Template")

This software is licensed under the Apache 2.0 license. See the LICENSE file for details.