Julia_Course/README.adoc

= Julia course - 28.03.-01.04.2022
:source-highlighter: highlight.js
:highlight-languages: julia

== Installation
First, download Julia from the official website: https://julialang.org/downloads/.

=== Linux
You can either download the binary from the website above or install Julia with a package manager if it provides an up to date package (usually named `julia`).
In case you download the binary, add it to your `PATH`. The easiest way would be to move the binary to `~/.local/bin`.

=== Windows
Follow the instructions of the installer and make sure that you choose the option to add Julia to your `PATH`.

=== macOS
Check the installation instructions on the official Julia website.

== Running Pluto for the first time
Clone the repository to get the course files.

Then `cd` into the repository directory.

Now, launch Julia to be welcomed by the REPL.

https://github.com/fonsp/Pluto.jl[Pluto] has to be installed to be able to view, edit and run the notebooks of this course.

In the REPL, press `]`. This will cause the prompt to change to a one ending with `pkg>`. Now run the following:

[source]
----
activate .
----

This will activate the environment of the Julia course. This environment includes only the Pluto package. Your prompt should now change from something like `(v1.8) pkg>` to `(julia_course) pkg>`. This means that the environment was successfully activated.

Now, run the following:

[source]
----
update
----

This will install the Pluto package (or it will update it if it is already installed).

After the installation is done, press backspace to get back to the normal prompt ending with `julia>`.

Now, run the following:

[source,julia]
----
import Pluto
Pluto.run()
----

A new tab will open in your browser where you can then open one of the notebooks.

== Running Pluto after the first time
If you want to run Pluto and see the notebooks after the first time, you should follow all the instructions in the section above except cloing the repository because you already have the notebooks.