Commit 0c59598a authored by Willi Rath's avatar Willi Rath
Browse files

Unify spelling of JupyerLab

parent ed7e1a5a
Loading
Loading
Loading
Loading
+14 −15
Original line number Original line Diff line number Diff line
# How to work with Jupyter everywhere
# How to work with JupyterLab everywhere




## Install the base environment and Jupyterlab
## Install the base environment and JupyterLab


_This will show how to download the installer, install a minimal Python
_This will show how to download the installer, install a minimal Python
environment, and start Jupyerlab.  The installation will be (nearly) identical
environment, and start JupyerLab.  The installation will be (nearly) identical
for a local computer or for any Linux / Unix remote computer._
for a local computer or for any Linux / Unix remote computer._


### Download and install Miniconda3
### Download and install Miniconda3
@@ -35,7 +35,7 @@ follow the instructions for Miniconda**3** and do _**not**_ make this
installation your standard Python.)
installation your standard Python.)




### Activating the base environment and installing Jupyterlab
### Activate the base environment and install JupyterLab


To activate the base environment, run:
To activate the base environment, run:
```bash
```bash
@@ -49,7 +49,7 @@ conda install jupyterlab nb_conda_kernels
```
```




### Start Jupyterlab
### Start JupyterLab


After activating the base environment with
After activating the base environment with
```bash
```bash
@@ -68,8 +68,7 @@ Copy/paste this URL into your browser when you connect for the first time,


```
```


Copy the URL (from your shell!) to your web browser.  You should see Jupyter
Copy the URL (from your shell!) to your web browser.  You should see JupyterLab.
lab.




## Add a scientific Python environment and use it
## Add a scientific Python environment and use it
@@ -95,14 +94,14 @@ _(Do **always** install `ipykernel` into the environment, to make sure that
Jupyter recognizes the new environment as a kernel.)_
Jupyter recognizes the new environment as a kernel.)_




### Use the environment in Jupyterlab
### Use the environment in JupyterLab


Above, we created a new environment `py3_std`.  To use it, activate the `base`
Above, we created a new environment `py3_std`.  To use it, activate the `base`
environment and start Jupyterlab.  There, you should be able to create a new
environment and start JupyterLab.  There, you should be able to create a new
notebook and choose the `py3_std` environment as its kernel.
notebook and choose the `py3_std` environment as its kernel.




## Connect to Jupyterlab running on a remote machine
## Connect to JupyterLab running on a remote machine


_This will show how to connect to Jupyterlab if your web browser cannot
_This will show how to connect to Jupyterlab if your web browser cannot
directly access its address._
directly access its address._
@@ -111,7 +110,7 @@ directly access its address._
### Start Jupyterlab on a remote machine
### Start Jupyterlab on a remote machine


After installing Jupyter and your Python environments on a remote machine,
After installing Jupyter and your Python environments on a remote machine,
follow the instructions on how to [Start Jupyterlab][#start-jupyterlab] above.
follow the instructions on how to (Start JupyterLab)[#start-jupyterlab] above.
But before pasting the URL provided by Jupyter into your browser, make sure to
But before pasting the URL provided by Jupyter into your browser, make sure to
follow the next steps.
follow the next steps.


@@ -151,9 +150,9 @@ Note that these steps will only work, if `host.example.com` is a known host in
continue and if you do, `host.example.com` will be added to `.ssh/known_hosts`.)
continue and if you do, `host.example.com` will be added to `.ssh/known_hosts`.)




### Connect your browser to the remote Jupyterlab
### Connect your browser to the remote JupyterLab


Now, you can paste the URL provided by Jupyterlab into the tunneled browser.
Now, you can paste the URL provided by JupyterLab into the tunneled browser.




## Appendix: Jargon
## Appendix: Jargon
@@ -165,5 +164,5 @@ Now, you can paste the URL provided by Jupyterlab into the tunneled browser.
  are collections of packages / versions that make it possible to switch
  are collections of packages / versions that make it possible to switch
  between different sets of software.
  between different sets of software.


- [Jupyter lab](https://en.wikipedia.org/wiki/Project_Jupyter#Jupyter_Lab) is
- [JupyterLab](https://blog.jupyter.org/jupyterlab-is-ready-for-users-5a6f039b8906) is
  an integrated computing environment
  an integrated web-based computing environment