IFrame widgets for JupyterLab
Project description
jupyterlab_iframe
Open a site in a widget, or add a set of "quicklinks".
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
- Jupyterlab-html displays local html files as websites in an iframe
- Jupyterlab-sandbox
- Main JLab Issue
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 01d729a12470aa9d1878f337a712d6f12065d5cefbd134b6d4e8e80c429eefa7 |
|
MD5 | 4f982c288a6e9aaef3aca0e17818a9c5 |
|
BLAKE2b-256 | 5e119b7d53fd636bca114092854199d19cbea8ebdd66cd8729e2d2ab32f0496c |
File details
Details for the file jupyterlab_iframe-0.5.0-py3-none-any.whl
.
File metadata
- Download URL: jupyterlab_iframe-0.5.0-py3-none-any.whl
- Upload date:
- Size: 47.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.4
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b14b8adf42f78168d5f776a3d5d77ad340f5873b8c473345f888f6dbc9db6e74 |
|
MD5 | 1dc8f6d5c8e2fcc6840b1033f303b648 |
|
BLAKE2b-256 | 91f3fc82c9f22c851e68f17d26a8f3dd603f0bdfdc2005ab7e65961f9c870d2b |