Geen omschrijving

Steven Silvester 072f80a721 Merge pull request #150 from faricacarroll/master 8 jaren geleden
design 072f80a721 Merge pull request #150 from faricacarroll/master 8 jaren geleden
examples 94f8e80c7c Update notebook example 8 jaren geleden
git-hooks e0473680ce Simplify build step and update documents. 8 jaren geleden
jupyterlab ebd86ac2c9 Use inline source map for now 8 jaren geleden
scripts 8d286d190b Disable jekyll 8 jaren geleden
src 60dbfe25c5 Merge pull request #111 from bliker/unified-fonts 8 jaren geleden
test 26dc8bb20b Merge pull request #121 from blink1073/notebookpanel-tests 8 jaren geleden
tutorial 1c2dc6e598 Merge pull request #156 from willingc/sphinx-tutorial 8 jaren geleden
typings 50ca4430c7 Add type definitions for undocumented CodeMirror testing functions (and an explanatory comment). 8 jaren geleden
.gitignore 76f69bc7ff Add JupyterLab python package infrastructure to build the Jupyter extension. 8 jaren geleden
.travis.yml dfe5e5a4f2 Add docs push 8 jaren geleden
CONTRIBUTING.md 09f4ad52ba Add front matter 9 jaren geleden
LICENSE f2a4b8d992 Merge jupyter-js-notebook repo 8 jaren geleden
MANIFEST.in 76f69bc7ff Add JupyterLab python package infrastructure to build the Jupyter extension. 8 jaren geleden
README.md f2c0e20318 Merge pull request #155 from afshin/build-fix 8 jaren geleden
jupyter-plugins-demo.gif 1baa71ee22 Update demo and add static picture 9 jaren geleden
jupyter_plugins.png 1baa71ee22 Update demo and add static picture 9 jaren geleden
package.json e0473680ce Simplify build step and update documents. 8 jaren geleden
readthedocs.yml 98a2b037fe Fix directory for conda environment 8 jaren geleden
setup.py f1ceb2ac68 Make shell=True only on windows, where it’s needed. 8 jaren geleden
tslint.json 5cc5e87bdb Add tslint file 8 jaren geleden

README.md

JupyterLab

An extensible computational environment for Jupyter.

This is a very early pre-alpha developer preview. It is not ready for general usage yet.

API Docs

JupyterLab Demo

Jupyter Server Extension

The Jupyter server extension source files are in the jupyterlab/ subdirectory. To use this extension, you need the Jupyter notebook server version 4.2 or later.

User installation

pip install jupyterlab
jupyter serverextension enable --py jupyterlab

Start up Jupyterlab with the command:

jupyter lab

Open a browser to the notebook server's URL (e.g., http://localhost:8888).

Developer Installation

You will need npm (preferably version 5 or later). First fork the repo in the GitHub UI and then clone locally:

git clone https://github.com/<your-github-username>/jupyterlab.git
cd jupyterlab
npm install
pip install -e . # will take a long time to build everything
jupyter serverextension enable --py jupyterlab

Start up Jupyterlab with the command:

jupyter lab

Open a browser to the notebook server's URL (e.g., http://localhost:8888).

When you make a change to JupyterLab npm package source files, run:

npm run build:serverextension

to build the changes and refresh your browser to see the changes.

To have the system build after each change to the source files, run:

npm run watch:serverextension

and refresh the browser after each successful update.

NPM Package

The npm package source files are in the src/ subdirectory.

Prerequisites

  • node (preferably version 5 or later)
  • Jupyter notebook server version 4.2 or later (to run examples)
npm install --save jupyterlab

NPM Source Build

git clone https://github.com/jupyter/jupyterlab.git
cd jupyterlab
npm install
npm run build:all

Rebuild

npm run clean
npm run build:all

Build JupyterLab server extension

npm run build:serverextension

Run Tests

Follow the source build instructions first.

npm test

Build Examples

Follow the source build instructions first. Requires a Python install with the Jupyter notebook (version 4.2 or later).

npm run build:examples

Change to the appropriate example in the examples directory and run python main.py.

Build Docs

Follow the source build instructions first.

npm run docs

Navigate to docs/index.html.

Publishing packages for a JupyterLab release

We publish an npm package, a pypi source package, and a pypi universal binary wheel.

npm version patch
git push origin master --tags
npm publish
python setup.py sdist upload
python setup.py bdist_wheel --universal upload

Supported Runtimes

The runtime versions which are currently known to work are listed below. Earlier versions may also work, but come with no guarantees.

  • IE 11+
  • Firefox 32+
  • Chrome 38+

Note: "requirejs" must be included in a global context (usually as a <script> tag) for Comm targets.

Bundle for the Browser

Follow the package install instructions first.

Any bundler that understands how to require() files with .js and .css extensions can be used with this package.

Note: This npm module is fully compatible with Node/Babel/ES6/ES5. Simply omit the type declarations when using a language other than TypeScript.