Skip to content

Commit 1aa5a56

Browse files
authored
Use ordered list for local setup (#9)
1 parent 7c1cd39 commit 1aa5a56

File tree

1 file changed

+37
-34
lines changed

1 file changed

+37
-34
lines changed

README.md

Lines changed: 37 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -14,53 +14,56 @@ This is helpful if you can't access mybinder.org, or if you want to
1414

1515
## Local setup
1616

17-
To run the tutorial locally, first clone this repository to your local machine.
18-
For example:
17+
Follow these steps to run the tutorial notebooks on your local machine:
1918

20-
```bash
21-
git clone [email protected]:bokeh/tutorial.git
22-
```
19+
1. To run the tutorial locally, first **clone** this repository to your local machine.
20+
For example:
2321

24-
After cloning the repository, enter the folder that contains the repository contents:
22+
```bash
23+
git clone [email protected]:bokeh/tutorial.git
24+
```
2525

26-
```bash
27-
cd tutorial
28-
```
26+
2. After cloning the repository, **enter the folder** that contains the repository contents:
2927

30-
Next, you need to set up your environment. This tutorial uses the `conda` package
31-
manager.
32-
Please make sure
33-
[conda or Miniconda are installed and configured correctly](https://docs.conda.io/projects/conda/en/stable/)
34-
on your system.
28+
```bash
29+
cd tutorial
30+
```
3531

36-
Run the following command inside your local repository folder to create your environment:
32+
3. Next, you need to **set up your environment**. This tutorial uses the `conda` package
33+
manager.
34+
Please make sure
35+
[conda or Miniconda are installed and configured correctly](https://docs.conda.io/projects/conda/en/stable/)
36+
on your system.
3737

38-
```bash
39-
conda env create -f environment.yml
40-
```
38+
Run the following command inside your local repository folder to create your environment:
4139

42-
After the environment is set up, activate it with the following command:
40+
```bash
41+
conda env create -f environment.yml
42+
```
4343

44-
```bash
45-
conda activate bk-tutorial
46-
```
44+
4. After the environment is set up, **activate** it with the following command:
4745

48-
Before opening the tutorial notebooks, you need to install the Bokeh sampledata.
49-
Make sure the ``bk-tutorial`` environment is activated, then run the following command:
46+
```bash
47+
conda activate bk-tutorial
48+
```
5049

51-
```bash
52-
bokeh sampledata
53-
```
50+
5. Before opening the tutorial notebooks, you need to **install the Bokeh sampledata**.
51+
Make sure the ``bk-tutorial`` environment is activated, then run the following command:
5452

55-
From inside the ``bk-tutorial`` environment, you can now start the Jupyter notebook
56-
server:
53+
```bash
54+
bokeh sampledata
55+
```
5756

58-
```bash
59-
jupyter notebook
60-
```
57+
6. From inside the ``bk-tutorial`` environment, you can now **start the Jupyter
58+
notebook server**:
59+
60+
```bash
61+
jupyter notebook
62+
```
6163

62-
After opening Jupyter notebooks in a browser, go to the folder `notebooks`.
63-
Open the first notebook in this folder. It is called `01_introduction.ipynb`.
64+
7. After opening Jupyter notebooks in a browser, go to the folder `notebooks`.
65+
**Open the first notebook in this folder**. It is called
66+
`01_introduction.ipynb`.
6467

6568
## Contributing to this tutorial
6669

0 commit comments

Comments
 (0)