Commit e0eb0e1c authored by Willi Rath's avatar Willi Rath

Highlight notes using block quotes

parent fbb028ae
# How to work with JupyterLab everywhere
_This guide **will** walk you through the complete setup of JupyterLab and
one or more scientific Python computing environments on your local computer
or on a remote machine._
>
> _This guide **will** walk you through the complete setup of JupyterLab and
> one or more scientific Python computing environments on your local computer
> or on a remote machine._
>
_This guild **will not** explain how to use the shell, how to connect to
remote machines via SSH, or how to make sure you have acces to the relevant
networks, e.g., via VPN._
>
> _This guild **will not** explain how to use the shell, how to connect to
> remote machines via SSH, or how to make sure you have acces to the relevant
> networks, e.g., via VPN._
>
_Currently, **only Linux / Unix** and **MacOSX** are covered._
>
> _Currently, **only Linux / Unix** and **MacOSX** are covered._
>
## Install the base environment and JupyterLab
_This will show how to download the installer, install a minimal Python
environment, and start JupyerLab. Execute the steps below on the computer
where the calculation should be performed (e.g., your local computer or a
computer in a remote computing centre)._
>
> _This will show how to download the installer, install a minimal Python
> environment, and start JupyerLab. Execute the steps below on the computer
> where the calculation should be performed (e.g., your local computer or a
> computer in a remote computing centre)._
>
### Download and install Miniconda3
_(No matter if you want to work with Python 3, which you probably should, or
Python 2, the **base environment should be Python 3**.)_
>
> _(No matter if you want to work with Python 3, which you probably should, or
> Python 2, the **base environment should be Python 3**.)_
>
To download the latest installer
......@@ -82,22 +92,20 @@ 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 JupyterLab.
---
---
_**Note** that at this point, you only have a minimal Python 3 installation with
a functional JupyterLab frontend. To perform scientific analyses, you need to add one
or more environments with a selection of scientific software._
---
---
>
> _**Note** that at this point, you only have a minimal Python 3 installation with
> a functional JupyterLab frontend. To perform scientific analyses, you need to add one
> or more environments with a selection of scientific software._
>
## Add a scientific Python environment and use it
_This will show how to add a Python environment that can be used for scientific
analyses._
>
> _This will show how to add a Python environment that can be used for scientific
> analyses._
>
### Add a scientific environment
......@@ -112,8 +120,10 @@ Python 3, `numpy`, `matplotlib`, `scipy`):
conda create -n py3_std python=3 numpy matplotlib scipy ipykernel
```
_(Do **always** install `ipykernel` into the environment, to make sure that
JupyterLab recognizes the new environment as a kernel.)_
>
> _(Do **always** install `ipykernel` into the environment, to make sure that
> JupyterLab recognizes the new environment as a kernel.)_
>
### Use the environment in JupyterLab
......@@ -122,24 +132,22 @@ 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
notebook and choose the `py3_std` environment as its kernel.
---
---
_At this point, you know how to set up a full Python installation including a
JupyterLab front end in the `base` environment and one or more scientific
computing environments that can be used in real scientific analyses. The
instructions above work on any local or remote Linux / Unix or MacOSX machine.
Below, you'll learn how to connect to JupyterLab if you installed Python on a
remote machine that you can only connect to via SSH._
---
---
>
> _At this point, you know how to set up a full Python installation including a
> JupyterLab front end in the `base` environment and one or more scientific
> computing environments that can be used in real scientific analyses. The
> instructions above work on any local or remote Linux / Unix or MacOSX machine.
> Below, you'll learn how to connect to JupyterLab if you installed Python on a
> remote machine that you can only connect to via SSH._
>
## Connect to JupyterLab running on a remote machine
_This will show how to connect to Jupyterlab if your web browser cannot
directly access its address._
>
> _This will show how to connect to Jupyterlab if your web browser cannot
> directly access its address._
>
### Start Jupyterlab on a remote machine
......@@ -165,8 +173,10 @@ chromium to use this socket as aproxy server. (The next step provides a script
that bundles this and handles a few caveats like isolating the tunneled browser
session from your other activities on the internet.)
_Note that instead of `54321`, we could have used any free non-privileged (number
between 1024 and 65535) port._
>
> _Note that instead of `54321`, we could have used any free non-privileged (number
> between 1024 and 65535) port._
>
### Wrapped in a script
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment