SoftEtherVPN/TURKISH_TRANSLATION.md

Turkish Translation Guide

The Turkish (Türkçe) language infrastructure has been added to SoftEther VPN.

Current Status

• ✅ Language entry added to languages.txt (ID: 8, identifier: tr)
• ✅ String table file created: strtable_tr.stb
• ✅ File structure validated with stbchecker
• ⚠️ Translation needed: The file currently contains English text as placeholders

How to Contribute

The Turkish string table (src/bin/hamcore/strtable_tr.stb) currently uses English text. We need native Turkish speakers to translate these strings.

Main Translation File

• File: src/bin/hamcore/strtable_tr.stb (~7,400 lines)
• Format: Each line has a KEY and a translatable value
• Task: Translate only the values, keep the keys unchanged
• Note: You can contribute partial translations - every bit helps!

Quick Start

1. Fork this repository
2. Open src/bin/hamcore/strtable_tr.stb
3. Translate the text values (keep the keys unchanged)
4. Run the validation tool:

   cd developer_tools/stbchecker
   dotnet run ../../src/bin/hamcore
   

5. Submit a Pull Request with your translations

Translation Guidelines

Important Rules:

• Keep technical terms like "VPN", "SSL", "TCP/IP", "IPsec" in English
• Preserve formatting codes like %s, %d, \r\n - they are placeholders
• Maintain the same meaning and tone as the English version
• Use formal Turkish ("siz" form) for user-facing messages
• Be consistent with terminology throughout

Example Translation:

# Original English:
ERR_1                   Connection to the server failed. Check network connection.

# Turkish translation:
ERR_1                   Sunucuya bağlantı başarısız oldu. Ağ bağlantısını kontrol edin.

File Format:

• Lines starting with # are comments (don't translate)
• Each entry: STRING_KEY<tabs>Translated text here
• Only translate the text after the key, never change the key itself

Already Translated

The following metadata has been localized:

• Language identifier: Turkish
• Language ID: 8
• Weekday abbreviations: Paz, Pzt, Sal, Çar, Per, Cum, Cmt
• "None" translated to "Hiçbiri"

Validation

Before submitting your translation, validate it with the consistency checker:

cd developer_tools/stbchecker
dotnet run ../../src/bin/hamcore

This ensures all string keys are present and the file format is correct. The validation must pass before submitting.

Submitting Your Translation

1. Fork the SoftEther VPN repository on GitHub
2. Create a new branch: git checkout -b turkish-translation
3. Edit src/bin/hamcore/strtable_tr.stb with your translations
4. Validate your changes (see above)
5. Commit: git commit -m "Add Turkish translations for [section]"
6. Push to your fork: git push origin turkish-translation
7. Create a Pull Request on GitHub

You can submit partial translations! Translate the most important sections first:

• Error messages (ERR_*)
• Common UI strings (COMMON_*)
• Product names
• Menu items

Questions?

If you have questions about the translation:

• Open an issue on GitHub
• Tag it with translation and Turkish

Thank You!

Thank you to VamHunD and all contributors who help make SoftEther VPN accessible to Turkish users!