Merge pull request #8 from chrizzo-hb/main

Section about networking and german translations

Author: acmeplus

docs/configure/networking.de.md

@@ -0,0 +1,37 @@
+# Netzwerkverbindungen
+
+Viele Geräte, die von KNULLI unterstützt werden, sind in der Lage, sich mit dem Internet oder anderen lokalen Netzwerken zu verbinden. In den meisten Fällen geschieht dies über den eingebauten W-LAN-Adapter. Allerdings unterstützt KNULLI auch Netzwerkverbindungen über USB-Dongles.
+
+## W-LAN
+
+Wenn dein Gerät einen eingebauten W-LAN-Adapter hat, kannst du ihn direkt via KNULLI konfigurieren. Öffne das Hauptmenü, in dem du den ++"Start"++-Button drückst, gehe zu *Network settings* und konfiguriere dort deine W-LAN-Verbindung. Im unteren Abschnitt *Settings* kannst du W-LAN aktivieren (*Enable WIFI*) und dein W-LAN ahand seiner SSID auswählen. Anschließend kannst du den W-LAN-Schlüssel eingeben und das Menü schließen, um mit dem W-LAN zu verbinden.
+
+Im Abschnitt darüber kannst du sehen, ob du gerade mit einem W-LAN verbunden bist. Außerdem siehst du deine aktuelle IP-Adresse und kannst das Netzwerksymbol ein- oder ausschalten.
+
+!!! warning "Standardmäßig ist in KNULLI kein root-Passwort gesetzt. Das bedeutet, dass deine Nutzerdaten-Partition sofort und ohne Passwortschutz zugreifbar ist, sobald du mit einem W-LAN verbindest. In den eigenen vier Wänden mag das ein praktisches Feature sein. Wenn du dein Gerät allerdings mit einem W-LAN verbindest, das nicht unter deiner Kontrolle ist, gehst du damit ein Sicherheitsrisiko ein."
+
+### Zusätzliche Sicherheit
+
+Öffne das Hauptmenü, in dem du den ++"Start"++-Button drückst. Dort kannst du *System settings* auswählen und von dort zum Bereich* Security* gelangen. Dort kannst du über den Schalter *Enforce security* erweiterte Sicherheitsmaßnahmen ein- oder ausschalten. Bitte beachte, dass du das Gerät neustarten musst, um die Änderungen wirksam zu machen.
+
+Wenn du die Sicherheitsmaßnahmen eingeschaltet und das Gerät neu gestartet hast, kannst du in das *Security*-Menü zurückkehren. Unter dem Schalter *Enforce security* erscheint jetzt das aktuelle *root password*. Das Passwort ist zufallsgeneriert und ändert sich manchmal automatisch, wenn Updates installiert werden oder wichtige Einstellungen geändert wurden. Das ist aber kein Grund zur Sorge: Wenn du in dieses Menü zurückkehrst, kannst du jederzeit das aktuelle Root-Passwort einsehen.
+
+Dieses Passwort, in Kombination mit dem Benutzernamen `root`, bildet die Zugangsdaten, mit denen auf dein Gerät via Netzwerk zugegriffen werden kann.
+
+!!! warning "Dir sollte bewusst sein, dass KNULLI für Retro-Gaming und niedrigschwelligen Netzwerkzugang entwickelt wurde. Die erweiterten Sicherheitsmaßnahmen stellen eine zusätzliche Hürde da, um deine Nutzerdaten vor ungewollten Zugriffen zu schützen. Du solltest das Gerät trotzdem nicht mit einem W-LAN verbinden, von dem du nicht sicher bist, dass es sicher ist!"
+
+### Hostname
+
+Der standardmäßige Hostname des Geräts lautet `KNULLI`. Du kannst diesen Namen allerdings ändern, was besonders dann hilfreich sein kann, wenn du mehr als ein KNULLI-betriebenes Gerät in deinem Netzwerk hast. Innerhalb deines Netzwerks sollte der Hostname nach Möglichkeit eindeutig sein.
+
+Um den Hostnamen zu ändern, drücke den  ++"Start"++-Button um das Hauptmenü zu öffnen, gehe dann zu *Network settings*, wo du den *Hostname* anpassen kannst.
+
+Windows-User können den Hostnamen nutzen, um das Gerät in ihrem Netzwerk zu finden und darauf zuzugreifen. Wenn das Gerät eingeschaltet und mit deinem Netzwerk verbunden ist, solltest du es im Windows Explorer im Bereich "Netzwerk" finden. Alternativ kannst du darauf zugreifen, in dem du die Adresse in die Adresszeile des Windows Explorers eingibst.
+
+Der Pfad
+```
+\\KNULLI\share
+```
+
+(wobei du`KNULLI` ggf. mit deinem eigenen Hostnamen ersetzen musst) führt direkt zum `/userdata`-Verzeichnis, wo deine ROMs, BIOSe etc. abgelegt sind. Mehr Informationen dazu findest du im Abschnitt [Spiele hinzufügen](../../play/add-games).
+

docs/configure/networking.md

@@ -0,0 +1,38 @@
+# Networking
+
+Many devices which are supported by KNULLI are capable of connecting to the internet as well as local networks. In most cases, this is achieved by a built-in Wi-Fi adapter. However, KNULLI also supports network connection via USB dongles.
+
+## Wi-Fi
+
+If your device has a built-in Wi-Fi adapter, you can set it up directly via KNULLI. Press the ++"Start"++ button to open the main menu, go to *Network settings* where you can configure your Wi-Fi connection. In the lower *Settings* section, enable Wi-Fi, then select your Wi-Fi by its SSID, enter your Wi-Fi key, and leave the menu to connect to your Wi-Fi.
+
+In the section above, you can see whether you are currently connected to Wi-Fi, see your current IP address and toggle the network indicator on or off.
+
+!!! warning "By default, your KNULLI device does not have a root password set. Consequently, as soon as you connect to a network, the data on your device becomes accessible in your local network without any password protection. While this might be convenient within your own home, it might be a severe security risk when connecting to a network which is not under your control."
+
+### Additional security
+
+Press the ++"Start"++ button to open the main menu, go to *System settings* and find *Security*. There, you can toggle *Enforce security* on or off. Be aware that you need to restart the device for the change to take effect.
+
+After you enabled additioal security and rebooted your device, return to the *Security* menu. Below the toggle to *Enforce security* you will find the *Root password* now. The root password is generated randomly and sometimes changes automatically when the system receives updates or when major settings have been modified. However, you will always be able to look up your current root password by returning to this menu.
+
+The password and the username `root` must now be used to access the device via network.
+
+!!! warning "Be aware, that KNULLI is built for retro gaming and easy network access. While this setting will make it harder to access your userdata partition, you still should not connect your KNULLI-driven device to any unknown local networks."
+
+### Hostname
+
+The default hostname of the device will always be `KNULLI`. However, you can pick your own hostname, which might come in handy if you have more that one KNULLI-driven device in your local network. Within your local network, the hostname should be unique, if possible.
+
+If you want to change the hostname of your device, press the ++"Start"++ button to open the main menu and go to *Network settings* where you can modify the *Hostname*.
+
+Windows users may use the hostname to find the device and access the userdata partition. When the device is turned on and connected to your local network, you will find the device in Windows Explorer at the "Network" section under its hostname. Alternatively, you can access the device directly by typing the path in the address bar of Windows Explorer.
+
+The path
+
+```
+\\KNULLI\share
+```
+
+(replace`KNULLI` with your hostname if you changed it) will lead directly to the `/userdata` folder where you will find your ROMs, BIOSes, etc. See the [Add Games](../../play/add-games) section for more details.
+

docs/index.de.md

@@ -2,27 +2,27 @@
   <img class="off-glb" src="/_inc/images/knulli-booting-up.png"/>
 </div>
 
-# Willkommen auf dem KNULLI Wiki :material-gamepad:
+# Willkommen im KNULLI-Wiki :material-gamepad:
 
-KNULLI ist eine benutzerdefinierte Firmware (CFW) für Retro-Gaming-Geräte (Handhelds, Bartops, etc.). Knulli wurde als eine Abspaltung von [Batocera](https://batocera.org) entwickelt und versucht Geräte zu unterstützen, die unter mindestens eine dieser Kategorien fallen:
+KNULLI ist eine unabhängige Custom-Firmware (CFW) für Retro-Gaming-Konsolen (Handhelds, Bartops, etc.). Knulli wird als Fork von [Batocera](https://batocera.org) entwickelt und verfolgt das Ziel, Geräte zu unterstützen, die unter mindestens eine dieser Kategorien fallen:
 
--   Es sind kein quelloffenenr Kernel- und/oder u-boot-Quellcode verfügbar
--   Es gibt Quellcode, aber der Kernel ist entweder nicht Mainline und/oder zu alt (z.B. Geräte mit einem BSP Kernel 3.4 wie der Egret II Mini)
--   Es gibt keine GPU-Unterstützung oder die GPU wird nicht unterstützt, also ist Framebuffer die einzige Option
+-   Es ist kein quelloffener Kernel- und/oder u-boot-Code verfügbar
+-   Es gibt Quellcode, aber der Kernel ist nicht Mainline und/oder zu alt (z.B. Geräte mit einem BSP Kernel 3.4 wie der Egret II Mini)
+-   Es gibt keine GPU-Unterstützung oder die GPU wird nicht unterstützt, d.h. Framebuffer ist die einzige Option
 -   Es ist ein Gerät, das ich besitze und für das ich beschlossen habe eine CFW zu bauen
 
-## Eigenschaften
+## Features
 
-KNULLI unterstützt Geräte mit GPU (GLES-Unterstützung) und nur Framebuffer (Legacy).
+KNULLI unterstützt sowohl Geräte mit GPU (GLES-Unterstützung) als auch Geräte, die nur über Framebuffer verfügen (Legacy).
 
--   Emulation Station Oberfläche für GPU-basierte Geräte
--   Simplemenu/Simplermenu+ für reine Framebuffer-Geräte (auch für GPU-Geräte, falls gewünscht)
+-   Emulation Station als Frontend für GPU-basierte Geräte
+-   Simplemenu/Simplermenu+ als Frontend für reine Framebuffer-Geräte (auch für GPU-Geräte, wenn bevorzugt)
 -   RetroArch inklusive mehrerer libretro-Kerne
--   WLan- und Bluetooth-Unterstützung (einschließlich Audio), sofern vom Gerät unterstützt
--   Unterstützung für externe USB-WLan-Dongles für Geräte ohne interne Wireless-Karte
+-   W-LAN- und Bluetooth-Unterstützung (einschließlich Audio), sofern vom Gerät unterstützt
+-   Unterstützung für externe USB-W-LAN-Dongles für Geräte ohne interne Wireless-Karte
 -   RetroAchievements
 -   Netplay
--   Unterstützung für Cover Art/Thumbnail Scrapper
+-   Unterstützung für Cover-Art/Thumbnail Scraper
 
 ## Community
 
@@ -32,14 +32,14 @@ KNULLI nutzt Discord und [:simple-github: GitHub](https://github.com/knulli-cfw/
 
 KNULLI ist eine Linux-Distribution, die sich aus vielen Open-Source-Komponenten zusammensetzt. Die Komponenten werden unter ihren jeweiligen Lizenzen bereitgestellt. Diese Distribution enthält Komponenten, die nur für den nicht-kommerziellen Gebrauch lizenziert sind.
 
-### Drittanbieter Komponenten
+### Drittanbieter-Komponenten
 
-Alle andere Software wird unter der jeweiligen Lizenz der einzelnen Komponenten bereitgestellt. Diese Lizenzen sind in den Software-Quellen oder im Lizenzordner dieses Projekts zu finden. Änderungen an gebündelter Software und Skripten durch das KNULLI-Team werden unter den Bedingungen der modifizierten Software lizenziert.
+Alle eingebundenen Software-Komponenten werden unter den jeweiligen Lizenzen der einzelnen Komponenten bereitgestellt. Diese Lizenzen sind in den Software-Quellen oder im Lizenzordner dieses Projekts zu finden. Alle Änderungen an den eingebundenen Softwarekomponenten und Skripten durch das KNULLI-Team werden unter den Bedingungen der jeweiligen modifizierten Software lizenziert.
 
 ### Kernel und Bootloader
 
-Die Versionen für einige Geräte enthalten Kernel und/oder Bootloader, für die kein Quellcode verfügbar ist, weil der Hersteller sie nicht veröffentlicht hat. In diesen Fällen enthält die gerätespezifische Seite Anweisungen, um diese aus der Standard-Firmware zu extrahieren.
+Die Versionen für einige Geräte enthalten Kernel und/oder Bootloader, für die kein Quellcode verfügbar ist, weil der Hersteller den Quellcode nicht veröffentlicht hat. In diesen Fällen enthält die gerätespezifische Seite Anweisungen, um diese aus der Standard-Firmware zu extrahieren.
 
 ## Credits
 
-Dieses Projekt ist nicht das Werk einer einzelnen Person, sondern das Werk vieler Personen auf der ganzen Welt, die die Open-Source-Bits entwickelt haben, ohne die dieses Projekt nicht existieren könnte. Besonderer Dank gilt Batocera, muOS, JelOS, CoreELEC, LibreELEC und den Entwicklern und Mitwirkenden der gesamten Open-Source-Gemeinschaft.
+Dieses Projekt ist nicht das Werk einer einzelnen Person, sondern das Werk vieler Personen auf der ganzen Welt, die die Open-Source-Komponenten entwickelt haben, ohne die dieses Projekt nicht existieren könnte. Besonderer Dank gilt Batocera, muOS, JelOS, CoreELEC, LibreELEC und den Entwicklern und Mitwirkenden der gesamten Open-Source-Gemeinschaft.