mo8it/Julia_Course
1
0
Fork 0
mirror of https://gitlab.rlp.net/mobitar/julia_course.git synced 2024-11-23 13:31:36 +00:00
Code Issues Releases Activity

Update README

Browse source
This commit is contained in:
Mo 2023-02-05 13:39:22 +01:00
parent d075e178d3
commit 2f16a8bd6c
1 changed files with 31 additions and 28 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

59
README.adoc → README.md
View file

@ -1,46 +1,48 @@
= Julia course - 28.03.-01.04.2022 # Julia course - 20.03.-24.03.2023
:source-highlighter: highlight.js
:highlight-languages: julia
== Installation ## Installation
First, download Julia from the official website: https://julialang.org/downloads/.
First, download Julia from the official website: https://julialang.org/downloads
### Linux
=== 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`). 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`. In case you download the binary, add it to your `PATH`. The easiest way would be to move the binary to `~/.local/bin`.
=== Windows ### Windows
Follow the instructions of the installer and make sure that you choose the option to add Julia to your `PATH`.
Follow the instructions of the installer and make sure that you **choose the option to add Julia to your `PATH`**.
### macOS
=== macOS
Check the installation instructions on the official Julia website. Check the installation instructions on the official Julia website.
== Running Pluto for the first time ## Running Pluto for the first time
Clone the repository to get the course files. Clone the repository to get the course files.
Then `cd` into the repository directory. Then `cd` into the repository directory.
Now, launch Julia to be welcomed by the REPL. Now, launch Julia to be welcomed by the [REPL](https://docs.julialang.org/en/v1/stdlib/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. [Pluto](https://github.com/fonsp/Pluto.jl) 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: In the REPL, press `]`. This will cause the prompt to change to a one ending with `pkg>`. Now run the following:
[source] ```
----
activate . activate .
---- ```
NOTE: Don't forget the point after `activate`! The point means that you want to activate the environment in the current path. Don't forget the **dot** after `activate`! The dot means that you want to activate the environment in the _current_ path.
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. 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: Now, run the following:
[source] ```
----
update update
---- ```
This will install the Pluto package (or it will update it if it is already installed). This will install the Pluto package (or it will update it if it is already installed).
@ -48,20 +50,21 @@ After the installation is done, press backspace to get back to the normal prompt
Now, run the following: Now, run the following:
[source,julia] ```julia
----
import Pluto import Pluto
Pluto.run() Pluto.run()
---- ```
A new tab will open in your browser where you can then open one of the notebooks. A new tab will open in your browser where you can then open one of the notebooks.
== Running Pluto after the first time ## 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 cloning the repository because you already have the notebooks. 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 cloning the repository because you already have the notebooks.
== Credits ## Credits
Some of the used content and tasks are inspired from the following repositories:
* https://gitlab.rlp.net/Python/2021ss-cidw Some of the used content and tasks are inspired by the following repositories:
* https://gitlab.rlp.net/dbrielbe/python_ferienkurs
* https://gitlab.rlp.net/pgp/pgp1-python-einfuehrung - https://gitlab.rlp.net/Python/2021ss-cidw
- https://gitlab.rlp.net/dbrielbe/python_ferienkurs
- https://gitlab.rlp.net/pgp/pgp1-python-einfuehrung