Merge pull request #43 from chrizzo-hb/public-releases-2024-07

CAREFUL - Adapted wiki to new public releases

Author: chrizzo-hb

docs/_inc/images/knulli-booting-rg40xx-h.png

@@ -0,0 +1,25 @@
+# :material-bluetooth: Bluetooth
+
+KNULLI unterstützt eine ganze Reihe verschiedener Bluetooth-Geräte, z.B. Eingabegeräte (Controller, Mäuse, Tastaturen, etc.) und Audiogeräte (Kopfhörer, Lautsprecher, etc.).
+
+## Bluetooth-Geräte verbinden
+
+Um ein Bluetooth-Gerät mit deinem KNULLI-Gerät zu verbinden, musst du zunächst sicherstellen, dass beide Geräte Bluetooth unterstützen. Wenn beide Geräte Bluetooth unterstützen, kannst du auf ++"Start"++ drücken, um das Hauptmenü zu öffnen und *Controller & Bluetooth Settings* auswählen. Hier kannst du bei *Enable Bluetooth* zunächst Bluetooth einschalten, falls es nicht schon eingeschaltet ist.
+
+Anschließend kannst du entweder versuchen, alle Eingabegeräte in deiner Nähe automatisch zu erkennen und zu verbinden, in dem du *Pair Bluetooth Pads Automatically* auswählst. Alternativ kannst du *Pair A Bluetooth Device Manually* auswählen, um dein Gerät aus einer Liste in der Nähe befindlicher Bluetooth-Geräte auszuwählen. Falls dein Gerät in der Liste nicht angezeigt wird, oder das Bluetooth-Pairing fehlschlägt, schau in das Handbuch deines Geräts und such dort nach der Anleitung für Bluetooth-Verbindungen.
+
+!!! info "Problemlösung"
+
+    Falls dein KNULLI-Gerät dein Gerät nicht findet oder du Verbindungsprobleme hast, deaktiviere den W-LAN-Zugiff deines KNULLI-Geräts während des Verbindungsaufbaus (Pairing).
+
+### Controller zuordnen
+
+Wenn du deine Geräte erfolgreich verbunden hast, musst du möglicherweise weitere Schritte ergreifen, um sie zu benutzen. Wenn du beispielsweise einen Bluetooth-Controller verbunden hast, wirst du ihn anschließend einem *Spieler* *zuordnen* müssen, wie im Abschnitt [Controller](../controls) beschrieben.
+
+### Audiogeräte aktivieren
+
+Nachdem du ein Audiogerät (z.B. einen Kopfhörer) verbunden hast, musst du ihn als Audio-Ausgabegerät einrichten. Drück ++"Start"++ um das Hauptmenü zu öffnen, gehe zu *System Settings* und wähle dort dein Audio-Gerät als *Audio Output*.
+
+## Bluetooth-Geräte vergessen
+
+Wenn du ein Bluetooth-Gerät entfernen bzw. "vergessen" möchtest, drück auf ++"Start"++ um ins Hauptmenü zu gelangen, geh zu *Controller & Bluetooth Settings*, öffne *Forget A Bluetooth Device*, wähle dort das entsprechende Gerät aus und entferne es.

docs/configure/bluetooth.de.md

@@ -0,0 +1,25 @@
+# :material-bluetooth: Bluetooth
+
+KNULLI supports a lot of different types of Bluetooth devices, such as input devices (controllers, mice, keyboards, etc.) and audio speakers and headphones.
+
+## Connect a Bluetooth device
+
+To connect a Bluetooth device with your KNULLI device, you first need to make sure that both devices support Bluetooth. If so, press ++"Start"++ to bring up the main menu and go to *Controller & Bluetooth Settings*. Here, you will be able to *Enable Bluetooth* if it is not enabled, yet.
+
+Once Bluetooth is enabled, either try to *Pair Bluetooth Pads Automatically* (to automatically pair input-devices in pairing mode) or select *Pair A Bluetooth Device Manually* and find your device in a list of available Bluetooth devices in your vicinity. If your Bluetooth device does not show up or pairing does not work as expected, check the manual of your Bluetooth device for pairing instructions.
+
+### Assing controllers
+
+After your devices have been paired successfully, you might need to take additional steps in order to use them. For example, after connecting a Bluetooth controller, you will have to **assign** the controller to a **player** as explained in the [Controls](../controls) section.
+
+### Set up audio output
+
+After pairing an audio output device (like a headphone), you need to set it as your audio output. Press ++"Start"++ to bring up the main menu, head to *System Settings* and choose your Blueooth device as *Audio output*.
+
+!!! info "Troubleshooting"
+
+    If your KNULLI device fails to pair with one of your Bluetooth devices, try disabling Wi-Fi while pairing.
+
+## Forget a Bluetooth device
+
+If you want to remove or "forget" a paired Bluetooth device, press the ++"Start"++ button to bring up the main menu, head to *Controller & Bluetooth Settings*, open *Forget A Bluetooth Device*, find the device and remove it.

docs/configure/bluetooth.md

@@ -1,36 +1,47 @@
 # :material-controller: Controller
 
-!!! info "Tastenbelegung nach der Installation einrichten"
-    Je nachdem, welches Gerät und welche KNULLI-Version du benutzt, kann es notwendig sein, nach der Installation zunächst deinen Controller einzurichten, bevor du losspielen kannst.
+!!! danger "Hardware-Setup nicht mit der Tastebelegung für Spiele verwechseln!"
 
-Obwohl KNULLI eigentlich für Handheld-Geräte entwickelt wurde, unterstützt es zusätzlich viele verschiedene Arten von USB- und Bluetooth-Controllern. Bevor du einen Controller an deinem KNULLI-Gerät verwenden kannst, kann es allerdings nötig sein, die Tasten des Controllers ihren jeweiligen Funktionen zuzuordnen.
+    Verwechsel die Einrichtung des Controllers nicht mit der Anpassung der Tastenbelegung für einzelne **Spiele** oder **Emulatoren**! In diesem Abschnitt geht es um die **generelle** Einrichtung der **Hardware**. Wenn du die Tastenbelegung für einzelne **Spiele**, emulierte Konsolen oder die dafür eingesetzten **Emulatoren** anpassen möchtest, schau bitte in die Anleitung für den jeweiligen Emulator (z.B. [Retroarch](../retroarch/controls)).
 
-!!! danger "Hardware-Setup nicht mit der Tastebelegung für Spiele verwechseln!"
-    Verwechsel die Einrichtung des Controllers nicht mit der Anpassung der Tastenbelegung für einzelne *Spiele* oder *Emulation-Cores*! In diesem Abschnitt geht es um die *generelle* Einrichtung der *Hardware*. Wenn du die Tastenbelegung für einzelne *Spiele*, emulierte Konsolen oder die dafür eingesetzten *Emulation-Cores* anpassen möchtest, schau bitte in die Anleitung für den jeweiligen *Core* (z.B. [Retroarch](../retroarch/controls)).
+Obwohl KNULLI eigentlich für Handheld-Geräte entwickelt wurde, unterstützt es zusätzlich viele verschiedene Arten von USB- und Bluetooth-Controllern.
+
+Bevor du einen Controller an deinem KNULLI-Gerät verwenden kannst, kann es allerdings nötig sein, die Tasten des Controllers ihren jeweiligen Funktionen zuzuordnen.
+
+## Der eingebaute "Controller"
+
+Die meisten KNULLI-kompatiblen Geräte sind Handhelds mit fest verbauten Eingabemöglichkeiten. Dazu gehört üblicherweise ein **Steuerkreuz** (:material-gamepad:, "directional pad" kurz: **D-pad**), die sogenannten **Face-Buttons** (:material-gamepad-circle:), zwei **Schultertasten** (++"L1"++, ++"R1"++) und zwei **Schulter-Trigger** (++"L2"++, ++"R2"++) sowie die Tasten ++"Start"++ und ++"Select"++. Darüber hinaus hat dein Gerät wahrscheinlich eine **Power-Taste** zum Ein- und Ausschalten, und eine **Funktionstaste** (++"Function"++). **Zusätzlich** hat dein Gerät möglicherweise noch **Analog-Sticks** und eine **Reset-Taste**. Wenn du nicht weißt, welche Knöpfe dein Gerät hat und wo sie sich befinden, wird bitte einen Blick ins Handbuch des Geräts.
+
+KNULLI bringt eine ganze Reihe vordefinierter **Hotkey-Shortcuts** mit - Tastenkombinationen, mit denen du dein Spiel speichern, laden und beenden kannst, Screenshots anfertigen kannst, uvm. Wir empfehlen dir dringend, die Hotkey-Shortcuts zu **lernen** und wir raten dringend **davon ab**, die Hotkey-Shortcuts zu verändern. Eine Liste aller möglichen Hotkey-Shortcuts findest du im Abschnitt  [Hotkey Shortcuts](../../play/hotkey-shortcuts).
+
+!!! info "Controller-Namen"
+
+    Je nachdem, welches Gerät du verwendest, wird der fest verbaute "Controller" deines Geräts einen eigenen Namen haben. Auf dem Anbernic RG40XX H beispielsweise heißt der eingebaute Controller `anbernic-keys`.
+
+## Controller zuweisen
+
+Nachdem du einen Controller verbunden hast, kannst du ihn sofort benutzen, um durch die EmulationStation-GUI zu navigieren. Allerdings musst du den Controller einem **Spieler** zuweisen, damit du ihn auch **zum Spielen** nutzen kannst. Standardmäßig ist nur der **eingebaute "Controller"** immer **Spieler 1** zu geordnet. Nachdem du weitere Controller hinzugefügt hast, musst du sie daher den jeweiligen Spielern zuweisen.
+
+Drück ++"Start"++ um ins Hauptmenü zu gelangen und wähle *Controller & Bluetooth Settings*. Am unteren Ende des Menüs findest du die Controller-Zuordnungen für die Spieler 1-8. Hier kannst du jedem Spieler seinen eigenen Controller zuweisen.
+
+!!! info "Controller-Zuweisungen werden nach dem Neustart zurückgesetzt"
+
+    Dein KNULLI-Gerät merkt sich nicht, welcher Controller in einer vorherigen Session welchem Spieler zugeordnet war. Du solltest daher immer sicherstellen, dass alle Controller den richtigen Spielern zugeordnet sind, nachdem du sie (erneut) mit deinem KNULLI-Gerät verbunden hast.
 
 ## Controller einrichten
 
+!!! danger "Versuch nicht, die eingebauten Controller erneut zu einzurichten"
+
+    Jedes KNULLI-Image ist **optimiert** für das jeweilige Gerät, für das das Image vorgesehen ist. Insbesondere die eingebauten "Controller" sind bereits **fertig konfiguriert**. Du solltest **nicht** versuchen, die Einrichtung über das Menü *Controller & Bluetooth Settings* erneut durchzuführen. Bei manchen Geräten könntest du damit z.B. die virtuellen Eingabemöglichkeiten **dauerhaft löschen** (z.B. die **D-Pad-als-virtueller-Stick-Zuordnung** für Geräte ohne Analog-Sticks, die du üblicherweise mit der Tastenkombination ++"Function"+++++"Select"++ ein- und ausschalten kannst). Wenn du die Tastenbelegung für ein **Spiel** oder eine Konsole anpassen möchtest, erledige das bitte in den dafür vorgesehenen Emulatoreinstellungen. Das Menü *Controller & Bluetooth Settings* ist **nicht** der richtige Ort um Tastenbelegungen für einzele Spiele oder Konsolen zu konfigurieren!
+
 Um einen Controller einzurichten, musst du alle Buttons und Richtungseingaben ihren jeweiligen Funktionen zuordnen. Drücke dazu zunächst auf ++"Start"++ um das Hauptmenü zu öffnen, gehe zu *Controller & Bluetooth Settings* und wähle dort *Controller Mapping*. Folge jetzt einfach den Anweisungen auf dem Bildschirm. Du wirst zunächst aufgefordert, einen beliebigen Knopf auf dem Controller, den du einrichten möchtest, gedrückt zu halten. Anschließend wirst du Schritt für Schritt durch die Einrichtung geführt. Drücke einfach immer den Button, der am besten zu dem Button passt, der gerade auf dem Bildschirm angezeigt wird.
 
 Falls du mal danebendrückst, mach dir keine Sorgen: Du kannst jederzeit in das Menü zurückkehren und die Einrichtung erneut versuchen.
 
 !!! danger "Face-Buttons werden anhand der "Himmelsrichtung" identifiziert!"
     KNULLI unterstützt verschiedene Handhelds und Controller von verschiedenen Herstellern. Abhängig davon, welches Gerät du gerade benutzt, kann die Beschriftung der "Face-Buttons" sich voneinander unterscheiden. Deshalb identifiziert KNULLI diese Tasten nicht anhand ihrer Beschriftung, sondern anhand ihrer "Himmelsrichtung".
 
-    Beispielsweise ist der **nördliche** der vier Face-Buttons (:material-gamepad-circle-up:) auf dem SNES-Controller und auf den meisten Anbernic-Geräten mit ++"X"++ beschriftet. Die gleiche Taste ist auf dem Xbox-Controller mit ++"Y"++ beschriftet, auf dem PlayStation-Controller mit ++"△"++.
+    Beispielsweise ist der **nördliche** der vier Face-Buttons (:material-gamepad-circle-up:) auf dem SNES-Controller mit ++"X"++ beschriftet. Die gleiche Taste ist auf dem Xbox-Controller mit ++"Y"++ beschriftet, auf dem PlayStation-Controller mit ++"△"++.
 
     Achte darauf, dass du die **Face-Buttons** (:material-gamepad-circle-up: :material-gamepad-circle-right: :material-gamepad-circle-down: :material-gamepad-circle-left:) **nicht** mit den **Steuerkreuz-Richtungen** (:material-gamepad-up: :material-gamepad-right: :material-gamepad-down: :material-gamepad-left:) verwechselst! Im Abschnitt [Hotkey-Shortcuts](../../play/hotkey-shortcuts) findest du weitere Informationen bzgl. der Face-Buttons.
 
-
-## Bluetooth-Controller verbindenn
-Um einen Bluetooth-Controller mit deinem KNULLI-Gerät zu verbinden, musst du zunächst sicherstellen, dass sowohl das Gerät als auch der Controller Bluetooth unterstützen. Wenn beide Geräte Bluetooth unterstützen, kannst du auf ++"Start"++ drücken, um das Hauptmenü zu öffnen und *Controller & Bluetooth Settings* auszuwählen. Hier kannst du bei *Enable Bluetooth* zunächst Bluetooth einschalten, falls es nicht schon eingeschaltet ist.
-
-Anschließend kannst du entweder versuchen, den Controller automatisch zu erkennen, in dem du *Pair Bluetooth Pads Automatically* auswählst, oder *Pair A Bluetooth Device Manually* auswählen, um den Controller aus einer Liste in der Nähe befindlicher Bluetooth-Geräte auszuwählen. Falls dein Controller in der Liste nicht angezeigt wird, oder das Bluetooth-Pairing fehlschlägt, schau in das Handbuch deines Controllers und such nach der Anleitung für Bluetooth-Verbindungen.
-Wenn der Bluetooth-Controller verbunden ist, solltest du überprüfen, ob du den [Controller einrichten](#controller-einrichten) musst..
-
-!!! info "Andere Blueooth-Geräte"
-    KNULLI unterstützt auch andere Bluetooth-Geräte, z.B. Mäuse, Kopfhörer und Lautsprecher.
-
-## Bluetooth-Controller vergessenn
-
-Wenn du einen Bluetooth-Controller entfernen bzw. "vergessen" möchtest, drück auf ++"Start"++ um ins Hauptmenü zu gelangen, geh zu *Controller & Bluetooth Settings*, öffne *Forget A Bluetooth Device*, wähle dort den entsprechenden Controller aus und entferne ihn.