Skip to main content

Reader for ipynb files

Project description

pelican-jupyter-reader: A Plugin for Pelican

PyPI version Netlify Status

This Pelican plugin provides a Jupyter Notebook (i.e. *.ipynb) reader. The plugin intends to allow users to simply drop Jupyter notebooks in their Pelican content directory and have the notebooks rendered (beautifully) in a Pelican static website.


This plugin can be installed via:

pip install pelican-jupyter-reader


  • Add the plugin to
# ...

from pelican.plugins import pelican_jupyter_reader
PLUGINS = [pelican_jupyter_reader]

# ...
    "pelican": {
        "date": "2020-04-10",
        "title": "this is a title",
        "tags": "thats, awesome",
        "category": "yeah",
        "slug": "my-super-post",
        "authors": "Alexis Metaireau, Conan Doyle",
        "summary": "Short version for index and feeds"
    "kernelspec": {
        "display_name": "Python 3",
        "language": "python",
        "name": "python3"
//...the rest of the notebook JSON follows.
  • Drop your Jupyter notebook in the Pelican content directory, build your site, and deploy! :rocket:


The demo/ directory has a simple post with corresponding configuration in The demo site is deployed here.


The Jupyter nbconvert configuration for preprocessors and the HTMLExporter are exposed in your Pelican config, This means you can manipulate notebooks with utilities provided by nbconvert.

For example, to use the basic template for the HTMLExporter, you could add the following to your

from traitlets.config import Config
NBCONVERT_CONFIG.HTMLExporter.template = 'basic'

To strip empty cells from the notebook before publishing, you might add this option to

# ...
NBCONVERT_CONFIG.RegexRemovePreprocessor.patterns = ['\\s*\\Z']

Other nbconvert configuration options can be found here.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pelican-jupyter-reader, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size pelican_jupyter_reader-0.3.1-py3-none-any.whl (4.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pelican-jupyter-reader-0.3.1.tar.gz (4.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page