docs(i18n): add more languages (#85)

Author: neverforward

docs/.vitepress/config.mts

@@ -7,9 +7,13 @@ const LOCALE_STORAGE_KEY = "levilauncher-docs-locale";
 
 // Supported locale identifiers
 const ENGLISH_LOCALE = "en-US";
+const SPANISH_LOCALE = "es-ES";    // Spanish (Spain)
 const CHINESE_CN_LOCALE = "zh-CN";
 const CHINESE_HK_LOCALE = "zh-HK"; // Traditional Chinese (Hong Kong)
 const RUSSIAN_LOCALE = "ru-RU";    // Russian
+const GERMAN_LOCALE = "de-DE";     // German
+const JAPANESE_LOCALE = "ja-JP";   // Japanese
+const FRENCH_LOCALE = "fr-FR"; // French
 
 /**
  * Removes the base path from the given pathname.
@@ -53,6 +57,30 @@ function normalizePath(pathname: string): string {
 function getLocaleFromPath(pathname: string, base: string): string {
   const normalizedPath = normalizePath(stripBase(pathname, base));
 
+  // Check for Spanish
+  if (
+    normalizedPath === `/${SPANISH_LOCALE}` ||
+    normalizedPath.startsWith(`/${SPANISH_LOCALE}/`)
+  ) {
+    return SPANISH_LOCALE;
+  }
+
+  // Check for Japanese
+  if (
+    normalizedPath === `/${JAPANESE_LOCALE}` ||
+    normalizedPath.startsWith(`/${JAPANESE_LOCALE}/`)
+  ) {
+    return JAPANESE_LOCALE;
+  }
+
+  // Check for German
+  if (
+    normalizedPath === `/${GERMAN_LOCALE}` ||
+    normalizedPath.startsWith(`/${GERMAN_LOCALE}/`)
+  ) {
+    return GERMAN_LOCALE;
+  }
+
   // Check for Russian
   if (
     normalizedPath === `/${RUSSIAN_LOCALE}` ||
@@ -77,6 +105,14 @@ function getLocaleFromPath(pathname: string, base: string): string {
     return CHINESE_CN_LOCALE;
   }
 
+  // Check for French
+  if (
+    normalizedPath === `/${FRENCH_LOCALE}` ||
+    normalizedPath.startsWith(`/${FRENCH_LOCALE}/`)
+  ) {
+    return FRENCH_LOCALE;
+  }
+
   // Default to English
   return ENGLISH_LOCALE;
 }
@@ -91,9 +127,12 @@ function readStoredLocale(): string | null {
     // Validate that the stored value is a supported locale
     if (
       locale === ENGLISH_LOCALE ||
+      locale === SPANISH_LOCALE ||
       locale === CHINESE_CN_LOCALE ||
       locale === CHINESE_HK_LOCALE ||
-      locale === RUSSIAN_LOCALE
+      locale === RUSSIAN_LOCALE ||
+      locale === GERMAN_LOCALE ||
+      locale === JAPANESE_LOCALE
     ) {
       return locale;
     }
@@ -129,6 +168,24 @@ function getPreferredLocale(): string {
     navigator.language,
   ].filter((locale): locale is string => Boolean(locale));
 
+  // Check if the browser prefers Japanese
+  const hasJapanese = browserLocales.some((locale) => {
+    const lower = locale.toLowerCase();
+    return lower.startsWith("ja");
+  });
+
+  // Check if the browser prefers German
+  const hasGerman = browserLocales.some((locale) => {
+    const lower = locale.toLowerCase();
+    return lower.startsWith("de");
+  });
+
+  // Check if the browser prefers Spanish
+  const hasSpanish = browserLocales.some((locale) => {
+    const lower = locale.toLowerCase();
+    return lower.startsWith("es");
+  });
+
   // Check if the browser prefers Russian
   const hasRussian = browserLocales.some((locale) => {
     const lower = locale.toLowerCase();
@@ -147,6 +204,27 @@ function getPreferredLocale(): string {
     return lower.startsWith("zh-cn") || (lower.startsWith("zh") && !hasTraditionalChinese);
   });
 
+  // Check if the browser prefers French
+  const hasFrench = browserLocales.some((locale) => {
+    const lower = locale.toLowerCase();
+    return lower.startsWith("fr-FR");
+  });
+
+  // Prioritize Japanese if detected
+  if (hasJapanese) {
+    return JAPANESE_LOCALE;
+  }
+
+  // Prioritize German if detected
+  if (hasGerman) {
+    return GERMAN_LOCALE;
+  }
+
+  // Prioritize Spanish if detected
+  if (hasSpanish) {
+    return SPANISH_LOCALE;
+  }
+
   // Prioritize Russian if detected
   if (hasRussian) {
     return RUSSIAN_LOCALE;
@@ -162,6 +240,10 @@ function getPreferredLocale(): string {
     return CHINESE_CN_LOCALE;
   }
 
+  if (hasFrench) {
+    return FRENCH_LOCALE;
+  }
+
   // Default to English
   return ENGLISH_LOCALE;
 }
@@ -172,6 +254,10 @@ function getPreferredLocale(): string {
 function buildLocaleRoot(base: string, locale: string): string {
   const normalizedBase = base.endsWith("/") ? base : `${base}/`;
 
+  if (locale === SPANISH_LOCALE) {
+    return `${normalizedBase}${SPANISH_LOCALE}/`;
+  }
+
   if (locale === CHINESE_CN_LOCALE) {
     return `${normalizedBase}${CHINESE_CN_LOCALE}/`;
   }
@@ -184,6 +270,18 @@ function buildLocaleRoot(base: string, locale: string): string {
     return `${normalizedBase}${RUSSIAN_LOCALE}/`;
   }
 
+  if (locale === GERMAN_LOCALE) {
+    return `${normalizedBase}${GERMAN_LOCALE}/`;
+  }
+
+  if (locale === JAPANESE_LOCALE) {
+    return `${normalizedBase}${JAPANESE_LOCALE}/`;
+  }
+
+  if (locale === FRENCH_LOCALE) {
+    return `${normalizedBase}${FRENCH_LOCALE}/`;
+  }
+
   return normalizedBase;
 }
 

docs/.vitepress/theme/index.ts

@@ -0,0 +1,56 @@
+# Inhaltsverwaltung
+
+LeviLauncher kann inhaltsbezogene Daten verwalten, die mit einzelnen Minecraft-Versionen verknüpft sind – besonders effektiv in Kombination mit isolierten Umgebungen.
+
+## Im Launcher verwaltbare Inhaltstypen
+
+- Welten  
+- Ressourcenpakete  
+- Verhaltenspakete  
+- Skin-Pakete  
+- Screenshots  
+- Serverlisten  
+
+## Warum das wichtig ist
+
+Für viele Spieler ist der entscheidende Grund, einen Launcher langfristig zu nutzen, nicht nur das „Installieren einer Version“, sondern vielmehr das „klare Trennen verschiedener Spielumgebungen“.
+
+Beispiele:
+
+- Eine Version ausschließlich für Vanilla-Überlebenswelten  
+- Eine Version speziell zum Testen von Ressourcenpaketen  
+- Eine separate Minecraft Preview-Version, um Screenshots und Serverlisten unabhängig zu speichern  
+
+## Häufige Aktionen
+
+### Inhaltsübersicht öffnen
+
+Wechsle in der Anwendung zum Bereich **„Content“**, um eine Übersicht über alle Inhalte samt Schnellzugriffen zu erhalten.
+
+### Inhalte importieren
+
+Für bestimmte Inhaltstypen unterstützt LeviLauncher einen Import-Workflow – beispielsweise per Drag & Drop.
+
+### Tatsächliche Ordner öffnen
+
+Falls du Dateien manuell prüfen oder bereinigen möchtest, kannst du über den Launcher direkt die entsprechenden Verzeichnisse öffnen.
+
+### Isolierung zur Inhaltsunabhängigkeit nutzen
+
+Sobald eine Version isoliert ist, werden ihre Inhalte in einem separaten Arbeitsverzeichnis gespeichert – ideal für Tests und archivische Ordnung.
+
+## Empfohlene Ordnungsgrundsätze
+
+- Test-Ressourcenpakete nicht mit Hauptwelten mischen  
+- Wichtige Welten vor größeren Änderungen sichern  
+- Versionen klar benennen, um Zuordnungsfehler zu vermeiden  
+
+## Hinweis zu Screenshots und Servern
+
+Wenn verschiedene Versionen unterschiedliche Zwecke erfüllen, empfiehlt es sich, auch Screenshots und Serverlisten versionsweise zu trennen – das sorgt für bessere Übersichtlichkeit.
+
+## Weiterführende Themen
+
+- [Versionsverwaltung](./version-management)  
+- [Welt-Tools](./world-tools)  
+- [Einstellungen und Personalisierung](./settings-personalization)

docs/de-DE/guide/content-management.md

@@ -0,0 +1,48 @@
+# Download und Spiegelserver
+
+LeviLauncher bietet Funktionen wie die Auswahl von Spiegelservern, Fortschrittsanzeige und den Import lokaler Installationspakete, um dir eine zuverlässigere Installation zu ermöglichen.
+
+## Wofür dieser Bereich geeignet ist
+
+- Durchsuchen verfügbarer Versionen  
+- Geschwindigkeitstest oder Wechsel des Spiegelservers  
+- Anzeige des Download- und Installationsfortschritts  
+- Einfaches erneutes Versuchen fehlgeschlagener Aufgaben  
+- Import lokaler Installationspakete in geeigneten Szenarien  
+
+## Empfohlener Ablauf
+
+1. Öffne **„Download“**.  
+2. Wähle die gewünschte Minecraft-**Release**- oder **Preview**-Version aus.  
+3. Lass LeviLauncher automatisch die beste Geschwindigkeit ermitteln – oder wähle manuell einen passenden Spiegelserver.  
+4. Starte die Installationsaufgabe.  
+5. Für detailliertere Informationen wechsle zur Aufgaben- oder Download-Verwaltungsansicht.
+
+## Wann du den Spiegelserver wechseln solltest
+
+Wechsle den Server in folgenden Fällen:
+
+- Die Downloadgeschwindigkeit ist auffällig langsam  
+- Ein bestimmter Spiegelserver wiederholt Verbindungsfehler verursacht  
+- Eine Aufgabe bleibt bei einem Server lange hängen, während andere stabiler laufen  
+
+## Lokaler Paket-Import
+
+Falls du bereits ein kompatibles Installationspaket lokal vorliegen hast, kann LeviLauncher dieses – sofern vom Prozess unterstützt – direkt importieren.
+
+Dies ist besonders hilfreich bei:
+
+- Instabilen Netzwerkverbindungen  
+- Wiederverwendung bereits heruntergeladener Ressourcen  
+- Bedarf an einer kontrollierbaren und konsistenten Installationsquelle  
+
+## Bei fehlgeschlagenen Aufgaben
+
+Bevor du es erneut versuchst, prüfe Folgendes:
+
+- Genügend freier Speicherplatz auf der Festplatte  
+- Schreibrechte im Zielverzeichnis  
+- Erforderliche Windows-Komponenten sind installiert  
+- Der aktuell gewählte Spiegelserver ist weiterhin erreichbar  
+
+Sollte das Problem weiterhin bestehen, lies bitte den Abschnitt [Updates und Fehlerbehebung](./update-troubleshooting).

docs/de-DE/guide/downloads-mirrors.md

@@ -0,0 +1,54 @@
+# Häufig gestellte Fragen, Community und Feedback
+
+## Häufig gestellte Fragen (FAQ)
+
+### Muss ich über eine Originalversion von Minecraft Bedrock verfügen?
+
+Ja. LeviLauncher ist explizit für die Verwendung mit der **originalen Minecraft Bedrock Edition (GDK)** konzipiert.
+
+### Kann ich es unter macOS oder Linux verwenden?
+
+Diese Benutzerdokumentation gilt ausschließlich für **Windows**.
+
+### Soll ich Release oder Preview wählen?
+
+Für reguläres Spielen empfiehlt sich stets die **offizielle Version (Release)**. Die **Vorschauversion (Preview)** sollte nur genutzt werden, wenn du bewusst neue Funktionen testen möchtest und Instabilitäten akzeptieren kannst.
+
+### Ist Isolierung zwingend erforderlich?
+
+Nein, sie ist nicht zwingend – wird aber dringend empfohlen für Testumgebungen, Minecraft Preview und Modifikationen.
+
+### Kann ich Welten und Ressourcenpakete im Launcher verwalten?
+
+Ja. LeviLauncher bietet Übersichten für Welten, Ressourcenpakete, Verhaltenspakete, Skin-Pakete, Screenshots und Serverlisten.
+
+### Kann ich Mods installieren?
+
+Ja, dies gehört jedoch zu fortgeschrittenen Workflows. Wir empfehlen, zunächst mit einer sauberen, isolierten Version zu beginnen und schrittweise zu testen.
+
+## Community-Zugänge
+
+- **Offizieller Discord:** [discord.gg/v5R5P4vRZk](https://discord.gg/v5R5P4vRZk)  
+- **Persönlicher Discord-Kanal:** [discord.gg/VqQaC8vWz8](https://discord.gg/VqQaC8vWz8)  
+- **QQ-Gruppe (chinesisch):** [458083875](https://qm.qq.com/q/1z791rJgJG)  
+
+## Download-Quellen
+
+- **GitHub Releases (offizieller Download):** [LiteLDev/LeviLauncher Releases](https://github.com/LiteLDev/LeviLauncher/releases)  
+- **Lanzou Cloud Mirror:** [levimc.lanzoue.com/b016ke39hc](https://levimc.lanzoue.com/b016ke39hc) — Passwort: `levi`
+
+## So gibst du Probleme oder Feature-Ideen weiter
+
+Bitte verwende [GitHub Issues](https://github.com/LiteLDev/LeviLauncher/issues), um Folgendes zu melden:
+
+- Reproduzierbare Fehler  
+- Installationsprobleme, die eindeutig mit LeviLauncher zusammenhängen  
+- Vorschläge zur Verbesserung unklarer Dokumentationsstellen  
+- Feature-Anfragen mit klar beschriebenem Anwendungsfall  
+
+## Bevor du ein Issue erstellst, empfehlen wir Folgendes
+
+- Aktualisiere auf die neueste verfügbare Version  
+- Führe einen Vergleichstest mit einer sauberen, isolierten Version durch  
+- Deaktiviere vorübergehend neu hinzugefügte Mods oder Ressourcenpakete  
+- Notiere die genauen Schritte, die zum Problem führen  

docs/de-DE/guide/faq-community-feedback.md

@@ -0,0 +1,50 @@
+# Erster Start
+
+Beim ersten Öffnen von LeviLauncher prüft die Anwendung zunächst, ob die Windows- und Minecraft-Umgebung die Anforderungen für eine verwaltete Installation erfüllt.
+
+## Was du möglicherweise siehst
+
+Beim ersten Start kann LeviLauncher Folgendes tun:
+
+- Überprüfen, ob Gaming Services verfügbar ist  
+- Überprüfen, ob GameInput verfügbar ist  
+- Validieren, ob die Minecraft Bedrock (GDK)-Umgebung bereit ist  
+- Bei fehlenden Schlüsselkomponenten entsprechende Hinweise oder Anleitungen anzeigen  
+
+## Typischer Ablauf beim ersten Start
+
+1. Öffne LeviLauncher.  
+2. Lies die angezeigten Hinweise des Launchers.  
+3. Installiere oder repariere fehlende Voraussetzungen.  
+4. Kehre zum Launcher zurück und überprüfe den Status erneut.  
+5. Sobald alle Bedingungen erfüllt sind, gelangst du zur **Download**-Seite.
+
+## Falls Komponenten als fehlend gemeldet werden
+
+### Gaming Services
+
+Falls Gaming Services fehlt oder beschädigt ist, leitet dich LeviLauncher möglicherweise zum Microsoft Store, um es zu installieren oder zu reparieren.
+
+### GameInput
+
+Falls GameInput fehlt, installiere bitte das angeforderte Redistributable-Paket gemäß den Anweisungen.
+
+### Minecraft Bedrock wurde nicht erkannt
+
+Bitte stelle sicher, dass:
+
+- Dein aktuelles Microsoft-Konto über eine gültige Spiellizenz verfügt  
+- Das Spiel auf diesem Computer bereits über den Microsoft Store installiert wurde  
+- Du nicht versuchst, den offiziellen Lizenzierungsprozess zu umgehen  
+
+## Empfohlene Standardeinstellungen für neue Nutzer
+
+- Beginne zunächst mit einer isolierten **Release**-Version  
+- Wähle für Downloads und Inhalte ein beschreibbares Laufwerk  
+- Importiere keine große Anzahl von Mods, bevor der erste saubere Start erfolgreich war  
+
+## Empfohlene weiterführende Themen nach dem ersten Start
+
+- [Versionsverwaltung](./version-management)  
+- [Inhaltsverwaltung](./content-management)  
+- [Einstellungen und Personalisierung](./settings-personalization)