shrani

docs/guides/TRANSLATION_TESTING.md

@@ -0,0 +1,157 @@
+# 🌍 TRANSLATION TESTING GUIDE
+
+## Quick Test Instructions
+
+### 1. **Launch Game**
+```bash
+npm start
+```
+
+### 2. **Test Language Switching**
+
+#### **Main Menu Test:**
+1. Click the **🌍 Globe button** (bottom-right corner)
+2. Select each language:
+   - 🇸🇮 **Slovenščina** (Slovenian)
+   - 🇬🇧 **English**
+   - 🇩🇪 **Deutsch** (German)
+   - 🇮🇹 **Italiano** (Italian)
+   - 🇨🇳 **中文** (Chinese)
+3. Verify the menu text changes
+
+#### **In-Game Settings Test:**
+1. Start a new game
+2. Press **ESC** to open pause menu
+3. Click **⚙️ Settings**
+4. Click **🌍 LANGUAGE / JEZIK** section
+5. Test switching between all 5 languages
+6. Verify UI updates immediately
+
+### 3. **Translation Coverage Test**
+
+Test these UI elements in each language:
+
+| Key | SLO | EN | DE | IT | CN |
+|-----|-----|----|----|----|----|
+| `ui.inventory` | Inventar | Inventory | Inventar | Inventario | 库存 |
+| `ui.crafting` | Izdelovanje | Crafting | Handwerk | Artigianato | 制作 |
+| `ui.health` | Zdravje | Health | Gesundheit | Salute | 健康 |
+| `ui.hunger` | Lakota | Hunger | Hunger | Fame | 饥饿 |
+| `ui.oxygen` | Kisik | Oxygen | Sauerstoff | Ossigeno | 氧气 |
+| `ui.day` | Dan | Day | Tag | Giorno | 天数 |
+| `ui.season` | Letni čas | Season | Jahreszeit | Stagione | 季节 |
+
+**Items:**
+| Key | SLO | EN | DE | IT | CN |
+|-----|-----|----|----|----|----|
+| `item.wood` | Les | Wood | Holz | Legno | 木材 |
+| `item.stone` | Kamen | Stone | Stein | Pietra | 石头 |
+| `item.seeds` | Semena | Seeds | Samen | Semi | 种子 |
+| `item.wheat` | Pšenica | Wheat | Weizen | Grano | 小麦 |
+| `item.corn` | Koruza | Corn | Mais | Mais | 玉米 |
+
+**Actions:**
+| Key | SLO | EN | DE | IT | CN |
+|-----|-----|----|----|----|----|
+| `action.plant` | Posadi | Plant | Pflanzen | Pianta | 种植 |
+| `action.harvest` | Požanji | Harvest | Ernten | Raccogli | 收获 |
+| `action.craft` | Izdelaj | Craft | Herstellen | Crea | 制作 |
+| `action.build` | Zgradi | Build | Bauen | Costruisci | 建造 |
+
+**Seasons:**
+| Key | SLO | EN | DE | IT | CN |
+|-----|-----|----|----|----|----|
+| `season.spring` | Pomlad | Spring | Frühling | Primavera | 春天 |
+| `season.summer` | Poletje | Summer | Sommer | Estate | 夏天 |
+| `season.autumn` | Jesen | Autumn | Herbst | Autunno | 秋天 |
+| `season.winter` | Zima | Winter | Winter | Inverno | 冬天 |
+
+**Messages:**
+| Key | SLO | EN | DE | IT | CN |
+|-----|-----|----|----|----|----|
+| `msg.demo_end` | Demo končan! Hvala za igranje. | Demo Ended! Thanks for playing. | Demo beendet! Danke fürs Spielen. | Demo terminata! Grazie per aver giocato. | 演示结束！感谢游玩。 |
+| `msg.freezing` | ❄️ Zmrzuješ! | ❄️ Freezing! | ❄️ Du erfrierst! | ❄️ Stai congelando! | ❄️ 你在冻僵！ |
+| `msg.overheating` | 🔥 Pregrevanje! | 🔥 Overheating! | 🔥 Überhitzung! | 🔥 Surriscaldamento! | 🔥  过热！ |
+
+### 4. **Console Test**
+
+Open browser console (F12) and test:
+
+```javascript
+// Test translation function
+window.i18n.setLanguage('de');
+console.log(window.i18n.t('ui.inventory')); // Should print: "Inventar"
+
+window.i18n.setLanguage('it');
+console.log(window.i18n.t('action.harvest')); // Should print: "Raccogli"
+
+window.i18n.setLanguage('cn');
+console.log(window.i18n.t('season.spring')); // Should print: "春天"
+
+// Test fallback to English
+window.i18n.setLanguage('de');
+console.log(window.i18n.t('nonexistent.key', 'Fallback')); // Should print: "Fallback"
+```
+
+### 5. **Persistence Test**
+
+1. Select **Deutsch** (German)
+2. Close the game completely
+3. Restart the game
+4. Verify the game starts in **German** (saved in localStorage)
+
+---
+
+## ✅ Expected Results
+
+- ✅ All 5 languages display correctly
+- ✅ Language selection persists after restart
+- ✅ UI updates immediately when language changes
+- ✅ No missing translations (all keys have values)
+- ✅ Fallback to English works for undefined keys
+- ✅ Chinese characters render properly (中文)
+- ✅ German umlauts render properly (ä, ö, ü, ß)
+- ✅ Italian accents render properly (à, è, ì, ò, ù)
+
+---
+
+## 🐛 Known Limitations
+
+- ⚠️ Only 20 translation keys currently defined
+- ⚠️ Many UI elements still hardcoded in English
+- ⚠️ NPC dialogue not yet translated
+- ⚠️ Tutorial text not yet translated
+
+---
+
+## 📋 Next Steps for Full Localization
+
+1. **Expand Translation Keys** (Priority: High)
+   - Add menu buttons (NEW GAME, LOAD, SETTINGS, EXIT)
+   - Add pause menu (RESUME, SAVE, QUIT)
+   - Add crafting UI labels
+   - Add building names
+   - Add NPC names and dialogue
+
+2. **Add More Languages** (Priority: Medium)
+   - 🇫🇷 French (Français)
+   - 🇪🇸 Spanish (Español)
+   - 🇷🇺 Russian (Русский)
+   - 🇯🇵 Japanese (日本語)
+   - 🇰🇷 Korean (한국어)
+
+3. **Create External JSON Files** (Priority: Low)
+   - Move translations to `assets/localization/` folder
+   - Easier for translators to contribute
+   - Smaller code file size
+
+4. **Add Translation Tool** (Priority: Low)
+   - Script to check for missing keys
+   - Auto-generate translation template
+   - Validate all languages have same keys
+
+---
+
+**Last Updated:** 12.12.2025  
+**Status:** ✅ 5 Languages Complete (20 keys each)  
+**Coverage:** ~5% of total UI (estimated 400+ keys needed)