JupyterLite Schema v0

a schema for user-serviceable customizaton of a JupyterLite

https://jupyterlite.readthedocs.org/en/latest/schema-v0.html#

JupyterLite Configuration

JupyterLite Configuration

a user-serviceable file for customizing a JupyterLite site

properties

  • jupyter-lite-schema-version

version of the schema to which the instance conforms

type

integer

enum

0

  • jupyter-config-data

Jupyter Config Data

JupyterLab Settings Overrides

A map of config objects keyed by @org/pkg:plugin which override the default settings. See https://jupyterlab.readthedocs.io/en/stable/user/directories.html#overridesjson

type

object

patternProperties

  • ^(@[a-z0-9-~][a-z0-9-._~]*/)?[a-z0-9-~][a-z0-9-._~]*:(.*)$

A valid configuration which must conform to the plugin’s defined schema

type

object

Jupyter Config Data

contents of a jupyter-config-data <script>, as read by PageConfig. These well-known values may be augmented by other extensions.

properties

  • appName

The application name, as would appear in a Help menu

type

string

  • appVersion

The version of the application

type

string

  • baseUrl

base URL of this JupyterLite, must end in /, will be expanded by config-utils.js to include a leading /

type

string

pattern

.*/$

default

./

format

uri

  • appUrl

default app to load

default

./lab

A URI what doesn’t end in /

  • faviconUrl

browser tab icon to show

type

string

default

./lab/favicon.ico

format

uri

  • settingsOverrides

JupyterLab Settings Overrides

  • federated_extensions

type

array

default

items

A Federated Extension

  • fullLabextensionsUrl

path to federated extensions, a folder organized by ({:org}/){package}

default

./lab/extensions

A URI what doesn’t end in /

  • fullMathjaxUrl

path to MathJax2 assets

type

string

default

https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/MathJax.js

format

uri

  • mathjaxConfig

a valid MathJax configuration blob, a comma-delimted list of… something

type

string

default

TeX-AMS_CHTML-full,Safe

  • fullStaticUrl

relative path to built static assets

default

./lab/build

A URI what doesn’t end in /

  • settingsUrl

relative path to bundled schemas

default

./lab/build/schemas

A URI what doesn’t end in /

  • themesUrl

relative path to bundled themes

default

./lab/build/themes

A URI what doesn’t end in /

  • pyodideUrl

The path to the main pyodide.js entry point

type

string

default

https://cdn.jsdelivr.net/pyodide/v0.18.1/full/pyodide.js

format

uri

  • disabledExtensions

Lab extensions (or specific plugins) to disable

type

array

items

oneOf

An NPM Package Name

A JupyterLab Plugin

A URI what doesn’t end in /

type

string

pattern

.*[^/]$

format

uri

A Federated Extension

type

object

properties

  • extension

path to the extension module to load, relative to the extension’s package.json

type

string

format

uri

  • mimeExtension

path to the mime extension module to load, relative to the extension’s package.json

type

string

format

uri

  • load

path to the WebPack 5-compatible remoteEntry*.js file describing the bundle

type

string

format

uri

  • name

An NPM Package Name

  • style

path to the optional style module provided by the extension

type

string

format

uri

An NPM Package Name

package.json-compatible extension name, with an optional organziation prefix. See https://github.com/dword-design/package-name-regex/blob/master/src/index.js

type

string

pattern

^(@[a-z0-9-~][a-z0-9-._~]*/)?[a-z0-9-~][a-z0-9-._~]*$

A JupyterLab Plugin

a package.json-compatible extension name followed by a colon (:) and a specific plugin name

type

string

pattern

^(@[a-z0-9-~][a-z0-9-._~]*/)?[a-z0-9-~][a-z0-9-._~]*:(.*)$