HeyPuter项目国际化实践：README文档波斯语翻译指南

在开源项目的国际化进程中，文档本地化是提升项目可访问性的重要环节。HeyPuter项目近期启动了波斯语（Farsi）文档的翻译工作，旨在为波斯语用户和贡献者提供更好的支持。

翻译工作的技术要点包含以下几个方面：

1. 文件结构规范

• 源文件路径固定为项目文档目录下的i18n子目录
• 目标文件名需遵循"README.fa.md"的命名规则（fa表示波斯语语言代码）
• 保持与英文版相同的目录层级结构

2. 内容转换原则

• 保留原始Markdown格式的所有语法标记
• 技术术语需保持一致性，可采用行业通用译法或保留英文
• 文化敏感内容需要适当本地化处理
• 链接地址必须保持原样，仅翻译显示文本

3. 质量控制要求

• 翻译前后需进行格式校验
• 专业术语表有助于保持统一性
• 建议由母语者进行审校
• 需要验证所有超链接的功能完整性

实施建议： 对于技术文档翻译，推荐采用分段处理的方式：先处理格式标记，再逐段翻译内容。特别注意代码块和注释部分的处理，技术名词的翻译需要前后一致。表格和图示的标题也需要完整本地化。

项目国际化意义： 多语言支持不仅能扩大项目用户基础，更能促进全球开发者的协作。波斯语文档的加入将使中东地区的开发者更容易理解和使用HeyPuter项目，有助于形成更活跃的社区生态。

对于想要参与开源的开发者而言，文档翻译是绝佳的入门贡献方式。通过规范的本地化流程，既能保证文档质量，又能让贡献者熟悉项目结构，为后续更深入的技术贡献打下基础。