Merge pull request #16 from chrizzo-hb/main

Updated add games sections (en/de)

Author: acmeplus

docs/play/add-games.de.md

@@ -1,5 +1,8 @@
 # :material-layers-plus: Spiele zu KNULLI hinzufügen
 
+
+!!! info "Anders als viele andere CFWs formattiert KNULLI die *SHARE*-Partition standardmäßig mit ext4. Das Dateisystem ext4 ist unter Windows nicht lesbar, d.h. du wirst deine Spiele möglicherweise nicht auf die gleiche Weise hinzufügen können, wie du es von anderen CFWs gewohnt bist. Der Grund dafür ist, dass einige Spiele aus der [PortMaster](../../systems/portmaster)-Bibliothek auf das ext4-Dateisystem angewiesen sind, da sie symbolische Links und große Swap-Dateien einsetzen, die von Windows-Dateisystemen nicht unterstützt werden. Es ist möglich, die Partition nach dem ersten Bootvorgang stattdessen [mit exFAT zu formatieren](#die-share-partition-mit-exfat-formatieren). Du solltest dir allerdings darüber im Klaren sein, dass einige PortMaster-Spiele dann nicht mehr funktionieren werden."
+
 Es gibt verschiedene Möglichkeiten, um Spiele auf dein KNULLI-Gerät zu laden. Welche Möglichkeiten für dich geeignet sind, hängt davon ab, welche Funktionen auf deinem Gerät zur Verfügung stehen. Wenn dein Gerät beispielsweise keine geeignete Hardware hat, um einem Netzwerk beizutreten, kannst du natürlich keine Daten via Netzwerk übertragen. Außerdem spielt es natürlich eine Rolle, welches Gerät dir als Datenquelle zur Verfügung steht.
 
 ## Datenstruktur
@@ -40,9 +43,11 @@ Wenn du KNULLI auf einem Gerät installierst, das über zwei SD-Karten-Slots ver
 * Im Abschnitt *Storage* kannst du das *Storage device* auswählen.
     * Stelle von *Internal* (der "interne" Speicher ist die *SHARE*-Partition deiner KNULLI-SD-Karte) auf den Namen deiner zweiten SD-Karte, z.B. *SHARE - 25.6G*.
 * Reboote KNULLI, um die Änderungen wirksam zu machen, drücke dazu den ++"Start"++-Button und gehe im Hauptmenü zu *Quit* und wähle dort *Restart system*.
-* Beim Neustart wird KNULLI auf deiner zweiten SD-Karte automatisch einen Ordner `/batocera` anlegen und alle Unterordner, die du normalerweise auf der *SHARE*-Partition findest.
+* Beim Neustart wird KNULLI auf deiner zweiten SD-Karte automatisch alle Ordner und Dateien anlegen, die du normalerweise im [Nutzerdatenverzeichnis](#das-nutzerdatenverzeichnis) bzw. auf der *SHARE*-Partition findest.
 * Wenn die zweite SD-Karte mit exFAT formatiert ist, kannst du die Karte aus dem Slot nehmen, nachdem du das Gerät heruntergefahren hast, und über deinen Computer mit Daten füllen.
 
+!!! info "Ältere Alpha-Versionen von KNULLI haben auf der zweiten SD-Karte einen Ordner `batocera` angelegt, in dem die Ordner und Dateien des [Nutzerdatenverzeichnisses](#das-nutzerdatenverzeichnis) abgelegt wurden. Um Kompatiblität mit aktuellen KNULLI-Releases sicherzustellen, kannst du einfach den gesamten Inhalt des `batocera`-Ordners auf die oberste Ebene deiner zweiten SD-Karte verschieben."
+
 ## Option 1: Netzwerkübertragung
 
 Netzwerkübertragung kann mit jedem Gerät genutzt werden, das mit dem Internet oder einem lokalen Netzwerk verbunden werden kann. (Das schließt nicht nur Geräte ein, die von sich aus W-LAN- oder kabelnetzwerkefähig sind, sondern auch Geräte, an die man einen externen USB-Dongle anschließen kann.)

docs/play/add-games.md

@@ -1,5 +1,7 @@
 # :material-layers-plus: Adding Games to KNULLI
 
+!!! info "Unlike many other CFWs, KNULLI formats the *SHARE* partition to ext4 by default. The ext4 filesystem is not readable by Windows, so by default, you will not be able to add games in the same way you might be used to from other CFWs. However, some games from the [PortMaster](../../systems/portmaster) library only work on ext4 filesystems because they rely on symbolic links and large swap files. It is possible to [reformat the partition to exFAT](#reformat-the-share-partition-to-exfat) after first boot, however, you should be aware that some PortMaster games might not work on your device if you choose to reformat to exFAT."
+
 KNULLI has a few options for adding games. Depending on the capabilites of your device, you will have to determine which option to choose. For example, some devices do not have networking capabilites, so with those devices you will not be able to use the network transfer options. Additionally, you might have to consider the computer you will use as a data source, since some options are restricted to specific operating systems.
 
 ## Data storage structure
@@ -40,9 +42,11 @@ If you use KNULLI on a device which has a second SD card slot, you may use the s
 * Find the *Storage* section where you can choose your *Storage device*.
     * Switch fom *Internal* (the "internal" storage is the *SHARE* partition of your KNULLI SD card) to the name of your second SD card, e.g., *SHARE - 25.6G*.
 * Reboot KNULLI to apply the changes by pressing the ++"Start"++ button and choosing *Restart system* in the *Quit* section.
-* During reboot, KNULLI will populate the second SD card with a folder named `/batocera` and all the required subfolders you usually find on the *SHARE* partition.
+* During reboot, KNULLI will automatically populate the second SD card with all the folders and files you would usually find in the [userdata folder](#the-userdata-folder)/*SHARE* partition.
 * If your second SD card is formatted to exFAT, you can now take the card out of the device when it is shut off. You can put the card in your computer to access it and populate it with your data.
 
+!!! info "Older alpha versions of KNULLI created a subfolder `batocera` on your SD card and stored the contents of the [userdata folder](#the-userdata-folder)/*SHARE* partition there. To maintain compatibility with current KNULLI releases, simply move the entire contents of the `batocera` folder to the top level of your second SD card."
+
 ## Option 1: Network transfer
 
 Network transfer can be used on any device which can be connected to the internet or a local network. (This includes devices with native networking capabilites and ones where networking can be added through an external dongle.)