| name | translations-sync |
| description | Sync translation keys across all language-*.txt files in TeslaLogger/bin/. USE FOR: update translations, sync language files, translate new keys, update language-*.txt, translation sync, i18n update, language file changes. DO NOT USE FOR: adding new languages, changing language file format. |
| license | MIT |
| metadata | {"author":"TeslaLogger","version":"1.0.0"} |
Sync TeslaLogger Translations
When translation keys change in one language file (usually language-de.txt), propagate the updates to all other language-*.txt files in TeslaLogger/bin/.
File Location
All language files live in: TeslaLogger/bin/language-*.txt
The English file (language-en.txt) is the source of truth for keys and default values.
Workflow
1. Identify changed keys
Read the modified language file (e.g., language-de.txt) to find the changed keys. Note the key names and new values.
2. Find all language files
glob: TeslaLogger/bin/language-*.txt
3. Check which files already have the keys
grep: KEY_NAME (in TeslaLogger/bin/, include: language-*.txt)
4. Classify each language file
| Status | Action |
|---|
| Key exists with translation | Update the translation to match the new meaning |
Key exists but empty (KEY=) | Add the translation |
| Key does not exist | Skip — file will fall back to English automatically |
5. Update files
For each file that has the key:
- Read the surrounding lines (context around the match)
- Update the value, adapting the translation to the new meaning while keeping the same language
- Preserve exact formatting: quotes, line breaks, special characters like
"_QQ_"
Translation guidelines
- Translate the meaning, not literally
- Keep the same language style and conventions as the existing file
- Preserve placeholders:
{LINK}, {LINK1}, {LINK2}, {id}, "_QQ_", browser names in {...}
- When the German source changes (e.g. "vor 2021" → "MCU1"), adapt the translation to reflect the new meaning, not the old wording
- For technical terms like "MCU1", keep them as-is (don't translate "MCU1")
6. Report summary
Return a table showing:
| File | BA_ALLCARS | BA_MODELSXOLD |
|---|
| language-de.txt | Changed by user | Changed by user |
| language-it.txt | Updated | Updated |
| language-es.txt | Updated | Updated |
| language-sv.txt | Added (was empty) | Added (was empty) |
| language-da.txt | Falls back to EN | Falls back to EN |
| ... | ... | ... |
Example
User changes in language-de.txt:
BA_ALLCARS="Alle Fahrzeuge außer Model S/X mit MCU1"
BA_MODELSXOLD="Model S/X mit MCU1"
Update language-es.txt (old: "construido antes del 2021" → new: "con MCU1"):
BA_ALLCARS="Todos los vehículos excepto Model S/X con MCU1"
BA_MODELSXOLD="Model S/X con MCU1"
Skip language-da.txt if it has no BA_ALLCARS key — it will automatically use the English fallback.
