Skip to content

Commit bbfde05

Browse files
committed
Made local Codacy analysis happy
1 parent 2651d39 commit bbfde05

File tree

1 file changed

+37
-22
lines changed

1 file changed

+37
-22
lines changed

_episodes/02-installation.md

Lines changed: 37 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -29,47 +29,43 @@ ESMValTool is distributed using [Conda](https://conda.io/). We will be using the
2929

3030
### Linux
3131

32-
1. Please download Miniconda3 for Linux at [the miniconda page](https://docs.conda.io/en/latest/miniconda.html). The 64 bit version should work on any recent system. If you have problems in the next step(s) you can alternatively try a 32 bit version.
32+
1. Please download Miniconda3 for Linux at [the miniconda page](https://docs.conda.io/en/latest/miniconda.html). The 64 bit version should work on any recent system. If you have problems in the next step(s) you can alternatively try a 32 bit version.
3333

34-
2. Next, run the installer
34+
1. Next, run the installer
3535

36-
~~~
36+
```bash
3737
bash Miniconda3-latest-Linux-x86_64.sh
38-
~~~
39-
{:.language-bash}
38+
```
4039

41-
3. Follow the instructions in the installer. The defaults should normally suffice.
40+
1. Follow the instructions in the installer. The defaults should normally suffice.
4241

43-
4. You will need to restart your terminal for the changes to have effect.
42+
1. You will need to restart your terminal for the changes to have effect.
4443

45-
5. Verify you have a working conda installation by listing all installed packages
44+
1. Verify you have a working conda installation by listing all installed packages
4645

47-
~~~
46+
```bash
4847
conda list
49-
~~~
50-
{:.language-bash}
48+
```
5149

5250
### MacOSX
5351

54-
1. Please download Miniconda3 for MacOSX at [the miniconda page](https://docs.conda.io/en/latest/miniconda.html).
52+
1. Please download Miniconda3 for MacOSX at [the miniconda page](https://docs.conda.io/en/latest/miniconda.html).
5553

56-
2. Next, run the installer
54+
1. Next, run the installer
5755

58-
~~~
56+
```bash
5957
bash Miniconda3-latest-MacOSX-x86_64.sh
60-
~~~
61-
{:.language-bash}
58+
```
6259

63-
3. Follow the instructions in the installer. The defaults should normally suffice.
60+
1. Follow the instructions in the installer. The defaults should normally suffice.
6461

65-
4. You will need to restart your terminal for the changes to have effect.
62+
1. You will need to restart your terminal for the changes to have effect.
6663

67-
5. Verify you have a working conda installation by listing all installed packages
64+
1. Verify you have a working conda installation by listing all installed packages
6865

69-
~~~
66+
```bash
7067
conda list
71-
~~~
72-
{:.language-bash}
68+
````
7369
7470
### Windows
7571
@@ -85,63 +81,82 @@ Complete instructions for installing Julia can be found on the
8581
[Julia installation page](https://julialang.org/downloads/platform/#linux_and_freebsd).
8682
In this tutorial, we will use the following steps.
8783
First, open a bash terminal and create a directory to install Julia in
84+
8885
```bash
8986
mkdir ~/julia
9087
```
88+
9189
Next, download the file
9290
[`julia-1.0.5-linux-x86_64.tar.gz`](https://julialang-s3.julialang.org/bin/linux/x64/1.0/julia-1.0.5-linux-x86_64.tar.gz)
9391
by clicking the link or going to the [Julia downloads page](https://julialang.org/downloads/).
9492
To extract the file, you can use the following command:
93+
9594
```bash
9695
tar -xvzf ~/Downloads/julia-1.0.5-linux-x86\_64.tar.gz -C ~/julia
9796
```
97+
9898
This will extract the files to a folder named `~/julia/julia-1.0.5`.
9999
To run Julia, you need to add the full path of Julia's `bin` folder to PATH environment variable.
100100
To do this, you can edit the `~/.bashrc` (or `~/.bash_profile`) file.
101101
Open the file in your favorite editor and add a new line as follows at the bottom of the file:
102+
102103
```bash
103104
export PATH="$PATH:$HOME/julia/julia-1.0.5/bin"
104105
```
106+
105107
Finally, for the settings to take effect, either reload your bash profile
108+
106109
```bash
107110
source ~/.bashrc
108111
```
112+
109113
(or `source ~/.bash_profile`), or close the bash terminal window and open a new one.
110114
111115
To check that the Julia executable can be found, run
116+
112117
```bash
113118
which julia
114119
```
120+
115121
to display the path to the Julia executable, it should be `~/julia/julia-1.0.5/bin/julia`.
116122
To test that Julia is installed correctly, run
123+
117124
```bash
118125
julia
119126
```
127+
120128
to start the interactive Julia interpreter. Press `Ctrl+D` to exit.
121129
122130
## Install the ESMValTool package
123131
124132
To install the ESMValTool package, run
133+
125134
```bash
126135
conda create -n esmvaltool -c conda-forge -c esmvalgroup esmvaltool
127136
```
137+
128138
This will create a new
129139
[Conda environment](https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html)
130140
called `esmvaltool`, with the ESMValTool package and all of its dependencies installed in it.
131141
132142
## Test that the installation was successful
133143
134144
To test that the installation was successful, run
145+
135146
```bash
136147
conda activate esmvaltool
137148
```
149+
138150
to activate the conda environment called `esmvaltool`.
139151
Next, run
152+
140153
```bash
141154
esmvaltool --help
142155
```
156+
143157
to display the command line help.
144158
To find the location where the ESMValTool package was installed on your system, run
159+
145160
```bash
146161
python -c 'import esmvaltool; print(esmvaltool.__path__[0])'
147162
```

0 commit comments

Comments
 (0)