Add automated translation tools - Addresses #1494

[0xsatoshi99]

Summary

Provides automated translation tools to translate JavaGuide documentation to multiple languages, addressing the 5-year-old request in issue #1494 for English and other language versions.

Changes

✅ 3 files added (876 lines total)

Files:

1. translate_repo.py (318 lines) - Python implementation
2. TranslateRepo.java (386 lines) - Java implementation
3. TRANSLATION_TOOLS.md (172 lines) - Comprehensive documentation

Features

Core Functionality:

• ✅ Batch translates ALL .md files in docs/ folder + README.md
• ✅ Supports 20 languages (English, Spanish, French, German, Japanese, Korean, etc.)
• ✅ Preserves directory structure: docs/ → docs_en/
• ✅ File naming: file.md → file.en.md
• ✅ Free Google Translate API (no API key required)

Smart Features:

• ✅ Progress tracking - Saves to .translation_progress.json
• ✅ Resume capability - Skips already translated files
• ✅ Rate limiting - Avoids API throttling (1 sec delay)
• ✅ Smart chunking - Handles large files (4000 char chunks)
• ✅ Format preservation - Maintains markdown and code blocks

Usage

Python Version:

pip install deep-translator
python3 translate_repo.py
# Select language (1-20)
# Confirm translation

Java Version:

# Download gson-2.10.1.jar
javac -cp gson-2.10.1.jar TranslateRepo.java
java -cp .:gson-2.10.1.jar TranslateRepo
# Select language (1-20)
# Confirm translation

Output Structure

Before:

docs/
├── java/
│   └── basics.md
README.md

After (English translation):

docs_en/
├── java/
│   └── basics.en.md
README.en.md

Performance

• Speed: ~1 file per 5-10 seconds
• JavaGuide: 292 files ≈ 2-3 hours total
• Tested: Successfully translated README.md and sample docs files

Supported Languages (20)

1. English (en)
2. Chinese Simplified (zh)
3. Spanish (es)
4. French (fr)
5. Portuguese (pt)
6. German (de)
7. Japanese (ja)
8. Korean (ko)
9. Russian (ru)
10. Italian (it)
11. Arabic (ar)
12. Hindi (hi)
13. Turkish (tr)
14. Vietnamese (vi)
15. Polish (pl)
16. Dutch (nl)
17. Indonesian (id)
18. Thai (th)
19. Swedish (sv)
20. Greek (el)

Benefits

1. Global Accessibility: Makes JavaGuide available to non-Chinese speakers
2. Community Friendly: Anyone can run the tool and contribute translations
3. Maintainable: Easy to regenerate translations when docs update
4. Consistent: Automated process ensures uniform translation quality
5. Scalable: Can translate to any of 20 languages with one command

Why Both Python and Java?

• Python: Easy to use, popular for automation
• Java: Native to JavaGuide project, no external dependencies (except Gson)
• Choice: Contributors can use whichever they prefer

Next Steps

After merging, contributors can:

1. Run the translation tool for their preferred language
2. Review and refine automated translations
3. Submit PRs with translated documentation
4. Help maintain translations as docs evolve

Testing

Tested successfully:

• ✅ README.md → README.en.md (26KB)
• ✅ docs/system-design/framework/netty.md → docs_en/system-design/framework/netty.en.md
• ✅ Directory structure preserved
• ✅ Markdown formatting maintained
• ✅ Translation quality verified

Addresses #1494

[0xsatoshi99]

@Snailclimb Please check this translate script. Thanks.

[0xsatoshi99]

@Snailclimb Can you please check this translate script and let me know this is helpful or not? If not helpful, I will close this PR, please let me know your opinion, Thanks.

[Snailclimb]

@Snailclimb请您检查一下这个翻译脚本，并告诉我它是否有帮助？如果没有帮助，我会关闭这个 PR。请您告知您的意见，谢谢。

感谢您，挺不错的。不过，我暂时没有想法将其转换为多语言，很多内容还是更新完善中。不过，我可以将其先合并进来。

[0xsatoshi99]

OK, thanks. I'd really appreciate if you merge it. Thanks again. @Snailclimb

[0xsatoshi99]

OK, thanks. I'd really appreciate if you merge it. Thanks again. @Snailclimb

[0xsatoshi99]

@SnailclimbPlease check this translation script and let me know if it helps. If it doesn't, I will close this PR. Please let me know your feedback, thank you.

Thank you, that's great. However, I don't have any plans to convert it to multiple languages ​​yet; much of the content is still being updated and improved. But I can merge it in for now.

Can you please merge this PR so that I can take a look at next issue or update? Thanks.

[0xsatoshi99]

@Snailclimb Please merge this PR.