From cddc0297140eeb242f8ad704017ec2df7e1e29c0 Mon Sep 17 00:00:00 2001
From: Jan <jplacht@gmail.com>
Date: Thu, 7 May 2026 09:10:57 +0200
Subject: [PATCH 1/3] improve(i18n): localize help mds, translation note on
 profile

---
 src/features/help/components/HelpDrawer.vue   | 40 ++++++++++++++-----
 .../profile/components/UserPreferences.vue    | 15 +++++++
 src/locales/en_US/profile.json                |  1 +
 3 files changed, 46 insertions(+), 10 deletions(-)

diff --git a/src/features/help/components/HelpDrawer.vue b/src/features/help/components/HelpDrawer.vue
index fedc7d6e..edfd790b 100644
--- a/src/features/help/components/HelpDrawer.vue
+++ b/src/features/help/components/HelpDrawer.vue
@@ -1,8 +1,16 @@
 <script setup lang="ts">
 	import { computed, PropType, ref, Ref, watch } from "vue";
 
+	// pre-parsing glob
+	const HELP_FILES = import.meta.glob("@/assets/help/**/*.md", {
+		query: "?raw",
+		import: "default",
+	}) as Record<string, () => Promise<string>>;
+
 	import { useI18n } from "vue-i18n";
-	const { t } = useI18n({ useScope: "global" });
+	const { t, locale } = useI18n({ useScope: "global" });
+
+	console.log(locale.value);
 
 	import { PButton } from "@/ui";
 	import { NDrawer, NDrawerContent } from "naive-ui";
@@ -11,15 +19,27 @@
 	const showDrawer: Ref<boolean> = ref(false);
 
 	async function loadMarkdown(): Promise<string> {
-		const markdownFiles = import.meta.glob("@/assets/help/en_US/*.md", {
-			query: "?raw",
-			import: "default",
-		}) as Record<string, () => Promise<string>>;
-
-		const path = `/src/assets/help/en_US/${props.fileName}.md`;
-		const loader = markdownFiles[path];
-		if (!loader)
-			throw new Error(`Markdown file "${props.fileName}" not found.`);
+		const fileName = props.fileName;
+		const currentLocale = locale.value;
+		const fallbackLocale = "en_US";
+
+		const targetPath = `/src/assets/help/${currentLocale}/${fileName}.md`;
+		const fallbackPath = `/src/assets/help/${fallbackLocale}/${fileName}.md`;
+
+		let loader = HELP_FILES[targetPath];
+
+		// fallback
+		if (!loader) {
+			loader = HELP_FILES[fallbackPath];
+		}
+
+		// error if fallback unavailable
+		if (!loader) {
+			throw new Error(
+				`Markdown file "${fileName}" not found in ${currentLocale} or ${fallbackLocale}.`
+			);
+		}
+
 		return await loader();
 	}
 
diff --git a/src/features/profile/components/UserPreferences.vue b/src/features/profile/components/UserPreferences.vue
index b47c3370..e7dfbe22 100644
--- a/src/features/profile/components/UserPreferences.vue
+++ b/src/features/profile/components/UserPreferences.vue
@@ -96,6 +96,21 @@
 				:options="SupportedLanguages"
 				class="w-full" />
 		</PFormItem>
+		<PFormSeperator>
+			<i18n-t
+				keypath="profile.preferences.form.language_note"
+				tag="div"
+				class="text-xs text-white/60 pt-1 pb-2">
+				<template #link>
+					<a
+						href="https://crowdin.com/project/prunplanner"
+						target="_blank"
+						class="hover:underline text-prunplanner">
+						Crowdin</a
+					>
+				</template>
+			</i18n-t>
+		</PFormSeperator>
 		<PFormItem :label="t('profile.preferences.form.default_empire')">
 			<PSelect
 				v-model:value="defaultEmpireUuid"
diff --git a/src/locales/en_US/profile.json b/src/locales/en_US/profile.json
index 4bf31dae..19eb6d77 100644
--- a/src/locales/en_US/profile.json
+++ b/src/locales/en_US/profile.json
@@ -71,6 +71,7 @@
 		"form": {
 			"tool_preferences": "Tool Preferences",
 			"language": "Language",
+			"language_note": "We want to make PRUNplanner accessible to everyone. If you'd like to see the tool in your native language - or help us polish an existing translation - join our localization project on {link}.",
 			"default_empire": "Default Empire",
 			"default_cx": "Default CX",
 			"fio_burn": "FIO Burn",

From d99333370a71a4a72ecebde788baa67750cef3e9 Mon Sep 17 00:00:00 2001
From: Jan <jplacht@gmail.com>
Date: Thu, 7 May 2026 09:12:40 +0200
Subject: [PATCH 2/3] improve(i18n): remove prun term

---
 src/locales/en_US/profile.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/locales/en_US/profile.json b/src/locales/en_US/profile.json
index 19eb6d77..cdc413fb 100644
--- a/src/locales/en_US/profile.json
+++ b/src/locales/en_US/profile.json
@@ -42,7 +42,7 @@
 		"title": "What is FIO & Why should you use it?",
 		"help": {
 			"title": "5 Easy Steps to Integrate FIO and PRUNplanner",
-			"p1": "FIO is a community developed {link} that collects your game data, makes it available outside of @:terms.prosperous_universe and is completely free to use.",
+			"p1": "FIO is a community developed {link} that collects your game data, makes it available outside of Prosperous Universe and is completely free to use.",
 			"p2": "Just go ahead and install the Chrome or Firefox extension, reload your browser with APEX open and click the extension button in the upper-right in your browser to create an account. FIO will automatically collect (only) your game data while you keep playing.",
 			"p3": "You can now login to the {link} to see your data and create an API-Key PRUNplanner will use to import your storage (materials you have somewhere) and sites (planets, ships, warehouses) data.",
 			"p4": "Creating the key is easy, if you head to the {link} page and click the \"Create API Key\" button. Enter a name for your key (e.g., \"PRUNplanner\") and your FIO password. You don't need to \"Allow Writes\" as PRUNplanner will not manipulate any of your data, the tool just reads and uses it.",

From 78810aa8391cb52c0bff0605655f82eeea9a2014 Mon Sep 17 00:00:00 2001
From: Jan <jplacht@gmail.com>
Date: Thu, 7 May 2026 09:13:24 +0200
Subject: [PATCH 3/3] improve(i18n): remove leftover console log

---
 src/features/help/components/HelpDrawer.vue | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/features/help/components/HelpDrawer.vue b/src/features/help/components/HelpDrawer.vue
index edfd790b..a239a09d 100644
--- a/src/features/help/components/HelpDrawer.vue
+++ b/src/features/help/components/HelpDrawer.vue
@@ -10,8 +10,6 @@
 	import { useI18n } from "vue-i18n";
 	const { t, locale } = useI18n({ useScope: "global" });
 
-	console.log(locale.value);
-
 	import { PButton } from "@/ui";
 	import { NDrawer, NDrawerContent } from "naive-ui";
 	import { VueShowdown } from "vue-showdown";