Metadata-Version: 2.1
Name: sphinx-juniper
Version: 0.0.2
Summary: Convert Jupyter Notebooks into runnable HTML files with Juniper (https://github.com/ines/juniper).
Home-page: https://github.com/ashtonmv/sphinx-juniper
License: MIT
Author: Michael Ashton
Author-email: ashtonmv@gmail.com
Requires-Python: >=3.7,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Requires-Dist: sphinx (>=2.0)
Project-URL: Repository, https://github.com/ashtonmv/sphinx-juniper
Description-Content-Type: text/markdown

# sphinx-juniper
Integrate interactive code blocks into your documentation with [Juniper](https://github.com/ines/juniper) and [Binder](https://mybinder.org).

## Install

To install `sphinx-juniper` first clone and install it:

```
pip install sphinx-juniper
```

Then, add it to your Jupyter Book's `_config.yml` file:

(to use all default values)
```
sphinx:
  extra_extensions:
    - sphinx_juniper
  config:
    juniper: true
```

To override any/all defaults:
```
sphinx:
  extra_extensions:
    - sphinx_juniper
  config:
    juniper:
      url: https://mybinder.org  # BinderHub instance
      repo: ashtonmv/python_binder  # Github repository for Binder image
      theme: monokai  # Styling (only monokai and material supported for now)
      isolateCells: false  # Whether to share variables between cells
      useStorage: true  # Cache the kernel connection between page loads
      ...
      etc.
      ...
```

Similar to BinderHub links and Colab links, sphinx-juniper only acts on
Ipython Notebooks included in your documentation! It adds a button to the "launch_buttons" (the one with a rocket on it) dropdown menu for these pages at
the top. Clicking this button will start the connection to the kernel you've
configured based on the settings in _config.yml above.
