企业官网建设流程全解析

如何为translation贡献翻译：新手参与英文技术文章翻译的完整教程（流程+规范+模板）

【免费下载链接】translation翻译文档项目地址: https://gitcode.com/gh_mirrors/transla/translation

translation是一个开源翻译文档项目，汇聚了大量优质英文技术文章的中文翻译，涵盖 Java、JVM、MySQL、前端、Linux 等主题。本文为新手准备了一份参与translation 翻译贡献的完整教程：从克隆 translation 仓库、理解翻译规范，到按模板完成一篇英文技术文章翻译并提交，全程无需深厚代码基础，照做即可上手 🚀

1. 先认识 translation 项目：翻译文章都放在哪里

translation 仓库按"译者 + 年份"组织目录，结构非常清晰：

• tiemao_2014/~tiemao_2025/：铁锚的年度翻译目录，每年一个文件夹，内含编号子目录（如tiemao_2025/01_word_press_login_fail/）
• shusansheng/：伙伴"书三生"的翻译文章目录（如shusansheng/shusansheng_2014/EarthMoon/）
• java_topic/、design/、other/：按主题组织的笔记与专题文档

每一年目录下的README.md都是年度文章索引，一行一篇文章，并带有状态标记，例如tiemao_2025/README.md中的格式：

• 01.WordPress一直登录失败的问题排查

你可以从README.md项目首页目录找到任意一年的文章列表，先通读 2~3 篇现有翻译，感受行文风格，这是新人的最佳入门方式。

2. 翻译前准备：克隆 translation 仓库的 3 步

第 1 步：克隆仓库。安装好 Git 后，在终端执行：

git clone https://gitcode.com/gh_mirrors/transla/translation

第 2 步：进入目录，确认结构。进入translation目录后，应能看到tiemao_2014到tiemao_2025等年度目录，与前面介绍的一致。

第 3 步：创建自己的翻译分支。建议使用自己的用户名作为分支名，避免与他人冲突：

git checkout -b your_name_translation

💡 习惯图形界面的用户，可以安装 TortoiseGit 等 Git 可视化工具，克隆、提交、推送都可以通过右键菜单完成，仓库内 tiemao_2014/GitHelp/GitHelp.md 就是一份完整的 Git 图文教程，安装工具后也可以参考它：

3. translation 翻译规范：照现有文章模仿这 5 条

translation 项目对翻译文章有一套约定俗成的规范，新手照着做就不会出错：

页脚署名是翻译文章的"身份证"，可参考shusansheng/shusansheng_2014/EarthMoon/EarthMoon.md文末的标准写法：

• 原文链接: （原文地址）
• 原文日期: 2014年10月23日
• 翻译日期: 2014年10月24日
• 翻译人员: （你的名字）

4. 翻译文章模板：复制即可开始写

新建tiemao_2025/NN_your-topic/README.md后，可以直接套用下面这份模板（NN 替换为该年度的下一个编号）：

# 文章中文标题 > 原文更新日期: YYYY年MM月DD日 ## 1. 背景 / 问题描述 （用通俗中文概述原文要解决的问题，1~2 段即可） ## 2. 核心内容 （按原文结构分节翻译；专业术语首次出现时保留英文并加括号， 例如：垃圾收集器(Garbage Collector)） （需要配图时，把图片下载到当前目录，用相对路径引用： ![](图片文件名.jpg)） ## 3. 小结 （用 2~3 句话总结原文要点，并给出自己的理解） ## 参考链接 - （原文地址与延伸阅读） 原文作者: （原作者名） 翻译人员: （你的名字） 翻译日期: YYYY年MM月DD日

翻译小技巧 ✍️：

• 不必逐字直译：项目里标注【粗翻】的文章不少，先快速通顺地翻完一版，再迭代润色到【已完成】，进度标记会如实反映在年度索引中
• 术语统一：同一术语全文保持一致；拿不准时，优先沿用仓库内已有文章的译法
• 代码保留原样：代码块中的变量名、类名不翻译，只翻译注释和说明文字

5. 提交你的翻译：从 commit 到更新索引

翻译完成后，按下面三步提交：

第 1 步：提交修改。在 translation 目录中执行：

git add tiemao_2025/NN_your-topic/ git commit -m "translate: 添加文章《中文标题》翻译" git push origin your_name_translation

第 2 步：更新年度索引。打开对应年度的README.md（如tiemao_2025/README.md），在目录中按编号追加一行，并带上状态标记：

• NN.你的文章中文标题【粗翻】

第 3 步：发起合并请求（PR/MR）。在代码托管平台的仓库页面，将你的翻译分支合并到主分支，并简要说明翻译了哪篇原文。维护者审核通过后，你的翻译就正式成为 translation 项目的一部分了 🎉

6. 新手常见问题（FAQ）

Q1：英文水平一般，能参与翻译吗？可以。仓库中大量文章标注为【粗翻】或【草稿】，意思是"先完成、再打磨"。你可以先翻简单章节（如 FAQ、小结类），或认领"校对"工作——把【粗翻】文章润色到【已完成】同样是重要贡献。

Q2：不知道选哪篇文章翻译？打开README.md首页，展开各年度目录，优先挑选带【未翻译】或【草稿】标记的条目；也可以在仓库的 Issue 区留言认领，避免与他人重复劳动。

Q3：文章中的图片如何处理？将原文图片下载到你新建的文章目录内，然后用相对路径引用（如![](01_demo.jpg)），保证图片与文字同目录，避免引用网络图片导致日后失效。

Q4：编号冲突了怎么办？编号以年度目录下现有最大编号 +1 为准。如果提交时别人已经加了新文章，直接顺延下一个空号即可。

7. 小结：你的第一篇翻译只需 5 步

1. 克隆 translation 仓库：git clone https://gitcode.com/gh_mirrors/transla/translation
2. 从年度目录（如tiemao_2025/）选一篇【未翻译】文章，创建编号目录
3. 按第 4 节的模板完成翻译，图片本地化、页脚署名称
4. git add→git commit→git push提交到你的分支
5. 更新年度索引并发起合并请求

translation 项目的价值正来自每一位译者的持续投入——哪怕只是润色一个段落、校对一条术语，都是在让中文技术读者受益。现在就可以克隆仓库，写下你的第一行翻译吧！

【免费下载链接】translation翻译文档项目地址: https://gitcode.com/gh_mirrors/transla/translation