From 45cddc448475eef606193d1e7bc0f78a9ea65625 Mon Sep 17 00:00:00 2001
From: Michele Nottoli <michele.nottoli@gmail.com>
Date: Tue, 10 Oct 2023 14:43:17 +0200
Subject: [PATCH] Bilingual README.md.

---
 README.md | 44 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/README.md b/README.md
index fc2ac00..1e4b6b1 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,49 @@
 # Julia-seminar
 
+Material für den Julia-Seminar-Kurs.
+Das Kursmaterial wurde aus zwei Quellen angepasst:
+  - der [Kurs](https://github.com/mfherbst/2022-rwth-julia-workshop.git) von Michael Herbst ([MIT Lizenz](https://opensource.org/licenses/mit/)).
+  - das Buch [ThinkJulia](https://benlauwens.github.io/ThinkJulia.jl/latest/book.html) von Allen Downey und Ben Lauwens ([Creative Commons Namensnennung-Nicht-kommerziell 3.0 Unported Lizenz](https://creativecommons.org/licenses/by-nc/3.0/deed.de)).
+
+## Software und Material
+Der Kurs erfordert verschiedene Dinge: eine funktionierende Installation von [Julia 1.9](https://julialang.org/downloads/), [Jupyter](https://jupyter.org/), [IJulia.jl](https://github.com/JuliaLang/IJulia.jl), das Kursmaterial und verschiedene Abhängigkeiten. Um alles zu bekommen, befolgen Sie diese Schritte:
+
+### 1) Julia herunterladen
+Um dem Kurs zu folgen, benötigst du **Julia 1.9**.
+Julia kann leicht in binärer Form von den [Julia-Downloads](https://julialang.org/downloads/) bezogen werden.
+
+### 2) Alles andere herunterladen
+
+Um die verbleibenden Dateien und Abhängigkeiten zu erhalten, starte `julia` und kopiere im resultierenden REPL-Shell folgenden Code:
+```julia
+import Downloads
+script = Downloads.download("https://gitlab.mathematik.uni-stuttgart.de/stammbn/julia-seminar/-/raw/main/install.jl?ref_type=heads")
+include(script)
+```
+Das [lädt das install.jl-Skript herunter](https://gitlab.mathematik.uni-stuttgart.de/stammbn/julia-seminar/-/raw/main/install.jl?ref_type=heads) und führt es in Julia aus.
+
+### 2) Den Rest bekommen (Experten-Version)
+
+Als Alternative können Sie auch die folgenden Befehle manuell ausführen (dies setzt voraus, dass `git` und `julia` von der Kommandozeile aus verfügbar sind):
+```
+git clone https://gitlab.mathematik.uni-stuttgart.de/stammbn/Julia-seminar/
+cd Julia-seminar
+julia install-manual.jl
+```
+
+### 3) Starten des Notebooks
+Um das Notebook zu starten, stellen Sie sicher, dass Sie sich im Ordner `Julia-seminar` befinden, und führen Sie dann `julia` aus: Eine interaktive Julia-Befehlszeile wird geöffnet. Führen Sie darin folgenden Befehl aus:
+
+```
+using IJulia; notebook(dir=pwd())
+```
+und das Notebook wird automatisch im Browser geöffnet.
+
+### Fehlerbehebung
+Wenn Sie auf Probleme stoßen, werfen Sie einen Blick auf den [ausgezeichneten Problembehandlungsabschnitt](https://carstenbauer.github.io/WorkshopWizard.jl/dev/troubleshooting/) aus dem WorkshopWizard-Paket von Carsten Bauer (das von `install.jl` verwendet wird).
+
+# Julia-seminar
+
 Material for the Julia seminar course.
 The course material is adapted from two sources:
   - the [course](https://github.com/mfherbst/2022-rwth-julia-workshop.git) from Michael Herbst ([MIT license](https://opensource.org/license/mit/)).
-- 
GitLab