From 41ca169ef656c3a0677f4c447253e70df3c6c94b Mon Sep 17 00:00:00 2001
From: Benjamin Stamm <stamm@nmh10.mathematik.uni-stuttgart.de>
Date: Fri, 13 Oct 2023 15:02:12 +0200
Subject: [PATCH] corrected a few German-related issues in worksheet 0
---
0_Installation.ipynb | 158 ++-----------------------------------------
1 file changed, 5 insertions(+), 153 deletions(-)
diff --git a/0_Installation.ipynb b/0_Installation.ipynb
index 28b722c..019d080 100644
--- a/0_Installation.ipynb
+++ b/0_Installation.ipynb
@@ -5,7 +5,8 @@
"id": "16b28ead",
"metadata": {},
"source": [
- "# Installation and Setup"
+ "# Installation and Setup\n",
+ "Please follow the steps 1-3 outlined in README.md to download and install Julia, and to open the notebook 0_Installation.ipynb in a Jupyter notebook. "
]
},
{
@@ -13,157 +14,8 @@
"id": "31ac33c0-18a9-4cfa-8e04-3ee1a0c909eb",
"metadata": {},
"source": [
- "# Installation und Einrichtung"
- ]
- },
- {
- "cell_type": "markdown",
- "id": "8829affd",
- "metadata": {},
- "source": [
- "## Software and material\n",
- "The course requires various things: a working installation of [Julia 1.9](https://julialang.org/downloads/), [Jupyter](https://jupyter.org/), [IJulia.jl](https://github.com/JuliaLang/IJulia.jl), the course material and various dependencies. To get everything follow these steps:\n",
- "\n",
- "### 1) Getting Julia\n",
- "For following the course you will need **Julia 1.9**.\n",
- "Julia can be easily obtained in binary form from [Julia downloads](https://julialang.org/downloads/).\n",
- "\n",
- "### 2) Getting all the rests\n",
- "\n",
- "To get the remaining files and dependencies start up `julia` and in the resulting REPL shell, copy and paste the following:\n",
- "```julia\n",
- "import Downloads\n",
- "script = Downloads.download(\"https://gitlab.mathematik.uni-stuttgart.de/stammbn/julia-seminar/-/raw/main/install.jl?ref_type=heads\")\n",
- "include(script)\n",
- "```\n",
- "This [downloads the install.jl script](https://gitlab.mathematik.uni-stuttgart.de/stammbn/julia-seminar/-/raw/main/install.jl?ref_type=heads) and runs it from julia.\n",
- "\n",
- "### 2) Getting all the rest (expert version)\n",
- "\n",
- "As an alternative you can also also run the following commands manually (this requires to have `git` and `julia` available from the commandline): \n",
- "```\n",
- "git clone https://gitlab.mathematik.uni-stuttgart.de/stammbn/Julia-seminar/\n",
- "cd Julia-seminar\n",
- "julia install-manual.jl\n",
- "```\n",
- "\n",
- "### 3) Starting the notebook\n",
- "\n",
- "#### From Julia REPL\n",
- "\n",
- "To start the notebook make sure to be in the folder `Julia-seminar` and then run `julia`: an interactive Julia command line will open. In there run this command\n",
- "\n",
- "```julia\n",
- "using Pkg\n",
- "Pkg.activate(pwd())\n",
- "using IJulia\n",
- "notebook(dir=pwd())\n",
- "```\n",
- "\n",
- "and the notebook will automatically open in a browser.\n",
- "Navigate the files and open notebook number 0.\n",
- "\n",
- "#### From command line\n",
- "\n",
- "Alternatively, one can open the notebook from the command line:\n",
- "\n",
- "```bash\n",
- "julia -L start_notebook.jl\n",
- "```\n",
- "\n",
- "### \\* For users with multiple Julia versions\n",
- "\n",
- "For users with multiple Julia versions, if the corresponding kernel cannot be found in Jupyter Notebook, please run `installkernel(\"julia\", \"--project=@.\")` (only once) before executing `notebook(dir=pwd())` to first install the kernel:\n",
- "\n",
- "```julia\n",
- "using Pkg\n",
- "Pkg.activate(pwd())\n",
- "using IJulia\n",
- "installkernel(\"julia\", \"--project=@.\")\n",
- "notebook(dir=pwd())\n",
- "```\n",
- "\n",
- "Now, one should find a new kernel related to the current Julia version, named `julia \"Julia-version\"`, in Jupyter Notebook.\n",
- "\n",
- "\n",
- "### Troubleshooting\n",
- "If you are facing issues, check out\n",
- "the [great troubleshooting section](https://carstenbauer.github.io/WorkshopWizard.jl/dev/troubleshooting/)\n",
- "from the WorkshopWizard package by Carsten Bauer (which is being used by `install.jl`)."
- ]
- },
- {
- "cell_type": "markdown",
- "id": "b495d658-ab7a-41fb-819e-0fef02c10772",
- "metadata": {},
- "source": [
- "## Software und Material\n",
- "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 herunterzuladen und zu installieren, befolgst Du diese Schritte:\n",
- "\n",
- "### 1) Julia herunterladen\n",
- "Um dem Kurs zu folgen, benötigst du **Julia 1.9**.\n",
- "Julia kann leicht in binärer Form von den [Julia-Downloads](https://julialang.org/downloads/) bezogen werden.\n",
- "\n",
- "### 2) Alles andere\n",
- "\n",
- "Um die verbleibenden Dateien und Abhängigkeiten zu erhalten, starte `julia` und kopiere im resultierenden REPL-Shell folgenden Code:\n",
- "```julia\n",
- "import Downloads\n",
- "script = Downloads.download(\"https://gitlab.mathematik.uni-stuttgart.de/stammbn/julia-seminar/-/raw/main/install.jl?ref_type=heads\")\n",
- "include(script)\n",
- "```\n",
- "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.\n",
- "\n",
- "### 2) Alles andere (Experten-Version)\n",
- "\n",
- "Als Alternative kannst Du auch die folgenden Befehle manuell ausführen (dies setzt voraus, dass `git` und `julia` von der Kommandozeile aus verfügbar sind):\n",
- "```\n",
- "git clone https://gitlab.mathematik.uni-stuttgart.de/stammbn/Julia-seminar/\n",
- "cd Julia-seminar\n",
- "julia install-manual.jl\n",
- "```\n",
- "\n",
- "### 3) Das Notebook starten\n",
- "\n",
- "#### Aus der Julia REPL\n",
- "\n",
- "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 den folgenden Befehl aus:\n",
- "\n",
- "```julia\n",
- "using Pkg\n",
- "Pkg.activate(pwd())\n",
- "using IJulia\n",
- "notebook(dir=pwd())\n",
- "```\n",
- "\n",
- "und das Notebook wird automatisch in einem Browser geöffnet.\n",
- "Navigieren Sie zu den Dateien und öffnen Sie das Notebook Nummer 0.\n",
- "\n",
- "#### Über die Befehlszeile\n",
- "\n",
- "Alternativ kann man das Notebook auch über die Befehlszeile öffnen:\n",
- "\n",
- "\n",
- "```bash\n",
- "julia -L start_notebook.jl\n",
- "```\n",
- "\n",
- "### \\* Für Benutzer mit mehreren Julia-Versionen\n",
- "\n",
- "Für Benutzer mit mehreren Julia-Versionen, falls der entsprechende Kernel in Jupyter Notebook nicht gefunden werden kann, führen Sie bitte `installkernel(\"julia\", \"--project=@.\")` (nur einmal) aus, bevor Sie `notebook(dir=pwd())` ausführen, um zuerst den Kernel zu installieren:\n",
- "\n",
- "```julia\n",
- "using Pkg\n",
- "Pkg.activate(pwd())\n",
- "using IJulia\n",
- "installkernel(\"julia\", \"--project=@.\")\n",
- "notebook(dir=pwd())\n",
- "```\n",
- "\n",
- "Nun sollte man in Jupyter Notebook einen neuen Kernel finden, der mit der aktuellen Julia-Version verknüpft ist und den Namen `julia \"Julia-Version\"` trägt.\n",
- "\n",
- "### Fehlerbehebung\n",
- "Wenn Du auf Probleme stößt, werfe 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)."
+ "# Installation und Einrichtung\n",
+ "Bitte befolge die in README.md beschriebenen Schritte 1-3, um Julia herunterzuladen und zu installieren, und das Notebook 0_Installation.ipynb in einen Jupyter-notebook zu öffnen."
]
},
{
@@ -284,7 +136,7 @@
"\n",
"Schließlich können neue Zellen hinzugefügt werden, indem Du das `+`-Symbol im oberen Menü verwendest.\n",
"\n",
- "Jedes Mal, wenn eine Übung für den Leser übrig bleibt, haben wir eine leere Code-Zelle hinzugefügt."
+ "Jedes Mal, wenn es eine Übung für den Leser gibt, haben wir eine leere Code-Zelle hinzugefügt."
]
},
{
--
GitLab