Skip to main content

IFrame widgets for JupyterLab

Project description

jupyterlab_iframe

Open a site in a widget, or add a set of "quicklinks".

Build Status codecov PyPI PyPI npm Binder

Install

pip install jupyterlab_iframe
jupyter labextension install jupyterlab_iframe
jupyter serverextension enable --py jupyterlab_iframe

Options

External Sites

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

c.JupyterLabIFrame.iframes = ['list', 'of', 'sites']

In this example, list, of, and sites will be available as links in the command palette.

Landing page on initial page load

c.JupyterLabIFrame.iframes = ['list', 'of', 'sites']
c.JupyterLabIFrame.welcome = 'a site to show on initial load'
c.JupyterLabIFrame.local_files = ['list', 'of', 'local', 'html', 'files']

In this example, a site will open by default the first time JupyterLab is opened.

Open local html file in iframe

c.JupyterLabIFrame.local_files = ['list', 'of', 'local', 'html', 'files']

Any files specified by 'local_files' will be served up as local links. By default any file on the filesystem is allowed, to disable this and only allow the list specifically designated here, set c.JupyterLabIFrame.allow_any_local = False. If you allow all, in the open dialog start the file path with local://.

Caveats

Update for version v0.0.12 - Most of these are covered by #31

This package uses iframes, so is subject to a few restrictions: - If Jlab is served over SSL, so must the sites (http/https must match) - If the underlying site enforces same-origin, then we cannot navigate to them (e.g. google)

Similar Packages

Configuring Binder with a landing page

To configure binder to serve a landing page, simply add the following configuration:

To requirements.txt:

jupyterlab_iframe>=0.2

To postBuild:

jupyter labextension install jupyterlab_iframe@^0.2
jupyter serverextension enable --py jupyterlab_iframe

config="c.JupyterLabIFrame.welcome = 'local://binder/landing.html'"
mkdir -p ~/.jupyter
echo -e $config > ~/.jupyter/jupyter_notebook_config.py

Project details


Download files

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

Source Distribution

jupyterlab_iframe-0.5.0.tar.gz (163.8 kB view details)

Uploaded Source

Built Distribution

jupyterlab_iframe-0.5.0-py3-none-any.whl (47.3 kB view details)

Uploaded Python 3

File details

Details for the file jupyterlab_iframe-0.5.0.tar.gz.

File metadata

  • Download URL: jupyterlab_iframe-0.5.0.tar.gz
  • Upload date:
  • Size: 163.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for jupyterlab_iframe-0.5.0.tar.gz
Algorithm Hash digest
SHA256 01d729a12470aa9d1878f337a712d6f12065d5cefbd134b6d4e8e80c429eefa7
MD5 4f982c288a6e9aaef3aca0e17818a9c5
BLAKE2b-256 5e119b7d53fd636bca114092854199d19cbea8ebdd66cd8729e2d2ab32f0496c

See more details on using hashes here.

File details

Details for the file jupyterlab_iframe-0.5.0-py3-none-any.whl.

File metadata

File hashes

Hashes for jupyterlab_iframe-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b14b8adf42f78168d5f776a3d5d77ad340f5873b8c473345f888f6dbc9db6e74
MD5 1dc8f6d5c8e2fcc6840b1033f303b648
BLAKE2b-256 91f3fc82c9f22c851e68f17d26a8f3dd603f0bdfdc2005ab7e65961f9c870d2b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page