Merge pull request #75 from chrizzo-hb/main

Something about mounting and dual SD card usage

Author: chrizzo-hb

docs/play/add-games/game-storage.de.md

@@ -1,35 +1,48 @@
-# :material-folder-home: Speicherort für Spiele
-
-Bevor du anfängst, deine Spiele hinzuzufügen, solltest du dir die Zeit nehmen, um zu verstehen, wie die Datenstruktur von KNULLI funktioniert. Dies ist *besonders wichtig*, wenn du bereits Erfahrungen mit anderen CFWs gesammelt hast und deine Daten migrieren möchtest.
-
-## Der `/userdata`-Ordner
-
-Du kannst KNULLI sowohl mit einer einzelnen SD-Karte als auch mit zwei getrennten SD-Karten verwenden. Intern benutzt KNULLI einen Ordner namens `/userdata`, um alle deine Daten (Spiele, Screenshots, Bezels, Speicherstände, Konfigurationen, Themes etc.) darin abzulegen. Wenn du KNULLI mit einer einzelnen SD-Karte verwendest, wird der `/userdata`-Ordner immer auf die *SHARE*-Partition deiner primären SD-Karte zeigen. Wenn du ein Gerät mit mehr als einem SD-Karten-Slot hast und eine zweite SD-Karte verwenden möchtest, wird `/userdata` **stattdessen** auf die Partition der zweiten SD-Karte zeigen.
-
-!!! info "Interner und externer Speicher"
-
-    Du kannst zwischen erster und zweiter SD-Karte wechseln, in dem du den Schritten im Abschnitt [Eine zweite SD-Karte verwenden](../second-sd-card) folgst. Indem du zwischen internem und externem Speicher hin- und her schaltest, legst du für KNULLI fest, wohin `/userdata` zeigen soll.
-
-Im Verzeichnis `/userdata` befinden sich weitere Unterordner, in denen du Spiele und weitere Dateien ablegen kannst. Nach der ersten Installation wird KNULLI diese Ordner automatisch anlegen und befüllen. Die wichtigsten Ordner für dich sind folgende:
-
-* `/userdata` (entspricht entweder deiner *SHARE*-Partition auf der primären SD-Karte oder der Hauptpartition auf der zweiten SD-Karte)
-    * `/bios` ist der Ordner, in dem du BIOSe ablegen kannst.
-    * `/cheats` ist der Ordner, in dem du Cheats ablegen kannst.
-    * `/decorations` ist der Ordner, in dem du deine Bezels ablegen kannst.
-    * `/music` ist der Ordner, in dem du MP3s und OGG-Dateien ablegen kannst, die in EmulationStation als Hintergrundmusik abgespielt werden können. (Die Songs sollten eine Samplerate von 44100Hz haben und eine Bitrate von maximal 256 kb/s.)
-    * `/roms` ist der Ordner, in dem du deine Spiele ablegen kannst. Der Ordner enthält bereits diverse Unterordner für verschiedene Systeme. Leg deine Spiele einfach in die passenden Ordner der Systeme, für die das jeweilige Spiel entwickelt wurde.
-        * `/snes` ist der Ordner, in dem du deine SNES-Spiele ablegen kannst.
-        * `/gb` ist der Ordner, in dem du deine Gameboy-Spiele ablegen kannst.
-        * `/ports` ist der Ordner, in dem du deine Ports (inklusive [PortMaster](../../../systems/portmaster) ablegen kannst.
-        * ...
-    * `/saves` ist der Ordner, in dem deine gespeicherten Spielstände abgelegt werden.
-    * `/screenshots` ist der Ordner, in dem deine gespeicherten Screenshots abgelegt werden.
-    * `/system` ist der Ordner, der deine Einstellungen enthält. Du solltest hier keine Änderungen vornehmen, wenn du nicht weißt, was du tust. Es kann aber nicht schaden, von diesem Ordner regelmäßige Backups anzufertigen.
-    * `/theme-customizations` ist der Ordner, in dem du Anpassungen an deinen Themes vornehmen kannst.
-    * `/themes` ist der Ordner, in dem du deine Themes ablegen kannst.
-
-!!! info "KNULLI sucht ausschließlich im dafür vorgesehenen Ordner `roms` nach Spielen. Spiele, die außerhalb des dafür vorgesehenen Ordners abgelegt werden, werden von KNULLI nicht erkannt. Wenn du nicht sicher bist, welche Spiele in welchen Ordner gehören, empfehlen wir dringend, dass du einen Blick ins [Batocera Wiki](https://wiki.batocera.org/systems) wirfst!"
-
-!!! info "KNULLI ist ein Linux-System. Anders als Windows unterscheiden Linux-Systeme zwischen *Groß- und Kleinschreibung* in Datei- und Ordnernamen. Du solltest deswegen darauf achten, dich an die erwartete Groß- und Kleinschreibung zu halten, wenn du deine Dateien migrierst."
-
-!!! info "Für Details bzgl. der Dateien, die das jeweilige System benötigt, besuche bitte die entsprechenden Seiten im Abschnitt [Systeme](/../systems) in diesem Wiki."
+# :material-folder-home: Speicherort für Spiele
+
+Bevor du anfängst, deine Spiele hinzuzufügen, solltest du dir die Zeit nehmen, um zu verstehen, wie die Datenstruktur von KNULLI funktioniert. Dies ist *besonders wichtig*, wenn du bereits Erfahrungen mit anderen CFWs gesammelt hast und deine Daten migrieren möchtest.
+
+## Der `/userdata`-Ordner
+
+Du kannst KNULLI sowohl mit **einer einzelnen SD-Karte** als auch mit **zwei getrennten SD-Karten** verwenden. Intern benutzt KNULLI einen Ordner namens `/userdata`, um **alle deine Daten** (Spiele, Screenshots, Bezels, Speicherstände, Konfigurationen, Themes etc.) darin abzulegen. Wenn du KNULLI mit einer einzelnen SD-Karte verwendest, wird der `/userdata`-Ordner **immer** auf die *SHARE*-Partition deiner **primären SD-Karte** zeigen. Wenn du ein Gerät mit mehr als einem SD-Karten-Slot hast und eine **zweite SD-Karte** verwenden möchtest, wird `/userdata` **stattdessen** auf die Partition der **zweiten SD-Karte** zeigen.
+
+Dementsprechend ist es **nicht** möglich, **gleichzeitig** die *SHARE*-Partition von SD 1 und SD 2 zu verwenden. Es kann zu jedem Zeitpunkt immer nur eine der beiden SD-Karten als `/userdata` gemountet sein. Wenn du über die [SMB-Netzwerkübertragung](../network-transfer) auf dein Gerät zugreifst, wirst du immer nur **einen** *SHARE*-Ordner vorfinden, der immer auf deinen `/userdata`-Ordner zeigen wird. Dementsprechend wird dein interner Speicher niemals über das Netzwerk erreichbar sein, während du eine zweite SD-Karte als Speicher verwendest.
+
+!!! info "Interner und externer Speicher"
+
+    Du kannst zwischen erster und zweiter SD-Karte wechseln, in dem du den Schritten im Abschnitt [Eine zweite SD-Karte verwenden](../second-sd-card) folgst. Indem du zwischen internem und externem Speicher hin- und her schaltest, legst du für KNULLI fest, wohin `/userdata` zeigen soll.
+!!! info "Wie "mounten" unter Linux funktioniert"
+
+    Was viele Windows-Nutzer nicht wissen: Linux-Systeme addressieren Laufwerke **nicht** mit "Laufwerksbuchstaben", wie du es von deinem Windows-Computer kennst. Linux "mountet" die Laufwerke stattdessen als **Ordner**. Das Linux-Dateisystem kennt das Konzept von Laufwerksbuchstaben nicht, es besteht nur aus einem einzigen Dateibaum, an dessen Spitze das Symbol `/` steht - die "Wurzel" des Baumes. Jeder Ordner der existiert, existiert als **Unterordner** von `/`.
+
+    Versuch dir vorzustellen, dass `/` ganz grob `C:\` auf deinem Windows-Computer entspricht. Versuch dir vorzustellen, dass ein USB-Stick, wenn du ihn an deinem Computer anschließt, nicht als neues Laufwerk `D:\` erscheint, sondern als ein Unterordner von `C:\`, z.B. `C:\media\my-usb-stick`.
+
+    KNULLI ist ein Linux, dementsprechend nutzt es das Linux-Dateisystem. Damit es korrekt funktioniert, benötigt KNULLI einen Ordner namens `/userdata` (grob vergleichbar mit einem Ordner namens `C:\userdata`), in dem KNULLI all deine Dateien (Spiele, Themes, Spielstände, etc.) erwartet. Der Ordner `/userdata` ist **gleichzeitig** auch ein Mount-Ziel für **Laufwerke**. Wenn du zwischen **internem** und **externem** Speicher wechselst, legst du damit eigentlich nur fest, auf welches Laufwerk `/userdata` nach dem nächsten Neustart zeigen soll - **entweder** die interne *SHARE*-Partition **oder** SD 2.
+    
+    KNULLI erwartet **alle** deine Daten in `/userdata`, KNULLI **sucht nicht** nach Spielen, Themes oder irgendetwas anderem **außerhalb** der vordefinierten Ordnerstruktur. Aus diesem Grund ist es **nicht** möglich, beide SD-Karten **gleichzeitig** als Speicherort für Spiele zu verwenden.
+
+## Vordefinierte Ordner für deine Dateien
+
+IIm Verzeichnis `/userdata` befinden sich weitere Unterordner, in denen du Spiele und weitere Dateien ablegen kannst. Nach der ersten Installation wird KNULLI diese Ordner automatisch anlegen und befüllen. Die wichtigsten Ordner für dich sind folgende:
+
+* `/userdata` (entspricht entweder deiner *SHARE*-Partition auf der primären SD-Karte oder der Hauptpartition auf der zweiten SD-Karte)
+    * `/bios` ist der Ordner, in dem du BIOSe ablegen kannst.
+    * `/cheats` ist der Ordner, in dem du Cheats ablegen kannst.
+    * `/decorations` ist der Ordner, in dem du deine Bezels ablegen kannst.
+    * `/music` ist der Ordner, in dem du MP3s und OGG-Dateien ablegen kannst, die in EmulationStation als Hintergrundmusik abgespielt werden können. (Die Songs sollten eine Samplerate von 44100Hz haben und eine Bitrate von maximal 256 kb/s.)
+    * `/roms` ist der Ordner, in dem du deine Spiele ablegen kannst. Der Ordner enthält bereits diverse Unterordner für verschiedene Systeme. Leg deine Spiele einfach in die passenden Ordner der Systeme, für die das jeweilige Spiel entwickelt wurde.
+        * `/snes` ist der Ordner, in dem du deine SNES-Spiele ablegen kannst.
+        * `/gb` ist der Ordner, in dem du deine Gameboy-Spiele ablegen kannst.
+        * `/ports` ist der Ordner, in dem du deine Ports (inklusive [PortMaster](../../../systems/portmaster) ablegen kannst.
+        * ...
+    * `/saves` ist der Ordner, in dem deine gespeicherten Spielstände abgelegt werden.
+    * `/screenshots` ist der Ordner, in dem deine gespeicherten Screenshots abgelegt werden.
+    * `/system` ist der Ordner, der deine Einstellungen enthält. Du solltest hier keine Änderungen vornehmen, wenn du nicht weißt, was du tust. Es kann aber nicht schaden, von diesem Ordner regelmäßige Backups anzufertigen.
+    * `/theme-customizations` ist der Ordner, in dem du Anpassungen an deinen Themes vornehmen kannst.
+    * `/themes` ist der Ordner, in dem du deine Themes ablegen kannst.
+
+!!! info "KNULLI sucht ausschließlich im dafür vorgesehenen Ordner `roms` nach Spielen. Spiele, die außerhalb des dafür vorgesehenen Ordners abgelegt werden, werden von KNULLI nicht erkannt. Wenn du nicht sicher bist, welche Spiele in welchen Ordner gehören, empfehlen wir dringend, dass du einen Blick ins [Batocera Wiki](https://wiki.batocera.org/systems) wirfst!"
+
+!!! info "KNULLI ist ein Linux-System. Anders als Windows unterscheiden Linux-Systeme zwischen *Groß- und Kleinschreibung* in Datei- und Ordnernamen. Du solltest deswegen darauf achten, dich an die erwartete Groß- und Kleinschreibung zu halten, wenn du deine Dateien migrierst."
+
+!!! info "Für Details bzgl. der Dateien, die das jeweilige System benötigt, besuche bitte die entsprechenden Seiten im Abschnitt [Systeme](/../systems) in diesem Wiki."

docs/play/add-games/game-storage.md

@@ -2,14 +2,28 @@
 
 Before you start adding your games, please take the time to understand how data storage is structured on KNULLI. This might be helpful, *especially* when you already have experience with other CFWs and want to migrate your data.
 
-## The `/userdata` Folder
+## The `/userdata` folder
 
-KNULLI supports single and dual SD card setups. Internally, KNULLI has a folder called `/userdata` where all your data (games, screenshots, bezels, saves, configurations, themes, etc.) will be stored. On a single-SD-card setup, the `/userdata` folder will always point to the *SHARE* partition of your primary SD card. If you have a device with more than one SD card slot and choose to create a dual-SD-card setup, the `/userdata` folder will point to the main partition of your secondary SD card **instead**.
+KNULLI supports **single** and **dual SD card** setups. Internally, KNULLI has a folder called `/userdata` where **all your data** (games, screenshots, bezels, saves, configurations, themes, etc.) will be stored. On a single-SD-card setup, the `/userdata` folder will **always** point to the *SHARE* partition of your **primary SD card**. If you have a device with more than one SD card slot and choose to create a **dual-SD-card setup**, the `/userdata` folder will point to the main partition of your **secondary SD card instead**.
+
+Consequently, you will **not** be able to use the *SHARE* partition of SD 1 and SD 2 **at the same time**. Only one of those SD cards can be mounted as `/userdata` at a time. If you attempt your storage via [SMB network transfer](../network-transfer), you will only find **one** *SHARE* folder, which will always point at your `/userdata` folder. Therefore, when running a dual-SD-card setup, your internal *SHARE* partition will neither be used by KNULLI, nor be accessible via network transfer.
 
 !!! info "Internal and external storage"
 
     You can switch between single/dual SD card mode by following the steps in the section about [Using a second SD card](../second-sd-card). Basically, by switching between internal/external storage, you just tell KNULLI which drive/partition `/userdata` should point to.
 
+!!! info "Understanding mounting on Linux"
+
+    Windows users might not know this: On Linux systems, drives are **not** addressed by "drive letters" like you know it from your Windows machine. Instead, Linux mounts the drives into **folders**. The Linux file system does not know any drive letters at all, it consists of just **one** file tree with `/` being the "root" of the tree. Every folder that exists is a **subfolder** of `/`.
+    
+    You might imagine `/` to be roughly comparable to `C:\` on your Windows machine. Try to imagine that, when plugging an USB stick, the stick will not appear as `D:\` but as a folder on `C:\`, e.g. `C:\media\my-usb-stick\`.
+
+    KNULLI is a Linux, so it uses the Linux file system. More specifically, KNULLI always needs to have a folder called `/userdata` (again, roughly comparable to `C:\userdata`) where KNULLI expects all your data (games, themes, saves, etc.) to be located. However `/userdata` is **also** a mount point for a **drive**. By switching between **internal** and **external**, you basically tell KNULLI where `/userdata` should point to after the next boot - it is **either** the internal *SHARE* partition **or** SD 2.
+
+    KNULLI expects **all** your data to be in `/userdata`, it **does not look** for games, themes, or anything else **outside** of the pre-defined folder structure. This is why it is **not** possible to use both SD cards as game storage **at the same time**.
+
+## Pre-defined folders for your data
+
 Inside the `/userdata` folder, you will find subfolders where you can store your games and other files. After installing for the first time, KNULLI will create and populate all these folders automatically. The most important folders for you to know are the following:
 
 * `/userdata` (corresponds to either the *SHARE* partition of your primary SD card or the main partition of the secondary SD card)

docs/play/add-games/second-sd-card.de.md

@@ -4,6 +4,8 @@
 
     Wenn du eine zweite SD-Karte verwenden willst, empfehlen wir dir **dringend**, sie mit **ext4** zu formatieren und via [**Netzwerkübertragung**](../network-transfer) darauf zuzugreifen. Bevor du anfängst, eine mit exFAT formatierte zweite SD-Karte einzurichten, lies bitte die Warnung im Abschnitt [Spiele hinzufügen](..).
 
+    Außerdem solltest du dir bewusst sein, dass es **nicht möglich** ist, **gleichzeitig** SD 1 **und** SD 2 als Speicherort für deine Spiele zu verwenden. Du kannst **entweder** SD 1 **oder** SD 2 verwenden - aber niemals beide gleichzeitig! Wenn du mehr darüber erfahren möchtest, wirf bitte einen Blick auf den Abschnitt [Speicherort für Spiele](../game-storage).
+
 !!! info "Zu Dual-SD-Card-Setup wechseln"
 
     Dieser Abschnitt richtet sich an Nutzer, die gerade dabei sind KNULLI zum ersten Mal einzurichten. Falls du bereits eine laufende KNULLI-Installation auf einer einzelnen SD-Karte konfiguriert hast, solltest du lieber einen Blick auf unsere [Anleitung "Zu Dual-SD-Card-Setup wechseln"](../../../guides/dual-sd-card-migration) werfen.

docs/play/add-games/second-sd-card.md

@@ -2,7 +2,9 @@
 
 !!! danger "Important:  Read this before you proceed!"
 
-    If you want to use a second SD card, we **strongly** recommend to format it to **ext4** and use [**Network Transfer**](../network-transfer) to access it. Before you attempt set up a exFAT-formatted second SD card, pleae make sure to read the warning in the [Add Games](..) section.
+    If you want to use a second SD card, we **strongly** recommend to format it to **ext4** and use [**Network Transfer**](../network-transfer) to access it. Before you attempt set up a exFAT-formatted second SD card, please make sure to read the warning in the [Add Games](..) section.
+    
+    Furthermore, please understand that it is **not possible** to use SD 1 and SD 2 as game storage **at the same time**. You can use **either** SD 1 **or** SD 2 - but not both at the same time! If you want to learn more about this, please have a look at the [Game Storage section](../game-storage).
 
 !!! info "Migrating to a dual SD card setup"