Skip to content

Commit 0e15fdc

Browse files
committed
Added JupyterLab announcement and updated install page.
1 parent f6b1039 commit 0e15fdc

File tree

6 files changed

+98
-7
lines changed

6 files changed

+98
-7
lines changed

assets/easy.png

12.4 KB
Loading

assets/flexible.png

12.8 KB
Loading

assets/reproducible.png

10 KB
Loading

assets/shareable.png

11.3 KB
Loading

index.html

+48
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,54 @@ <h4 class="jumbotron-text">Project Jupyter exists to develop open-source softwar
3737
</div>
3838
</div>
3939
</section>
40+
<section id="jupyterlab">
41+
<div class="section-grey">
42+
<div class="lab-preview">
43+
<div class="container">
44+
<div class="row">
45+
<div class="col-md-6">
46+
<img class="img-responsive" src="assets/labpreview.png" id="portal" alt="examples of jupyterlab workspaces in single document and multiple document workspaces"/>
47+
</div>
48+
<div class="col-md-6 nb-highlight-text">
49+
<h3>JupyterLab - A Next-Generation Notebook Interface</h3>
50+
<h4 class="lab-desc">JupyterLab is a web-based platform that combines live code, text, images, visualizations, and data analysis into a single,
51+
interactive environment. JupyterLab offers all the building blocks of the classic Jupyter Notebook in an extendable interface.</h4>
52+
</div>
53+
<div>
54+
<a class="orange-button" href="try">Try it in your browser</a>
55+
<a class="orange-button install-button" href="install.html">Install JupyterLab</a>
56+
</div>
57+
</div>
58+
</div>
59+
</div>
60+
<div class="notebook-features">
61+
<div class="container">
62+
<div class="row">
63+
<div class="col-md-3 notebook-feature">
64+
<img class="img-responsive language" src="assets/easy.svg" id="feature" alt="icon to represent ease of use">
65+
<h4>Easy to Use</h4>
66+
<p>Compose notebooks, run terminals or consoles, and edit text files all within your browser. With a simple, straight-forward interface, start programming right away using any language.</p>
67+
</div>
68+
<div class="col-md-3 notebook-feature">
69+
<img class="img-responsive share" src="assets/flexible.svg" alt="icon to flexibility">
70+
<h4>Share notebooks</h4>
71+
<p>Test your code as you go; see results immediately and iterate on your explorations. JupyterLab extends the Classic Notebook interface to give a desktop-like work area in which to explore data.</p>
72+
</div>
73+
<div class="col-md-3 notebook-feature">
74+
<img class="img-responsive widget" src="assets/recroducible.svg" alt="icon to represent reproducibility">
75+
<h4>Reproducible</h4>
76+
<p>Allow others to replicate and build off your work. Explain your thought process step-by-step, and share it so others can run the same analysis from anywhere in the cloud, or on their own machine.</p>
77+
</div>
78+
<div class="col-md-3 notebook-feature">
79+
<img class="img-responsive data" src="assets/shareable.svg" alt="icon to represent sharing a notebook">
80+
<h4>Shareable</h4>
81+
<p>Visualize your work and tell a story in a way that feels simple and fun. Export to a variety of formats, including a webpage, PDF, and Word document, and share it with others.</p>
82+
</div>
83+
</div>
84+
</div>
85+
</div>
86+
</div>
87+
</section>
4088
<section id="about-notebook">
4189
<div class="section-white">
4290
<div class="notebook-preview">

install.md

+50-7
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,59 @@
11
---
22
layout: page_md
3-
title: Installing the Jupyter Notebook
4-
tagline: Get up and running with the Jupyter Notebook on your computer within minutes!
3+
title: Installing the Jupyter Software
4+
tagline: Get up and running with the JupyterLab or the classic Jupyter Notebook on your computer within minutes!
55
permalink: /install
66
---
77

8-
## Prerequisite: Python
9-
While Jupyter runs code in many programming languages, Python is a requirement
10-
(Python 3.3 or greater, or Python 2.7) for installing the Jupyter Notebook itself.
8+
## Getting started with JupyterLab
9+
10+
### Installation
11+
12+
[install](http://jupyterlab.readthedocs.io/en/stable/getting_started/installation.html) JupyterLab using `conda`, `pip`, or `pipenv`. Conda is recommended if you have no installation preference.
13+
14+
Project installation instructions from the git sources are available in the [contributor documentation](CONTRIBUTING.md).
15+
16+
#### conda
17+
18+
Conda is an open source package management system and environment management system that runs on Windows, macOS, and Linux. Conda packages and distributes software for any language, and by default uses the Anaconda repository managed by Anaconda Inc. To install conda, please [see the conda installation instructions](https://docs.conda.io/projects/conda/en/latest/user-guide/install/index.html).
19+
20+
Install the [JupyterLab `conda` package](https://anaconda.org/conda-forge/jupyterlab) with:
21+
22+
```bash
23+
conda install -c conda-forge jupyterlab
24+
```
1125

26+
#### pip
27+
28+
pip is a package management system for installing and updating Python packages, and comes with any Python installation. On Ubuntu, SUSE Enterprise Linux, openSUSE, and Fedora Linux, use the system package manager to install the `python3-pip` package. [\_The Hitchhiker's Guide to Python_provides guidance on how to install Python](https://docs.python-guide.org/starting/installation/); Another option is to [install Python directly from python.org](https://www.python.org/getit/). We suggest you [upgrade pip](https://pip.pypa.io/en/stable/installing/) before using it to install other programs.
29+
30+
JupyterLab requires Python 3.5 or higher.
31+
32+
1. When using Windows with Python version 3.5 or higher, use the [Python Launcher for Windows](https://docs.python.org/3/using/windows.html?highlight=shebang#python-launcher-for-windows) to use `pip` with Python version 3:
33+
```bash
34+
py -3 -m pip install jupyterlab
35+
```
36+
2. If the system has a `python3` command (standard on Unix-like systems), install with the comand:
37+
```bash
38+
python3 -m pip install jupyterlab
39+
```
40+
3. Using the `python` command directly is another option, but this will use the _current_ version of Python (which may be Python version 2 or version 3 if both are installed):
41+
```bash
42+
python -m pip install jupyterlab
43+
```
44+
45+
Some systems have a `pip3` command that has the same effect as `python3 -m pip` and/or a `pip` command that behaves the same as `python -m pip`.
46+
47+
Adding `--user` after `pip install` will install the files to a local user install directory (typically `~/.local/` or `%APPDATA%\Python` on Windows) instead of the system-wide directory. This can be helpful, especially if writing to the system-wide directory is not permitted. However, the user-level `bin` directory must be added to the `PATH` environment variable in order to launch `jupyter lab`.
48+
49+
50+
## Getting started with the classic Jupyter Notebook
51+
52+
### Prerequisite: Python
53+
While Jupyter runs code in many programming languages, Python is a requirement
54+
(Python 3.3 or greater, or Python 2.7) for installing the JupyterLab or the classic Jupyter Notebook.
1255

13-
## Installing Jupyter using Anaconda
56+
### Installing Jupyter Notebook using Anaconda
1457
We **strongly recommend** installing Python and Jupyter using the [Anaconda Distribution](https://www.anaconda.com/downloads),
1558
which includes Python, the Jupyter Notebook, and other commonly used packages for scientific computing and data science.
1659

@@ -26,7 +69,7 @@ jupyter notebook
2669

2770
See [Running the Notebook](https://jupyter.readthedocs.io/en/latest/running.html#running) for more details.
2871

29-
## Installing Jupyter with pip
72+
### Installing Jupyter Notebook with pip
3073
As an existing or experienced Python user, you may wish to install Jupyter using Python’s package manager, pip, instead of Anaconda.
3174

3275
If you have Python 3 installed (which is recommended):

0 commit comments

Comments
 (0)