Extracted reset-to-factory-settings from update

chrizzo-hb · chrizzo-hb · commit 19f5fe222f84 · 2024-07-25T19:14:19.000+02:00
diff --git a/docs/configure/reset-to-factory-settings.de.md b/docs/configure/reset-to-factory-settings.de.md
@@ -0,0 +1,31 @@
+#  :material-folder-refresh: Auf Werkseinstellungen zurücksetzen
+
+!!! danger "Den gesamten `system`-Ordner zurücksetzen"
+
+     **Normalerweise** erfordern KNULLI-Updates **NICHT**, dass du den gesamten `system`-Ordner zurückgesetzt. Das Zurücksetzen des `system`-Ordners kommt dem **Zurücksetzen auf Werkseinstellungen** gleich. Dementsprechend ist es danach zwingend nötig, **alle deine Einstellungen erneut vorzunehmen**. Du solltest **NICHT** versuchen, den `system`-Ordner zurückzusetzen, wenn du dir nicht absolut sicher bist, dass es notwendig ist.
+
+Wie du wahrscheinlich bereits weißt, sind **deine gesamten Einstellungen** in deinem `userdata/system`-Ordner gespeichert, wie im Abschnitt [Speicherort für Spiele](../../play/add-games/game-storage) erklärt.
+
+Wenn dein System sich nicht mehr Erwartungskonform verhält, nachdem du eine Einstellung geändert hast, und du die Änderung nicht rückgängig machen kannst, kannst du das Problem möglicherweise lösen, in dem du die entsprechende Konfigurationsdatei oder den gesamten `system`-Ordner zurücksetzt. In **SEHR seltenen Fällen** kann es auch nötig sein, nach einem Update einige Einstellungen auf neue KNULLI-Standardwerte zu setzen, indem die entsprechenden Dateien im `system`-Ordner **ersetzt** oder **angepasst** werden.
+
+Der einfachste Weg um dieses Ziel zu erreichen ist, die entsprechenden Dateien **oder** den gesamten Ordner zu **entfernen**. Während des nächsten Bootvorgangs wird KNULLI die fehlenden Dateien mit neuen Dateien ersetzen, die dann die aktuellen KNULLI-Standardeinstellungen enthalten.
+
+Wenn du eine einzelne Konfigurationsdatei (oder den gesamten `system`-Ordner) zurücksetzen musst oder möchtest, greif dazu zunächst auf deinen `userdata`-Ordner zu, wie du es sonst auch machst, oder benutz den mitgelieferten *OD-Commander* aus der Kategorie *Ports*. Wir **empfehlen dringend**, dass du die betroffenen Dateien **oder** den `system`-Ordner **umbenennst** statt zu löschen, indem du `.bak` ans Ende des Dateinamens schreibst (also z.B. den `system`-Ordner in `system.bak` umbenennst). Auf diese Weise kannst du deine alten Einstellungen jederzeit wiederherstellen, oder einzelne Dateien/Zeilen aus deiner alten Konfiguration übernehmen.
+
+### Dateien und Ordner mit OD-Commander umbenennen
+
+* Öffne die Kategorie *Ports*.
+* Starte *OD-Commander*.
+* Du solltest jetzt bereits den Inhalt deines `userdata`-Ordners auf der linken Seite sehen, du kannst dies u.A. an der Überschrift `/userdata` erkennen. Falls du noch nicht dort bist, navigiere zunächst nach `/userdata`, indem du mit oben/unten auf dem D-Pad hoch und runter navigierst und mit OK/Zurück in Ordner hineingehst oder sie wieder verlässt.
+* Lokalisiere den `system`-Ordner auf der linken Bildschirmseite.
+* Während der Fokus auf dem `system`-Ordner liegt
+     * öffne **entweder** den Ordner und suche darin die einzelnen Dateien oder Unterordner, die du zurücksetzen möchtest
+     * **oder** halte den Fokus einfach auf dem `system`-Ordner falls du den ganzen Ordner zurücksetzen möchtest.
+* Wenn du den Fokus auf einer Datei oder einem Ordner hast, die/den du zurücksetzen möchtest
+    * drück ++"X"++ um das Datei-Menü zu öffnen.
+    * wähle *Rename*.
+    * benutz die On-Screen-Tastatur um den Datei-/Ordnernamen zu ändern.
+
+### Konfigurationsdateien zurücksetzen
+
+Anschließend kannst du dein KNULLI-Gerät neu starten. Es wird alle fehlenden Dateien und Ordner während des Bootvorgangs neu erzeugen. Du kannst jetzt entweder alle deine Einstellungen wieder händisch über die KNULLI-GUI vornehmen, oder die Konfigurationsdateien mit deiner `.bak`-Sicherung vergleichen und Zeile für Zeile alle Einstellungen übernehmen, die du behalten möchtest.
diff --git a/docs/configure/reset-to-factory-settings.md b/docs/configure/reset-to-factory-settings.md
@@ -0,0 +1,33 @@
+#  :material-folder-refresh: Reset To Factory Settings
+
+!!! danger "Re-creating the entire `system` folder"
+
+     **Usually**, KNULLI updates will **NOT** require you to re-create your entire `system` folder. Re-creating the `system` folder corresponds to **resetting to factory defaults**. Consequently, it will force you to **re-configure a lot of settings manually** since they will be gone afterwards! Do **NOT** do this, unless you are absolutely sure it is required.
+
+As you might already know, **all your settings** are stored in your `userdata/system` folder as explained in the [Game Storage](../../play/add-games/game-storage) section.
+
+If your system does not work as expected after you changed a setting and you can't find a way to undo said setting, your issue might still be fixed by resetting the corresponding configuration file or the entire `system` folder to factory settings. In **VERY rare cases**, it might also be required to adapt your settings to new KNULLI defaults by **replacing/updating some files** in that `system` folder after you installed an update.
+
+The easiest way to achieve that is by just **removing** either the respective files **or** the entire folder. During the next boot, KNULLI will replace all the missing files with new files which contain the default settings.
+
+## Back up your current settings
+
+If you want or need to re-create a configuration file (or the entire `system` folder) with default settings, access your `userdata` folder the same way you always access it. Alternatively, you can use the built-in *OD-Commander* from the *Ports* category. Either way, we **strongly suggest** that you **rename** the `system` folder **or** the files you want to replace by adding a suffix like `.bak` (e.g., rename from `system` to `system.bak`). This way, you will be able to put your old settings back entirely or hand-pick single files/lines from your old settings.
+
+### Renaming files/folders with OD-Commander
+
+* Go to the *Ports* category.
+* Find and launch *OD-Commander*.
+* You should already see the contents of your `userdata` folder on the left side, indicated by the headline `/userdata`. If you are not there, yet, navigate to `/userdata` by using up/down on the D-pad to navigate and the OK/Back buttons to enter/leave a folder.
+* Locate the `system` folder on the left side of the screen.
+* While the focus is on the `system` folder
+     * **either** enter the folder and locate the single files or subfolders you want to re-create
+     * **or** just stay, if you want to re-create the entire system folder.
+* Once you have moved the focus on a file/folder you want to re-create
+    * press ++"X"++ to open the file menu.
+    * select *Rename*.
+    * use the on-screen keyboard to rename the file/folder.
+
+### Re-create your configuration files
+
+Afterwards, reboot your KNULLI device. It will re-create the missing files and folders from KNULLI defaults. Now, you can either re-configure all your settings via the EmulationStation GUI or you can hand-pick configuration details by comparing your old settings (`.bak`) with the new ones.
diff --git a/docs/play/update.de.md b/docs/play/update.de.md
@@ -24,14 +24,6 @@ Du kannst die KNULLI-Installation auf deinem Gerät aktualisieren, indem du das
     * **Benenne** die datei `batocera.update` in `batocera` **um**.
 5. Starte das Gerät erneut, um mit dem Updatevorgang zu beginnen!
 
-## Den `system`-Ordner zurücksetzen
+!!! danger "Re-creating default settings"
 
-!!! danger "Den `system`-Ordner zurücksetzen"
-
-     **Normalerweise** erfordern KNULLI-Updates **NICHT**, dass du den gesamten `system`-Ordner zurückgesetzt. Das Zurücksetzen des `system`-Ordners kommt dem **Zurücksetzen auf Werkseinstellungen** gleich. Dementsprechend ist es danach zwingend nötig, **alle deine Einstellungen erneut vorzunehmen**. Du solltest **NICHT** versuchen, den `system`-Ordner zurückzusetzen, wenn du dir nicht absolut sicher bist, dass es notwendig ist.
-
-Wie du wahrscheinlich bereits weißt, sind **deine gesamten Einstellungen** in deinem `userdata/system`-Ordner gespeichert, wie im Abschnitt [Speicherort für Spiele](../add-games/game-storage) erklärt. In **SEHR seltenen Fällen** kann es nötig sein, nach einem Update einige Einstellungen auf neue KNULLI-Standardwerte zu setzen, indem die entsprechenden Dateien im `system`-Ordner **ersetzt** oder **angepasst** werden. Der einfachste Weg um dieses Ziel zu erreichen ist, die entsprechenden Dateien **order** den gesamten Ordner zu **entfernen**. Während des nächsten Bootvorgangs wird KNULLI die fehlenden Dateien mit neuen Dateien ersetzen, die dann die aktuellen KNULLI-Standardeinstellungen enthalten.
-
-Wenn du eine einzelne Konfigurationsdatei (oder den gesamten `system`-Ordner) zurücksetzen musst oder möchtest, greif dazu zunächst auf deinen `userdata`-Ordner zu, wie du es sonst auch machst. Wir **empfehlen dringend**, dass du die betroffenen Dateien **oder** den `system`-Ordner **umbenennst** statt zu löschen, indem du `.bak` ans Ende des Dateinamens schreibst (also z.B. den `system`-Ordner in `system.bak` umbenennst).
-
-Anschließend kannst du dein KNULLI-Gerät neu starten. Es wird alle fehlenden Dateien und Ordner während des Bootvorgangs neu erzeugen. Du kannst jetzt entweder alle deine Einstellungen wieder händisch über die KNULLI-GUI vornehmen, oder die Konfigurationsdateien mit deiner `.bak`-Sicherung vergleichen und Zeile für Zeile alle Einstellungen übernehmen, die du behalten möchtest.
+     **Normalerweise** erfordern KNULLI-Updates **NICHT** dass du einzelne Dateien oder gar den ganzen `system`-Ordner auf Werkseinstellungen zurücksetzt. In **SEHR seltenen Fällen** kann es allerdings nötig sein, deine Einstellungen an neue KNULLI-Standardeinstellungen anzupassen. In diesen Fällen ist es häufig am einfachsten, die entsprechenden Werkseinstellungen wiederherzustellen, entweder in dem man einzelne Dateien oder ganze Ordner zurücksetzt. Du kannst mehr über das Thema im Abschnitt [Werkseinstellungen](../../configure/reset-to-factory-settings) erfahren. Du solltest dies aber **NIEMALS** tun, wenn du dir nicht absolut sicher bist, dass es notwendig ist!
diff --git a/docs/play/update.md b/docs/play/update.md
@@ -24,14 +24,6 @@ KNULLI can be updated by downloading the **boot package** for your device and re
     * **Rename** `batocera.update` to `batocera`.
 5. Reboot the device, and the update will begin automatically.
 
-## Re-creating contents of the `system` folder
+!!! danger "Re-creating default settings"
 
-!!! danger "Re-creating the `system` folder"
-
-     **Usually**, KNULLI updates will **NOT** require you to re-create your entire `system` folder. Re-creating the `system` folder corresponds to **resetting to factory defaults**. Consequently, it will force you to **re-configure a lot of settings manually** since they will be gone afterwards! Do **NOT** do this, unless you are absolutely sure it is required.
-
-As you might already know, **all your settings** are stored in your `userdata/system` folder as explained in the [Game Storage](../add-games/game-storage) section. In some **VERY rare cases**, it might be required to adapt your settings to new KNULLI defaults by **replacing/updating some files** in that `system` folder after you installed an update. The easiest way to achieve that is by just **removing** either the respective files **or** the entire folder. During the next boot, KNULLI will replace all the missing files with new files which contain the default settings.
-
-If you want or need to re-create a configuration file (or the entire `system` folder) with default settings, access your `userdata` folder the same way you always access it. We **strongly suggest** that you **rename** the `system` folder **or** the files you want to replace by adding a suffix like `.bak` (e.g., rename from `system` to `system.bak`)
-
-Afterwards, reboot your KNULLI device. It will re-create the missing files and folders from KNULLI defaults. Now, you can either re-configure all your settings via the EmulationStation GUI or you can hand-pick configuration details by comparing your old settings (`.bak`) with the new ones.
+     **Usually**, KNULLI updates will **NOT** require you to re-create neither a single configuration file nor your entire `system` folder. However, in **VERY rare cases** it might be required to adapt your configuration to new KNULLI default settings. In those cases, the easiest way is to reset to factory settings, either by re-creating single files or sometimes the entire `system` folder. You can learn more about it in the [Reset to factory settings](../../configure/reset-to-factory-settings) section, however, do **NOT** do this, unless you are absolutely sure it is required!
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -149,6 +149,7 @@ plugins:
             Background Music: Hintergrundmusik
             Bezel Decorations: Bezel-Dekorationen
             Boot Logo: Bootlogo
+            Factory Settings: Werkseinstellungen
         - locale: pl
           name: Polski
           build: true
@@ -274,10 +275,12 @@ nav:
         - Bezel Decorations: configure/customization/bezel-decorations.md
         - Boot Logo: configure/customization/bootlogo.md
       - SSH: configure/ssh.md
+      - Reset t
       - Retroarch:
         - Controls: configure/retroarch/controls.md
       - PPSSPP:
         - Cheats: configure/ppsspp/cheats.md
+      - Factory Settings: configure/reset-to-factory-settings.md
     - Systems:
       - Engines:
         - Pico-8: systems/pico-8.md
