Files
deflock-app/lib/localizations/README.md
2025-10-02 16:56:31 -04:00

1.7 KiB

DeFlock Localizations

This directory contains translation files for DeFlock. Each language is a simple JSON file.

Adding a New Language

Want to add support for your language? It's simple:

  1. Copy the English file: cp en.json your_language_code.json

    • Use 2-letter language codes: es (Spanish), fr (French), it (Italian), etc.
  2. Edit your new file:

    {
      "language": {
        "name": "Your Language Name"   Change this to your language in your language
      },
      "app": {
        "title": "DeFlock"   Keep this as-is
      },
      "about": {
        "title": "Your Translation Here",
        "description": "Your Translation Here",
        ...
      },
      "actions": {
        "tagNode": "Your Translation Here",
        "download": "Your Translation Here",
        ...
      }
    }
    
  3. Submit a PR with your JSON file. Done!

The new language will automatically appear in Settings → Language.

Translation Rules

  • Only translate the values (text after the :), never the keys
  • Keep {} placeholders if you see them - they get replaced with numbers/text
  • Don't translate "DeFlock" - it's the app name
  • Use your language's name for itself - "Français" not "French", "Español" not "Spanish"

Current Languages

  • en.json - English
  • es.json - Español
  • fr.json - Français
  • de.json - Deutsch
  • it.json - Italiano
  • pt.json - Português
  • zh.json - 中文

Files to Update

For a complete translation, you only need to update:

  1. lib/localizations/xx.json - All UI translations including about content

That's It!

No configuration files, no build steps, no complex setup. Add your files and it works.