From 7248f349f86eaa1a667d146465dfdce4e56d3c6f Mon Sep 17 00:00:00 2001 From: chrbeckm Date: Wed, 23 Aug 2023 21:15:56 +0200 Subject: [PATCH 1/8] You can say you to me Changing of the wording in linux and macos installation notes, not in the Python part as for #230 --- install/linux.md | 35 ++++++++++++++++++++-------------- install/macos.md | 49 ++++++++++++++++++++++++++++++------------------ 2 files changed, 52 insertions(+), 32 deletions(-) diff --git a/install/linux.md b/install/linux.md index 84c75ee1..5fae972c 100644 --- a/install/linux.md +++ b/install/linux.md @@ -5,10 +5,12 @@ title: Linux-Installation __Es müssen alle Schritte (Installieren, Testen, Aktualisieren) ausgeführt werden!__ -Falls man nicht am LaTeX-Kurs teilnimmt, ist TeXLive optional. -Dann kann man allerdings kein TeX in matplotlib benutzen (führt zu weniger schönen Plots). +Falls du nicht am LaTeX-Kurs teilnimmst, ist TeXLive optional. +Dann kannst du allerdings kein TeX in matplotlib benutzen (führt zu weniger schönen Plots). -Falls man nur am LaTeX-Kurs teilnehmen will, sollte man mindestens Visual Studio Codium (oder einen anderen Texteditor) und TeXLive installieren. +Falls du nur am LaTeX-Kurs teilnehmen willst, +solltest du mindestens Visual Studio Codium (oder einen anderen Texteditor) +und TeXLive installieren.
@@ -29,12 +31,13 @@ Falls man nur am LaTeX-Kurs teilnehmen will, sollte man mindestens Visual Studio ## Installation -**Wichtig: Befehle die ins Terminal eingegeben werden sollen, starten mit $. Befehle Zeile für Zeile eingeben und mit Enter bestätigen.** +**Wichtig: Befehle, die ins Terminal eingegeben werden sollen, starten mit $. Befehle Zeile für Zeile eingeben, ohne das $-Zeichen, und mit Enter bestätigen.** Es werden die Installationsschritte für die verbreitetsten Distributionen angegeben. -Man muss immer nur die Befehle für die jeweils eigene Distribution (z.B. Ubuntu) ausführen. +Führe nur die Befehle für deine eigene Distribution (z.B. Ubuntu) aus. -Der `sudo` Befehl verleiht weitreichende Administratorrechte, jede Eingabe mit einem `sudo` Befehl sollte penibel geprüft werden. +Der `sudo` Befehl verleiht weitreichende Administratorrechte, +jede Eingabe mit einem `sudo` Befehl muss penibel geprüft werden. ### Git, Make, curl @@ -60,20 +63,24 @@ Lizenz und enthalten Tracking Software. Deswegen nutzen wir VSCodium. - Debian, Ubuntu, Mint: - Ladet die Datei `codium__amd64.deb` von herunter und öffnet sie mit - dem Software Center (Doppelklick auf den Download). Klickt auf `Installieren`. + Lade die Datei `codium__amd64.deb` von + herunter und öffne sie mit + dem Software-Center (Doppelklick auf den Download). Klicke auf `Installieren`. - Fedora - Ladet die Datei `codium__el7.x86_64.rpm` von herunter und öffnet sie mit - dem Software Center (Doppelklick auf den Download). Klickt auf `Installieren`. + Lade die Datei `codium__el7.x86_64.rpm` von + herunter und öffne sie mit + dem Software-Center (Doppelklick auf den Download). Klicke auf `Installieren`. - Arch Linux $ sudo pacman -S code -Startet VS Code nach der Installation, klickt in der linken Leiste auf `Extensions` (Unterstes Symbol) und sucht nach „LaTeX Language Support“, installiert die Extension mit einem Klick auf den `install` Knopf. +Starte VS Codium nach der Installation, klicke in der linken Leiste auf +`Extensions` (Unterstes Symbol) und suche nach „TexLab LSP Client“, +installiere die Extension mit einem Klick auf den `install` Knopf. ### Anaconda @@ -125,14 +132,14 @@ $ TEXLIVE_INSTALL_PREFIX=~/.local/texlive ./install-tl-*/install-tl Die Installation startet man mit `I` und `Enter`. Nach der Installation muss dem System mitgeteilt werden, wo LaTeX installiert wurde, -das machen wir in der Datei `~/.bashrc`. +das passiert in der Datei `~/.bashrc`. Führe dazu folgenden Befehl im Terminal aus: ``` -$ echo 'export PATH="$HOME/.local/texlive/2022/bin/x86_64-linux:$PATH"' >> ~/.bashrc +$ echo 'export PATH="$HOME/.local/texlive/2023/bin/x86_64-linux:$PATH"' >> ~/.bashrc ``` -Jetzt einmal das Terminal schließen und für die weiteren Schritte ein neues öffnen. +Jetzt einmal das Terminal schließen und für die weiteren Schritte ein Neues öffnen. In dem neuen Terminal die folgenden Befehle eingeben: ``` diff --git a/install/macos.md b/install/macos.md index 10a87955..378ccfe9 100644 --- a/install/macos.md +++ b/install/macos.md @@ -4,15 +4,18 @@ title: macOS-Installation --- -Wir empfehlen die Installation einer 64-bit Version, falls man ein 64-bit Betriebssystem benutzt. -Wenn man sich nicht sicher ist, hat man heutzutage fast immer 64-bit. +Wir empfehlen die Installation einer 64-bit Version, +wenn du ein 64-bit Betriebssystem benutzt. +Wenn du dir nicht sicher bist, heutzutage ist fast jedes System 64-bit. __Es müssen alle Schritte (Installieren, Testen, Aktualisieren) ausgeführt werden!__ -Falls man nicht am LaTeX-Kurs teilnimmt, ist MacTeX optional. -Dann kann man allerdings kein TeX in matplotlib benutzen (führt zu weniger schönen Plots). +Falls du nicht am LaTeX-Kurs teilnimmst, ist MacTeX optional. +Dann kannst du allerdings kein TeX in matplotlib benutzen (führt zu weniger schönen Plots). -Falls man nur am LaTeX-Kurs teilnehmen will, sollte man mindestens VS Codium (oder einen anderen Texteditor) und MacTeX installieren. +Falls du nur am LaTeX-Kurs teilnehmen willst, +solltest du mindestens VS Codium (oder einen anderen Texteditor) +und MacTeX installieren.
@@ -43,27 +46,27 @@ Falls man nur am LaTeX-Kurs teilnehmen will, sollte man mindestens VS Codium (od ### Command Line Tools Die command line tools beinhalten unter anderem Git und einen C/C++ Compiler. -Zur Installation folgendes im Terminal eingeben +Zur Installation gibst du Folgendes im Terminal ein ```bash xcode-select --install ``` +und führst den Befehl mit `Enter` aus. Danach "Installieren" auswählen und warten. Der Download wiegt etwa 130 MB. -### Anaconda - -- [Anaconda](https://www.anaconda.com/products/individual#Downloads): Python und - Bibliotheken -__Wichtig__: Wir wollen Python 3.9 Graphical Installer (unten auf der Seite). Das Paket installieren. -Wenn der Laptop/Rechner einen M1-Chip hat muss der `64-bit (M1) Graphical Installer` heruntergeladen werden. ### Texteditor VSCodium - [VSCodium](https://github.com/VSCodium/vscodium/releases). Lade die neuste Version der Datei `VsCodium-darwin-.zip` herunter. -- Das Programm "VSCodium.app" befindet sich dann in der ZIP-Datei im Downloadordner und muss nach `Programme` verschoben werden. -- Die App öffnen. Bei neueren macOS Versionen verhindert macOS eventuell den Start und man muss zunächst in den Systemeinstellungen unter "Allgemein" und "Sicherheit" auf den "Dennoch öffen" Button klicken. -- In VSCodium mit `Shift+cmd+p` die Kommando-Palette öffnen und `Shell Command: Install 'code' command in PATH` ausführen. Nun wird VS Code auch geöffnet, wenn im Terminal `codium` eingeben wird. +- Das Programm "VSCodium.app" befindet sich dann in der ZIP-Datei im Downloadordner + und muss nach `Programme` verschoben werden. +- Die App öffnen. Bei neueren macOS Versionen verhindert macOS eventuell den Start + und du musst zunächst in den Systemeinstellungen unter "Allgemein" und "Sicherheit" + auf den "Dennoch öffen" Button klicken. +- In VSCodium mit `Shift+cmd+p` die Kommando-Palette öffnen und + `Shell Command: Install 'code' command in PATH` ausführen. + Nun wird VS Codium auch geöffnet, wenn im Terminal `codium` eingeben wird. Um git beizubringen, VSCodium zu benutzen, im Terminal: @@ -71,13 +74,23 @@ Um git beizubringen, VSCodium zu benutzen, im Terminal: git config --global core.editor "codium --wait" ``` -- Damit VS Code LaTeX-Code besser darstellen kann, muss das Plugin `LaTeX language support` - installiert werden +- Damit du besser in VS Codium LaTeX-Code schreiben kannst, + schlagen wir das Plugin `TexLab LSP Client` vor, + welches wie folgt installiert werden kann: - Mit `Shift+cmd+x` die Extensions öffnen - - `LaTeX language support` suchen + - `TexLab LSP Client` suchen - `install` anklicken - VS Code neu starten +### Anaconda + +- [Anaconda](https://www.anaconda.com/products/individual#Downloads): Python und + Bibliotheken + +__Wichtig__: Wir wollen Python 3.9 Graphical Installer (unten auf der Seite). Das Paket installieren. + +Wenn der Laptop/Rechner einen M1-Chip hat muss der `64-bit (M1) Graphical Installer` heruntergeladen werden. + ### Uncertainties - [Uncertainties](http://pythonhosted.org/uncertainties/): Python-Bibliothek From 78d50c46c5a5908631326062e453a4c68ed8cd46 Mon Sep 17 00:00:00 2001 From: chrbeckm Date: Wed, 23 Aug 2023 21:28:58 +0200 Subject: [PATCH 2/8] change to you in Dualboot --- install/dualboot.md | 118 +++++++++++++++++++++++++------------------- 1 file changed, 66 insertions(+), 52 deletions(-) diff --git a/install/dualboot.md b/install/dualboot.md index f56310f2..f195e8cf 100644 --- a/install/dualboot.md +++ b/install/dualboot.md @@ -5,7 +5,7 @@ title: Installation eines Dual-Boot-Systems Dual-Boot-System meint die Installation von zwei Betriebssystemen auf dem gleichen Rechner. Dies ist nützlich, wenn man auf beide Betriebssysteme angewiesen ist. -Man kann dann bei jedem Neustart auswählen, welches Betriebssystem gestartet werden soll. +Bei jedem Neustart wird ausgewählt, welches Betriebssystem gestartet werden soll. Es lassen sich auch Festplatten-Partitionen einrichten, auf die beide Betriebssysteme zugreifen können. @@ -19,16 +19,19 @@ Dies betrifft zum Beispiel: * Adobe Creative Suite (Photoshop, Lightroom, InDesign etc.) * Die Mehrheit der Computerspiele -Diese Anleitung geht davon aus, dass ihr Windows 10 bereits installiert habt. +Diese Anleitung geht davon aus, dass du Windows 10/11 bereits installierst hast. Bei der Installation eines Windows/Linux-Dual-Boot Systems muss Windows als erstes installiert werden. -Weiterhin geht diese Anleitung davon aus, dass euer Rechner [UEFI](https://en.wikipedia.org/wiki/Unified_Extensible_Firmware_Interface) -verwendet. +Weiterhin geht diese Anleitung davon aus, dass dein Rechner +[UEFI](https://en.wikipedia.org/wiki/Unified_Extensible_Firmware_Interface) verwendet. Dies sollte für alle modernen Rechner die Regel sein, es kann aber vorkommen, -das Windows um sogenannten *Legacy-BIOS* Modus installiert wurde, dann sollte Windows im UEFI Modus neu installiert werden. +das Windows um sogenannten *Legacy-BIOS* Modus installiert wurde, +dann sollte Windows im UEFI Modus neu installiert werden. -Falls ihr einfach nur Linux installieren wollt, könnt ihr der Anleitung ab [Schritt 6](#einen-bootfähigen-usb-stick-für-die-linux-installation-erstellen) folgen. +Falls ihr einfach nur Linux installieren wollt, +könnt ihr der Anleitung ab +[Schritt 6](#einen-bootfähigen-usb-stick-für-die-linux-installation-erstellen) folgen. ## Inhalt @@ -42,8 +45,8 @@ Falls ihr einfach nur Linux installieren wollt, könnt ihr der Anleitung ab [Sch Die Installation eines neuen Betriebssystems involviert die Erstellung und Formatierung neuer Partitionen, wenn etwas schiefgeht, können Daten verloren gehen. -Deshalb solltet ihr als Erstes ein vollständiges Backup eures Rechners machen, bevor -ihr weitermacht. +Deshalb solltest du als Erstes ein vollständiges Backup deines Rechners machen, +bevor du weitermachst. ## Sich für eine Linux-Distribution entscheiden @@ -54,15 +57,14 @@ Programme vorinstallieren. Hauptunterschiede sind die verwendete grafische Benutzeroberfläche und der Paketmanager. **Für Einsteiger empfehlen wir [Ubuntu](https://www.ubuntu.com/), [Xubuntu](https://xubuntu.org/) oder [Kubuntu](https://kubuntu.org/).** -Diese drei Distributionen nutzen das gleiche Betriebssystem, aber unterschiedliche grafische Benutzeroberflächen. +Diese drei Distributionen nutzen das gleiche Betriebssystem, +aber unterschiedliche grafische Benutzeroberflächen. - - - -Der aktuelle Release von (K,X)Ubuntu ist die Version `20.04`, es erscheinen halbjährlich -im April und Oktober neue Versionen. -Alle zwei Jahre erscheint eine neue Version mit längerem (5 Jahre) Support für Updates (LTS Version), 20.04 ist die aktuelle LTS Version. +Der aktuelle Release von (K,X)Ubuntu ist die Version `23.04`, +es erscheinen halbjährlich im April und Oktober neue Versionen. +Alle zwei Jahre erscheint eine neue Version mit längerem (5 Jahre) +Support für Updates (LTS Version), 22.04 ist die aktuelle LTS Version. Alternativen zu Ubuntu sind zum Beispiel (alphabetisch): @@ -79,49 +81,54 @@ Alternativen zu Ubuntu sind zum Beispiel (alphabetisch): Eine Linux Installation erfordert ca. 10 GB Speicherplatz, um wirklich gut damit arbeiten zu können, empfehlen wir mindestens 30 GB, besser 100 GB. -Um Linux auf die gleiche Festplatte wie Windows zu installieren, müsst ihr als -Erstes eine Partition auf dieser Festplatte verkleinern. +Um Linux auf die gleiche Festplatte wie Windows zu installieren, +musst du als Erstes eine Partition auf dieser Festplatte verkleinern. -Öffnet hierzu die Datenträgerverwaltung (`Rechtsklick aufs Startmenü → Datenträgerverwaltung`), -wählt eine Partition zum Verkleinern aus (zum Beispiel C:\\) mit `Rechtsklick → Volume verkleinern...`. +Öffne hierzu die Datenträgerverwaltung (`Rechtsklick aufs Startmenü → Datenträgerverwaltung`), +wähle eine Partition zum Verkleinern aus (zum Beispiel C:\\) mit `Rechtsklick → Volume verkleinern...`. -Nun wird es einen Moment dauern, währen geprüft wird, um viel die Partition verkleinert werden kann. -Tragt dann eine Zahl (in MB) ein, zum Beispiel 102400 für 100 GB. +Nun wird es einen Moment dauern, während geprüft wird, +um viel die Partition verkleinert werden kann. +Trage dann eine Zahl (in MB) ein, zum Beispiel 102400 für 100 GB. ## Mainboard-Uhr auf UTC stellen -Auf dem Mainboard des PCs wird die Uhrzeit gespeichert, Windows geht hier davon aus, das die lokale Uhrzeit gespeichert wird, Linux nimmt UTC an. -Wenn dies nicht geändert wird, stimmen die Uhrzeiten auf Windows und Linux nicht überein und können in beiden System falsch sein. +Auf dem Mainboard des PCs wird die Uhrzeit gespeichert, Windows geht hier davon aus, +dass die lokale Uhrzeit gespeichert wird, Linux nimmt UTC an. +Wenn dies nicht geändert wird, stimmen die Uhrzeiten auf Windows und Linux nicht überein +und können in beiden System falsch sein. Um Windows ebenfalls auf UTC umzustellen, muss die Registry bearbeitet werden. -1. Öffnet das Programm `regedit`, am einfachsten, indem ihr `regedit` tippt, -während das Startmenü offen ist. +1. Öffne das Programm `regedit`; am einfachsten, indem du `regedit` tippst, + während das Startmenü offen ist. -1. Navigiert auf der linken Seite zu `HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\TimeZoneInformation` +1. Navigiere auf der linken Seite zu + `HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\TimeZoneInformation` -1. Erstellt einen per `Rechtsklick → neu → DWORD` einen neuen Schlüssel mit dem Namen `RealTimeIsUniversal` -und setzt den Wert auf `1`. +1. Erstelle per `Rechtsklick → neu → DWORD` einen neuen Schlüssel mit dem Namen + `RealTimeIsUniversal` und setze den Wert auf `1`. ## Fast-Boot deaktivieren -Der Fast-Boot-Modus von Windows 10 cached Dateien, um beim nächsten Start schneller -betriebsbereit zu sein. -Dies verträgt sich aber nicht mit zwei Betriebssystemen, die auf die gleichen Dateisysteme zugreifen. +Der Fast-Boot-Modus von Windows 10 cached Dateien, +um beim nächsten Start schneller betriebsbereit zu sein. +Dies verträgt sich aber nicht mit zwei Betriebssystemen, +die auf die gleichen Dateisysteme zugreifen. `Rechtsklick auf Start → Energieoptionen → Auswählen was beim Drücken des Netzschalters geschehen soll` und dann das Häkchen bei Fast-Boot entfernen. ## Einen bootfähigen USB-Stick für die Linux-Installation erstellen -1. Ladet das Image eurer ausgewählten Linux Distribution herunter, zum Beispiel +1. Lade das Image deiner ausgewählten Linux Distribution herunter, zum Beispiel für Kubuntu. -1. Installiert das Tool `Rufus`, um das Image auf einen Stick zu schreiben: +1. Installiere das Tool `Rufus`, um das Image auf einen USB-Stick zu schreiben: . -1. Schreibt mit Rufus das heruntergeladene Image auf den Stick. +1. Schreibe mit Rufus das heruntergeladene Image auf den USB-Stick. ## Linux installieren @@ -131,35 +138,42 @@ Also tatsächlich herunterfahren, den Stick einstecken, dann hochfahren und während das Acer-Logo zu sehen ist `F2` drücken. Unter dem Punkt `Main` das `F12 Boot Menu` auf `enabled` setzen. Nun die ersten 10 Punkte durchgehen. -Nach dem Verlassen des Menüs beim erneuten Anzeigen des Acer-Logos `F12` -drücken. +Nach dem Verlassen des Menüs beim erneuten Anzeigen des Acer-Logos `F12` drücken. Mit den Pfeiltasten kann jetzt der Stick ausgewählt werden. Dann die Installation hier ab 4. starten. Bei Punkt 10 (hier) wieder dem Link folgen und die letzten 11 Punkte durchgehen. -1. Klickt mit `Shift` auf `Neustarten`. +1. Klicke mit `Shift` auf `Neustarten`. + +1. Wähle `Ein Gerät benutzen` + +1. Wähle den USB-Stick, vermutlich `UEFI USB Device`. + Der Computer startet neu und bootet in die Linux Installation. -1. Wählt `Ein Gerät benutzen` +1. Du solltest als Sprache Englisch wählen, aus dem einfachen Grund, + dass der Großteil der Online-Dokumentation auf Englisch sind. -1. Wählt den USB-Stick, vermutlich `UEFI USB Device`. Der Computer startet neu -und bootet in die Linux Installation. +1. Keyboard-Layout sollte zu deinem Laptop passen, + also vermutlich `German (eliminate dead keys)`. + Die `eliminate dead keys` Variante sorgt dafür, dass Akzente direkt erscheinen, + was sehr hilfreich für LaTeX ist. -1. Ihr solltet als Sprache Englisch wählen, aus dem einfachen Grund, dass der Großteil -der Online-Dokumentation auf Englisch sind. +1. Aktiviere die Optionen `Install Third Party Software` und falls du mit einem + Netzwerk verbunden bist, installiert Updates während der Installation. -1. Keyboard-Layout sollte zu eurem Laptop passen, also vermutlich `German (eliminate dead keys)`. -Die `eliminate dead keys` Variante sorgt dafür, das Akzente direkt erscheinen, was sehr hilfreich für -LaTeX ist. +1. Die Ubuntu Installation scanned nun deine Festplatte und sollte Windows und den + freigegebenen Speicher finden. + War dies erfolgreich, wählw die Option `Install along-side Windows 10` oder 11. -1. Klickt die Optionen `Install Third Party Software` und falls ihr mit einem Netzwerk verbunden seit, -installiert Updates während der Installation. +1. Wähle die korrekte Zeitzone -1. Die Ubuntu Installation scanned nun eure Festplatte und sollte Windows und den freigegebenen Speicher finden. -War dies erfolgreich, wählt die Option `Install along-side Windows 10`. +1. Warte bis die Installation abgeschlossen ist, dann starte deinen Rechner neu + und entferne den USB-Stick. -1. Wählt die korrekte Zeitzone +1. Beim Neustart solltest du ein neues Menü vorfinden, + dass dich zwischen Linux und Windows wählen lässt. -1. Wartet bis die Installation abgeschlossen ist, dann startet den Rechner neu und entfernt den USB-Stick. +1. Wähle deine installierte Linux-Distribution aus und richte dir dein System ein. -1. Beim Neustart solltet ihr ein neues Menü vorfinden, das euch zwischen Linux und Windows wählen lässt. +1. Befolge auch unsere Installationsanleitung für [Linux](/install/linux.html). From f61e533f815089a90404507d7bdfd36ecf5b444d Mon Sep 17 00:00:00 2001 From: Christian Beckmann Date: Thu, 24 Aug 2023 08:50:52 +0200 Subject: [PATCH 3/8] change every occurence to VSCodium addressing comments of Anno --- install/linux.md | 10 +++++----- install/macos.md | 10 +++++----- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/install/linux.md b/install/linux.md index 5fae972c..707a4cc5 100644 --- a/install/linux.md +++ b/install/linux.md @@ -9,7 +9,7 @@ Falls du nicht am LaTeX-Kurs teilnimmst, ist TeXLive optional. Dann kannst du allerdings kein TeX in matplotlib benutzen (führt zu weniger schönen Plots). Falls du nur am LaTeX-Kurs teilnehmen willst, -solltest du mindestens Visual Studio Codium (oder einen anderen Texteditor) +solltest du mindestens VSCodium (oder einen anderen Texteditor) und TeXLive installieren. @@ -55,9 +55,9 @@ jede Eingabe mit einem `sudo` Befehl muss penibel geprüft werden. $ sudo pacman -S git make curl -### Visual Studio Code +### Texteditor VSCode -Die Binärdateien, die Microsoft zur Verfügung stellt, haben eine Closed Source +Die Binärdateien, die Microsoft bei VSCode zur Verfügung stellt, haben eine Closed Source Lizenz und enthalten Tracking Software. Deswegen nutzen wir VSCodium. @@ -78,8 +78,8 @@ Lizenz und enthalten Tracking Software. Deswegen nutzen wir VSCodium. $ sudo pacman -S code -Starte VS Codium nach der Installation, klicke in der linken Leiste auf -`Extensions` (Unterstes Symbol) und suche nach „TexLab LSP Client“, +Starte VSCodium nach der Installation, klicke in der linken Leiste auf +`Extensions` (unterstes Symbol) und suche nach „TexLab LSP Client“, installiere die Extension mit einem Klick auf den `install` Knopf. ### Anaconda diff --git a/install/macos.md b/install/macos.md index 378ccfe9..9dba8c2b 100644 --- a/install/macos.md +++ b/install/macos.md @@ -6,7 +6,7 @@ title: macOS-Installation Wir empfehlen die Installation einer 64-bit Version, wenn du ein 64-bit Betriebssystem benutzt. -Wenn du dir nicht sicher bist, heutzutage ist fast jedes System 64-bit. +Wenn du dir nicht sicher bist: Heutzutage ist fast jedes System 64-bit. __Es müssen alle Schritte (Installieren, Testen, Aktualisieren) ausgeführt werden!__ @@ -14,7 +14,7 @@ Falls du nicht am LaTeX-Kurs teilnimmst, ist MacTeX optional. Dann kannst du allerdings kein TeX in matplotlib benutzen (führt zu weniger schönen Plots). Falls du nur am LaTeX-Kurs teilnehmen willst, -solltest du mindestens VS Codium (oder einen anderen Texteditor) +solltest du mindestens VSCodium (oder einen anderen Texteditor) und MacTeX installieren.
@@ -66,7 +66,7 @@ Danach "Installieren" auswählen und warten. Der Download wiegt etwa 130 MB. auf den "Dennoch öffen" Button klicken. - In VSCodium mit `Shift+cmd+p` die Kommando-Palette öffnen und `Shell Command: Install 'code' command in PATH` ausführen. - Nun wird VS Codium auch geöffnet, wenn im Terminal `codium` eingeben wird. + Nun wird VSCodium auch geöffnet, wenn im Terminal `codium` eingeben wird. Um git beizubringen, VSCodium zu benutzen, im Terminal: @@ -74,13 +74,13 @@ Um git beizubringen, VSCodium zu benutzen, im Terminal: git config --global core.editor "codium --wait" ``` -- Damit du besser in VS Codium LaTeX-Code schreiben kannst, +- Damit du besser in VSCodium LaTeX-Code schreiben kannst, schlagen wir das Plugin `TexLab LSP Client` vor, welches wie folgt installiert werden kann: - Mit `Shift+cmd+x` die Extensions öffnen - `TexLab LSP Client` suchen - `install` anklicken - - VS Code neu starten + - VSCodium neu starten ### Anaconda From f6d25c8f7cbc5147240e9a2153c2faa29eef71db Mon Sep 17 00:00:00 2001 From: Christian Beckmann Date: Thu, 24 Aug 2023 08:58:01 +0200 Subject: [PATCH 4/8] change latex mini as well --- install/latex_mini.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/install/latex_mini.md b/install/latex_mini.md index 5d979bc1..353eb1ee 100644 --- a/install/latex_mini.md +++ b/install/latex_mini.md @@ -3,28 +3,28 @@ layout: default title: LaTeX Minimale Installation --- -Wir empfehlen die komplette Version zu installieren, aber falls der vorhandene Speicherplatz auf eurem Laptop/PC zu gering ist, könnt ihr hier die minimierte Version installieren. +Wir empfehlen die komplette Version zu installieren, aber falls der vorhandene Speicherplatz auf deinem Laptop/PC zu gering ist, kannst du mit dieser Anleitung die minimierte Version installieren. **Es muss nur eine Version installiert werden!** -Um die minimale Version (≈600 MB) zu installieren könnt ihr analog zur vollen Installation mit den folgenden Schritten beginnen, um das Installationsskript von TexLive herunterzuladen: +Um die minimale Version (≈600 MB) zu installieren kannst du, analog zur vollen Installation, mit den folgenden Schritten beginnen, um das Installationsskript von TeXLive herunterzuladen: ``` $ cd ~/.local $ curl -L http://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz | tar xz $ TEXLIVE_INSTALL_PREFIX=~/.local/texlive ./install-tl-*/install-tl ``` -Um nicht die volle Version herunterzuladen, sondern die `basic` Version, müsst ihr `S` eingeben und mit Enter bestätigen. -Danach kann das `full-scheme` auf `basic` gewechselt werden, indem ihr erst `d` und dann `R` eingebt und jeweils mit Enter bestätigt. +Um nicht die volle Version herunterzuladen, sondern die `basic` Version, musst du `S` eingeben und mit `Enter` bestätigen. +Danach kann das `full-scheme` auf `basic` gewechselt werden, indem du erst `d` und dann `R` eingibst und jeweils mit `Enter` bestätigst. Anschließend kann wie bei der vollen Installation das Installieren mit `I` begonnen werden. -Hier wird aber nur das Programm tlmgr installiert. +Hier wird aber nur das Programm _tlmgr_ installiert. -Damit das Programm anschließend ausführbar ist, muss der Pfad zu der Datei in der Konfigurationsdatei eurer Shell hinzugefügt werden. -Dafür fügt ihr die folgende Zeile der Datei `~/.bashrc` oder `~/.zshrc` hinzu. -Um zu sehen, welche Shell ihr benutzt, könnt ihr `echo $SHELL` im Terminal eingeben. -Anschließend könnt ihr den Pfad zu Texlive dann mit folgendem Kommando zum `PATH` hinzufügen +Damit das Programm anschließend ausführbar ist, muss der Pfad zu der Datei in der Konfigurationsdatei deiner Shell hinzugefügt werden. +Dafür fügst du die folgende Zeile der Datei `~/.bashrc` oder `~/.zshrc` hinzu. +Um zu sehen, welche Shell du benutzst, kannst du `echo $SHELL` im Terminal eingeben. +Wenn die Ausgabe _bash_ ist, kannst du mit dem folgenden Befehl den Pfad zu TeXlive zum `PATH` hinzufügen ``` -$ echo 'export PATH="$HOME/.local/texlive/2022/bin/x86_64-linux:$PATH"' >> ~/.bashrc +$ echo 'export PATH="$HOME/.local/texlive/2023/bin/x86_64-linux:$PATH"' >> ~/.bashrc $ source ~/.bashrc ``` Dann sollten noch die Update-Optionen angepasst werden @@ -33,7 +33,7 @@ $ tlmgr option autobackup -- -1 $ tlmgr option repository https://mirror.ctan.org/systems/texlive/tlnet ``` -Eine Liste aller notwendiger LaTeX Packages, die wir brauchen werden, ladet ihr mit +Eine Liste aller notwendiger LaTeX Packages, die wir brauchen werden, lädst du mit ``` $ curl -fLO https://toolbox.pep-dortmund.org/install/downloads/latex_packages.txt ``` From deddf5bb562dcf48564f631a0b1360f449469944 Mon Sep 17 00:00:00 2001 From: Christian Beckmann Date: Thu, 24 Aug 2023 09:09:39 +0200 Subject: [PATCH 5/8] change problem reporting to du --- problem.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/problem.md b/problem.md index 77c6dda6..3f8d7708 100644 --- a/problem.md +++ b/problem.md @@ -6,18 +6,18 @@ title: Probleme mit den Programmen oder der Installation? Tritt ein Fehler bei der Installation der Programme auf, sollte zuerst geschaut werden, ob der Anleitung gefolgt wurde. -Unter dem Punkt FAQ gibt es einige Hinweise zu bekannten Fehlern. +Unter dem Punkt [FAQ](/faq/index.html) gibt es einige Hinweise zu bekannten Fehlern. Wenn Fehler während des Arbeitens mit den Programmen auftreten, sollte erstmal versucht werden selbstständig das Problem zu lösen. Hierfür sollte die Fehlermeldung durchgelesen werden, dieses kann schon das Problem lösen. Wenn die Fehlermeldung nicht so einfach zu verstehen ist, -kann nach dem Fehler gesucht werden, wie kann so etwas aussehen: +kann nach dem Fehler gesucht werden; wie kann so etwas aussehen: - Auskommentieren von Code-Zeilen, um den Fehler einzugrenzen - Suchen des Fehlers in der Form - Programmname + Fehlermeldung + (Paket) -Sollte dieses nicht helfen, könnt ihr uns eine Mail an +Sollte dieses nicht helfen, kannst du uns eine Mail an [pep-toolbox.physik@lists.tu-dortmund.de](mailto:pep-toolbox.physik@lists.tu-dortmund.de) From 009ada514901a08a5d9c93525ac82f62fe5cec71 Mon Sep 17 00:00:00 2001 From: Christian Beckmann Date: Thu, 24 Aug 2023 10:25:45 +0200 Subject: [PATCH 6/8] installation to du:wording catched by Anno --- install/dualboot.md | 8 ++++---- install/latex_mini.md | 3 ++- install/linux.md | 6 +++--- install/macos.md | 3 +++ problem.md | 5 +++-- 5 files changed, 15 insertions(+), 10 deletions(-) diff --git a/install/dualboot.md b/install/dualboot.md index a15a5d07..2efd6b9d 100644 --- a/install/dualboot.md +++ b/install/dualboot.md @@ -28,8 +28,8 @@ Weiterhin geht diese Anleitung davon aus, dass dein Rechner Dies sollte für alle modernen Rechner die Regel sein, es kann aber vorkommen, dass Windows im sogenannten *Legacy-BIOS* Modus installiert wurde, dann sollte Windows im UEFI Modus neu installiert werden. -Falls ihr einfach nur Linux installieren wollt, -könnt ihr der Anleitung ab +Falls du einfach nur Linux installieren willst, +kannst du der Anleitung ab [Schritt 6](#einen-bootfähigen-usb-stick-für-die-linux-installation-erstellen) folgen. @@ -101,7 +101,7 @@ und können in beiden System falsch sein. Um Windows ebenfalls auf UTC umzustellen, muss die Registry bearbeitet werden. 1. Öffne das Programm `regedit`; am einfachsten, indem du `regedit` tippst, - während das Startmenü offen ist. + während das Startmenü offen ist, und klicke auf `Registrierungs-Editor`. 1. Navigiere auf der linken Seite zu `HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\TimeZoneInformation` @@ -162,7 +162,7 @@ Bei Punkt 10 (hier) wieder dem Link folgen und die letzten 11 Punkte durchgehen. 1. Aktiviere die Optionen `Install Third Party Software` und falls du mit einem Netzwerk verbunden bist, installiert Updates während der Installation. -1. Die Ubuntu Installation scanned nun deine Festplatte und sollte Windows und den +1. Die Ubuntu Installation scannt nun deine Festplatte und sollte Windows und den freigegebenen Speicher finden. War dies erfolgreich, wähle die Option `Install along-side Windows 10` oder 11. diff --git a/install/latex_mini.md b/install/latex_mini.md index 353eb1ee..269256cd 100644 --- a/install/latex_mini.md +++ b/install/latex_mini.md @@ -22,11 +22,12 @@ Hier wird aber nur das Programm _tlmgr_ installiert. Damit das Programm anschließend ausführbar ist, muss der Pfad zu der Datei in der Konfigurationsdatei deiner Shell hinzugefügt werden. Dafür fügst du die folgende Zeile der Datei `~/.bashrc` oder `~/.zshrc` hinzu. Um zu sehen, welche Shell du benutzst, kannst du `echo $SHELL` im Terminal eingeben. -Wenn die Ausgabe _bash_ ist, kannst du mit dem folgenden Befehl den Pfad zu TeXlive zum `PATH` hinzufügen +Wenn die Ausgabe _bash_ enthält, kannst du mit dem folgenden Befehl den Pfad zu TeXlive zum `PATH` hinzufügen ``` $ echo 'export PATH="$HOME/.local/texlive/2023/bin/x86_64-linux:$PATH"' >> ~/.bashrc $ source ~/.bashrc ``` +Für andere Terminal-Varianten musst du den `export` in die entsprechende Konfigurationsdatei schreiben. Dann sollten noch die Update-Optionen angepasst werden ``` $ tlmgr option autobackup -- -1 diff --git a/install/linux.md b/install/linux.md index 707a4cc5..f019e17b 100644 --- a/install/linux.md +++ b/install/linux.md @@ -55,10 +55,10 @@ jede Eingabe mit einem `sudo` Befehl muss penibel geprüft werden. $ sudo pacman -S git make curl -### Texteditor VSCode +### Texteditor VSCodium -Die Binärdateien, die Microsoft bei VSCode zur Verfügung stellt, haben eine Closed Source -Lizenz und enthalten Tracking Software. Deswegen nutzen wir VSCodium. +Die Binärdateien, die Microsoft bei VSCode zur Verfügung stellt, haben eine Closed-Source-Lizenz +und enthalten Tracking Software. Deswegen empfehlen wir VSCodium, eine Open-Source-Variante von VSCode. - Debian, Ubuntu, Mint: diff --git a/install/macos.md b/install/macos.md index 9dba8c2b..08a8c6de 100644 --- a/install/macos.md +++ b/install/macos.md @@ -57,6 +57,9 @@ Danach "Installieren" auswählen und warten. Der Download wiegt etwa 130 MB. ### Texteditor VSCodium +Die Binärdateien, die Microsoft bei VSCode zur Verfügung stellt, sind proprietär +und enthalten Tracking Software. Deswegen empfehlen wir VSCodium, eine Open-Source-Variante von VSCode. + - [VSCodium](https://github.com/VSCodium/vscodium/releases). Lade die neuste Version der Datei `VsCodium-darwin-.zip` herunter. - Das Programm "VSCodium.app" befindet sich dann in der ZIP-Datei im Downloadordner diff --git a/problem.md b/problem.md index 3f8d7708..7192d3da 100644 --- a/problem.md +++ b/problem.md @@ -12,12 +12,13 @@ Wenn Fehler während des Arbeitens mit den Programmen auftreten, sollte erstmal versucht werden selbstständig das Problem zu lösen. Hierfür sollte die Fehlermeldung durchgelesen werden, dieses kann schon das Problem lösen. Wenn die Fehlermeldung nicht so einfach zu verstehen ist, -kann nach dem Fehler gesucht werden; wie kann so etwas aussehen: +kann nach dem Fehler gesucht werden. +Das kann dann folgendermaßen aussehen: - Auskommentieren von Code-Zeilen, um den Fehler einzugrenzen - Suchen des Fehlers in der Form - Programmname + Fehlermeldung + (Paket) -Sollte dieses nicht helfen, kannst du uns eine Mail an +Sollte dies nicht helfen, kannst du uns eine Mail an [pep-toolbox.physik@lists.tu-dortmund.de](mailto:pep-toolbox.physik@lists.tu-dortmund.de) From 59594cc563663083b751e48b56b8175dba3e0519 Mon Sep 17 00:00:00 2001 From: Christian Beckmann Date: Thu, 24 Aug 2023 10:29:06 +0200 Subject: [PATCH 7/8] linux vscode proprietary comment --- install/linux.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/install/linux.md b/install/linux.md index f019e17b..75fce26d 100644 --- a/install/linux.md +++ b/install/linux.md @@ -57,7 +57,7 @@ jede Eingabe mit einem `sudo` Befehl muss penibel geprüft werden. ### Texteditor VSCodium -Die Binärdateien, die Microsoft bei VSCode zur Verfügung stellt, haben eine Closed-Source-Lizenz +Die Binärdateien, die Microsoft bei VSCode zur Verfügung stellt, sind proprietär und enthalten Tracking Software. Deswegen empfehlen wir VSCodium, eine Open-Source-Variante von VSCode. From 7b9907f3bf005cab02e434aaaf053910b54bf612 Mon Sep 17 00:00:00 2001 From: Christian Beckmann Date: Thu, 24 Aug 2023 10:35:54 +0200 Subject: [PATCH 8/8] dualboot: rephrase regedit sentence --- install/dualboot.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/install/dualboot.md b/install/dualboot.md index 2efd6b9d..1e36fd55 100644 --- a/install/dualboot.md +++ b/install/dualboot.md @@ -101,7 +101,7 @@ und können in beiden System falsch sein. Um Windows ebenfalls auf UTC umzustellen, muss die Registry bearbeitet werden. 1. Öffne das Programm `regedit`; am einfachsten, indem du `regedit` tippst, - während das Startmenü offen ist, und klicke auf `Registrierungs-Editor`. + während das Startmenü offen ist, und auf `Registrierungs-Editor` klickst. 1. Navigiere auf der linken Seite zu `HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\TimeZoneInformation`