Skip to content

Commit 7ceb60d

Browse files
committed
feat(docs): Add the multi language support, and add the complete german (de) translation
1 parent 755a242 commit 7ceb60d

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

43 files changed

+2232
-156
lines changed

docs/.vitepress/config.ts

Lines changed: 239 additions & 146 deletions
Large diffs are not rendered by default.

docs/customization/displaymanager.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -125,7 +125,7 @@ sudo vim /etc/sddm.conf
125125

126126
The section should look something like this:
127127

128-
```sh
128+
```ini
129129
[Theme]
130130
Current=Nordic-SDDM
131131
```
@@ -141,7 +141,7 @@ sudo vim /etc/sddm.conf.d/custom-theme.conf
141141
```
142142
Then, add the following content:
143143

144-
```sh
144+
```ini
145145
[Theme]
146146
Current=Nordic-SDDM
147147
```
Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
# Hyprland und NVIDIA
2+
3+
> [!WARNING]
4+
> Es gibt keine offizielle Hyprland-Unterstützung für NVIDIA-Hardware. Möglicherweise lässt sich Hyprland jedoch zum Laufen bringen. Siehe dazu:
5+
> https://wiki.hyprland.org/Nvidia/
6+
7+
Einige Benutzer berichten, dass Hyprland mit den Dotfiles erfolgreich auf Systemen mit NVIDIA-GPUs unter Verwendung des Open-Source-Treibers "nouveau" installiert werden konnte.
8+
9+
Alternativ bietet ML4W eine BETA-Option an, um den proprietären NVIDIA-Treiber zu installieren (GRUB-Bootloader erforderlich).
10+
Installiere die Dotfiles mit:
11+
12+
```sh
13+
ml4w-hyprland-setup -m nvidia
14+
```
15+
16+
<div class="tip custom-block" style="padding-top: 20px; padding-bottom: 8px;">
17+
18+
**Wähle in der ML4W Settings-App unter System → Environment die [folgende Variation](https://github.com/mylinuxforwork/dotfiles/blob/main/share/dotfiles/.config/hypr/conf/environments/nvidia.conf) aus**
19+
20+
Oder setze die entsprechenden Umgebungsvariablen direkt in `hyprland.conf`.
21+
22+
</div>
23+

docs/de/configuration/input.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# Eingabekonfiguration
2+
3+
Du kannst die Einstellungen für Tastatur, Maus oder Touchpad jederzeit in dieser Datei ändern:
4+
5+
`./config/hypr/conf/keyboard.conf`
6+
7+
Deine Eingabekonfiguration kann bei jedem Update der Dotfiles wiederhergestellt werden.
8+
Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# Monitor-Einrichtung
2+
3+
Wenn du die Standard-Monitor-Konfiguration ändern möchtest, kannst du entweder eine persönliche Monitor-Variation anlegen oder `nwg-displays` verwenden.
4+
5+
## Persönliche Monitor-Variation
6+
7+
Öffne die ML4W Dotfiles Settings App und wähle den Reiter "System". Beim Herunterscrollen findest du die mitgelieferten Monitor-Variationen.
8+
9+
![image](/monitor.png)
10+
11+
Du kannst auch eine eigene Variation erstellen, wie in der Dokumentation beschrieben: [Configuration-Variations](https://github.com/mylinuxforwork/dotfiles/wiki/Configuration-Variations).
12+
13+
## Verwendung von nwg-displays
14+
15+
Die ML4W Dotfiles unterstützen die Anwendung [nwg-displays](https://github.com/nwg-piotr/nwg-displays) zur Konfiguration deiner Anzeigeeinstellungen.
16+
17+
Installiere `nwg-displays` für deine Distribution wie folgt:
18+
19+
::: code-group
20+
21+
```sh [<i class="devicon-archlinux-plain"></i> Arch]
22+
sudo pacman -S nwg-displays
23+
```
24+
25+
```sh [<i class="devicon-fedora-plain"></i> Fedora]
26+
sudo dnf install python-build python-installer python-wheel python-setuptools
27+
git clone https://github.com/nwg-piotr/nwg-displays ~/nwg-displays
28+
cd ~/nwg-displays && chmod +x install.sh
29+
sudo ./install.sh
30+
```
31+
```sh [<i class="devicon-opensuse-plain"></i> openSuse]
32+
sudo zypper install nwg-displays
33+
```
34+
35+
:::
36+
37+
Öffne die App und wende deine gewünschten Monitoreinstellungen an.
38+
39+
![image](/monitor1.png)
40+
41+
Anschließend öffne die ML4W Settings App und wähle die Monitor-Variation `nwg-displays`.
42+
43+
![image](/monitor2.png)
44+
45+
> Ab jetzt kannst du deine Monitoreinstellungen direkt in `nwg-displays` ändern.
Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
# Bewahre deine Anpassungen
2+
3+
> [!NOTE]
4+
> Der Dotfiles Installer installiert die Dotfiles standardmäßig in `.mydotfiles`. Du kannst den Zielordner in den Einstellungen anpassen.
5+
6+
## Schütze Ordner in `.config` mit dem Dotfiles Installer
7+
8+
Wenn du deine aktuellen ML4W-Dotfiles mit dem Dotfiles Installer auf eine neue Version aktualisierst, kannst du Konfigurationsordner oder -dateien im Ordner `.config` mit deinen Anpassungen schützen. Der Dotfiles Installer merkt sich deine Auswahl für zukünftige Updates.
9+
10+
![image](https://mylinuxforwork.github.io/dotfiles-installer/protectscreen.jpg)

docs/de/configuration/xwayland.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
# SDL umschalten
2+
3+
Einige Spiele verwenden veraltete SDL-Versionen, die ohne Wayland-Unterstützung kompiliert wurden. Das bedeutet, dass sie wahrscheinlich nicht starten (oder beim Start abstürzen), wenn `SDL_VIDEODRIVER` auf `wayland` gesetzt ist.**
4+
5+
Du kannst zwischen Wayland und X11 in der Datei `~/dotfiles/hypr/conf/custom.conf` wechseln:
6+
7+
```sh
8+
# SDL-Version
9+
env = SDL_VIDEODRIVER,wayland
10+
# env = SDL_VIDEODRIVER,x11
11+
```
12+
13+
> [!NOTE]
14+
> In Versionen vor 2.9.5RL findest du den Eintrag in `~/dotfiles/hypr/conf/ml4w.conf`
15+
16+
## Toolkit-Backend Umgebungsvariablen
17+
18+
Diese Umgebungsvariablen stellen sicher, dass die richtigen Backends in Hyprland verwendet werden:
19+
20+
| Variable | Wert |
21+
|----------|------|
22+
| `GDK_BACKEND` | `wayland,x11,*` |
23+
| `SDL_VIDEODRIVER` | `wayland` |
24+
| `CLUTTER_BACKEND` | `wayland` |
25+
26+
> [!TIP]
27+
> Verschiebe die folgende Zeile in deine `custom.conf`, um mehr Kontrolle zu haben:
28+
>
29+
> ```ini
30+
> env = SDL_VIDEODRIVER,wayland
31+
> ```
32+
33+
34+

docs/de/credentials/thankyou.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# Besonderer Dank
2+
3+
Ich möchte allen Mitwirkenden der ML4W-Dotfiles und allen Entwicklern danken, die großartige Konfigurationen für unseren Lieblings-Tiling-Fenstermanager Hyprland erstellen. Eure Unterstützung, das Testen jeder Version und all eure wertvollen Pull Requests mit Verbesserungen und Fehlerbehebungen haben das Projekt wiederholt verbessert und seine Qualität gesteigert.
4+
5+
Besonderer Dank geht an:
6+
7+
https://github.com/harilvfs für die Unterstützung beim Erstellen des neuen Wikis https://mylinuxforwork.github.io/dotfiles/
8+
9+
https://github.com/Mat-Armstrong für das neue ML4W-Logo-Design und vieles mehr.
10+
11+
https://github.com/dwilliam62 für all deine Unterstützung und Tests seit Beginn des Projekts
12+
13+
und so viele mehr...
14+
15+
Die folgenden Projekte haben mich inspiriert:
16+
17+
- https://github.com/JaKooLit/Hyprland-Dots
18+
- https://github.com/prasanthrangan/hyprdots
19+
- https://github.com/sudo-harun/dotfiles
20+
- https://github.com/dianaw353/hyprland-configuration-rootfs
21+
- https://github.com/basecamp/omarchy
22+
23+
und viele weitere...
24+
25+
Und natürlich https://github.com/vaxerski für diese großartige Software.

docs/de/customization/browser.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# Default Browser
2+
3+
<div align="center" class="tip custom-block" style="padding-top: 20px; padding-bottom: 20px;">
4+
5+
**Der Standardbrowser ist Firefox. Du kannst aber jeden beliebigen Browser als Standard setzen.**
6+
7+
</div>
8+
9+
As an example, let's install brave.
10+
11+
```sh
12+
yay -S brave-bin
13+
```
14+
15+
Öffne anschließend die ML4W Dotfiles Settings App mit `SUPER+CTRL+S`, wähle den Reiter Waybar, scrolle nach unten und ändere den Browser auf `brave`.
16+
17+
![image](/browser.png)
18+
19+
Führe dann folgenden Befehl in einem Terminal aus:
20+
21+
```sh
22+
xdg-settings set default-web-browser brave.desktop
23+
```
24+
25+
Um den Waybar-Quicklink für den Browser zu ändern, folge den Anweisungen im Abschnitt `Customize Waybar`.
Lines changed: 182 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,182 @@
1+
2+
# Display Manager
3+
4+
Dieses Tutorial führt dich durch die Installation eines Display Managers wie SDDM und das Wechseln zwischen verschiedenen Display Managern (z. B. SDDM und GDM) auf einem Linux-System. Display Manager bieten eine grafische Anmeldemaske und verwalten Benutzersitzungen.
5+
6+
> [!NOTE]
7+
> Die ML4W Dotfiles enthalten keine Display-Manager-Konfiguration, um nicht direkt sensible Systemkomponenten wie Display Manager zu manipulieren.
8+
9+
Aktualisiere zuerst deine Paketliste, bevor du einen Display Manager installierst.
10+
11+
::: code-group
12+
13+
```sh [Arch]
14+
sudo pacman -Syu
15+
```
16+
17+
```sh [Fedora]
18+
sudo dnf update
19+
```
20+
21+
```sh [openSuze]
22+
sudo zypper update
23+
```
24+
:::
25+
26+
## SDDM
27+
28+
### SDDM für deine Distribution installieren:
29+
30+
::: code-group
31+
32+
```sh [Arch]
33+
sudo pacman -S sddm
34+
```
35+
36+
```sh [Fedora]
37+
sudo dnf install sddm
38+
```
39+
40+
```sh [openSuze]
41+
sudo zypper install sddm
42+
```
43+
:::
44+
45+
46+
### SDDM aktivieren (falls nicht automatisch aktiviert)
47+
48+
Während der Installation kann es sein, dass einige Distributionen dich auffordern, den Standard-Display-Manager auszuwählen. Falls nicht, oder wenn du ihn explizit aktivieren möchtest, kannst du dies tun.
49+
50+
Für Systeme mit systemd (die meisten modernen Distributionen):
51+
52+
```sh
53+
sudo systemctl enable sddm
54+
```
55+
56+
Wenn zuvor ein anderer Display Manager (z. B. GDM) aktiviert war, deaktiviert das Aktivieren von SDDM diesen in der Regel automatisch. Wenn du sicher gehen möchtest, kannst du den alten explizit deaktivieren (z. B. GDM):
57+
58+
```sh
59+
sudo systemctl disable gdm # Nur falls GDM zuvor aktiviert war
60+
```
61+
### SDDM-Themes installieren
62+
63+
Die Installation eines SDDM-Themes hängt vom jeweiligen Theme-Entwickler ab. Viele großartige SDDM-Themes findest du auf Gnome Look: https://www.gnome-look.org/browse?cat=101&ord=top
64+
65+
Die Installation eines benutzerdefinierten SDDM-Themes umfasst in der Regel das Herunterladen des Themes, Entpacken, Verschieben in das richtige Verzeichnis und das Konfigurieren von SDDM.
66+
67+
68+
#### Schritt 1: Theme herunterladen
69+
70+
1. Öffne deinen Webbrowser und gehe zur Theme-Seite: https://www.gnome-look.org/p/1312658
71+
2. Navigiere zum Reiter "Files" auf der Theme-Seite.
72+
3. Lade die neueste Version des Themes herunter (meist ein .tar.gz oder .zip). Für das "Nordic"-Theme suche nach einer Datei wie Nordic-SDDM.tar.gz.
73+
74+
> [!TIP]
75+
> Merke dir, wo die Datei gespeichert wird (z. B. dein Downloads-Ordner).
76+
77+
#### Schritt 2: Theme entpacken
78+
79+
1. Öffne ein Terminal.
80+
2. Wechsle in das Verzeichnis, in das du das Theme heruntergeladen hast. Beispiel:
81+
82+
```sh
83+
cd ~/Downloads
84+
```
85+
3. Entpacke das heruntergeladene Archiv.
86+
87+
Wenn es eine .tar.gz-Datei ist:
88+
89+
```sh
90+
tar -xvf Nordic-SDDM.tar.gz
91+
```
92+
93+
Wenn es eine .zip-Datei ist:
94+
95+
```sh
96+
unzip Nordic-SDDM.zip
97+
```
98+
Dies erstellt ein neues Verzeichnis (z. B. Nordic-SDDM oder Nordic) mit den Theme-Dateien.
99+
100+
#### Schritt 3: Theme in das SDDM-Themes-Verzeichnis verschieben
101+
102+
SDDM-Themes liegen typischerweise in `/usr/share/sddm/themes/`. Du benötigst `sudo`, um Dateien in dieses Verzeichnis zu verschieben.
103+
104+
Verschiebe das entpackte Theme-Verzeichnis in das SDDM-Themes-Verzeichnis. Ersetze `Nordic-SDDM` durch den tatsächlichen Verzeichnisnamen.
105+
106+
```sh
107+
sudo mv Nordic-SDDM /usr/share/sddm/themes/
108+
```
109+
> [!NOTE]
110+
> Achte darauf, das gesamte Theme-Verzeichnis (nicht nur dessen Inhalt) nach `/usr/share/sddm/themes/` zu verschieben.
111+
112+
#### Schritt 4: SDDM konfigurieren, damit es das neue Theme verwendet
113+
114+
Bearbeite die SDDM-Konfigurationsdatei und setze das Theme (z. B. `/etc/sddm.conf` oder eine Datei unter `/etc/sddm.conf.d/`).
115+
116+
```sh
117+
sudo vim /etc/sddm.conf
118+
```
119+
120+
1. Finde den Abschnitt `[Theme]` oder füge ihn hinzu.
121+
2. Setze `Current=` auf den Namen des Theme-Ordners, z. B.:
122+
123+
```ini
124+
[Theme]
125+
Current=Nordic-SDDM
126+
```
127+
128+
3. Speichere und beende den Editor.
129+
130+
Alternative: Lege eine Datei unter `/etc/sddm.conf.d/` an, falls `/etc/sddm.conf` nicht vorhanden ist.
131+
132+
```sh
133+
sudo vim /etc/sddm.conf.d/custom-theme.conf
134+
```
135+
136+
Füge dann den Abschnitt hinzu:
137+
138+
```ini
139+
[Theme]
140+
Current=Nordic-SDDM
141+
```
142+
143+
#### Schritt 5: Änderungen anwenden
144+
145+
Starte den SDDM-Dienst neu:
146+
147+
```sh
148+
sudo systemctl restart sddm
149+
```
150+
> [!WARNING]
151+
> Dieser Befehl bringt dich sofort zurück zum Login-Bildschirm. Speichere vorher alle offenen Arbeiten.
152+
153+
Nach dem Neustart solltest du das neue SDDM-Theme sehen. Bei Problemen überprüfe Verzeichnisnamen und die `Current=`-Einstellung auf Tippfehler.
154+
155+
## Zwischen Display Managern wechseln
156+
157+
Die meisten Distributionen bieten einfache Möglichkeiten, zwischen installierten Display Managern zu wechseln. Beispiel:
158+
159+
SDDM deaktivieren:
160+
161+
```sh
162+
sudo systemctl disable sddm
163+
```
164+
165+
GDM aktivieren:
166+
167+
```sh
168+
sudo systemctl enable gdm # oder gdm3
169+
```
170+
171+
SDDM stoppen und GDM starten (optional):
172+
173+
```sh
174+
sudo systemctl stop sddm
175+
sudo systemctl start gdm # oder gdm3
176+
```
177+
178+
System neu starten:
179+
180+
```sh
181+
sudo reboot
182+
```

0 commit comments

Comments
 (0)