Commit e0eb0e1c authored by Willi Rath's avatar Willi Rath

Highlight notes using block quotes

parent fbb028ae
# How to work with JupyterLab everywhere # 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 > _This guide **will** walk you through the complete setup of JupyterLab and
or on a remote machine._ > 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 > _This guild **will not** explain how to use the shell, how to connect to
networks, e.g., via VPN._ > 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 ## 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 > _This will show how to download the installer, install a minimal Python
where the calculation should be performed (e.g., your local computer or a > environment, and start JupyerLab. Execute the steps below on the computer
computer in a remote computing centre)._ > where the calculation should be performed (e.g., your local computer or a
> computer in a remote computing centre)._
>
### Download and install Miniconda3 ### 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 To download the latest installer
...@@ -82,22 +92,20 @@ Copy/paste this URL into your browser when you connect for the first time, ...@@ -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. 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 > _**Note** that at this point, you only have a minimal Python 3 installation with
or more environments with a selection of scientific software._ > 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 ## 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 ### Add a scientific environment
...@@ -112,8 +120,10 @@ Python 3, `numpy`, `matplotlib`, `scipy`): ...@@ -112,8 +120,10 @@ Python 3, `numpy`, `matplotlib`, `scipy`):
conda create -n py3_std python=3 numpy matplotlib scipy ipykernel 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 ### Use the environment in JupyterLab
...@@ -122,24 +132,22 @@ Above, we created a new environment `py3_std`. To use it, activate the `base` ...@@ -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 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.
--- >
--- > _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
_At this point, you know how to set up a full Python installation including a > computing environments that can be used in real scientific analyses. The
JupyterLab front end in the `base` environment and one or more scientific > instructions above work on any local or remote Linux / Unix or MacOSX machine.
computing environments that can be used in real scientific analyses. The > Below, you'll learn how to connect to JupyterLab if you installed Python on a
instructions above work on any local or remote Linux / Unix or MacOSX machine. > remote machine that you can only connect to via SSH._
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 ## 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 ### Start Jupyterlab on a remote machine
...@@ -165,8 +173,10 @@ chromium to use this socket as aproxy server. (The next step provides a script ...@@ -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 that bundles this and handles a few caveats like isolating the tunneled browser
session from your other activities on the internet.) 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 ### 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