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

如何为translation贡献翻译新手参与英文技术文章翻译的完整教程流程规范模板【免费下载链接】translation翻译文档项目地址: https://gitcode.com/gh_mirrors/transla/translationtranslation是一个开源翻译文档项目汇聚了大量优质英文技术文章的中文翻译涵盖 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 项目对翻译文章有一套约定俗成的规范新手照着做就不会出错规范项要求示例目录命名两位数编号_英文主题名/全小写、单词用连字符02_RateLimiter/文章主文件目录内创建README.md作为正文tiemao_2025/02_RateLimiter/README.md图片本地化图片放同目录文中用相对路径引用状态标记在年度索引中标注进度【未翻译】【粗翻】【草稿】【已完成】【已发布】见tiemao_2025/README.md页脚署名文末注明原文链接、原文日期、翻译日期、翻译人员见下文示例页脚署名是翻译文章的身份证可参考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) 需要配图时把图片下载到当前目录用相对路径引用  ## 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. 新手常见问题FAQQ1英文水平一般能参与翻译吗可以。仓库中大量文章标注为【粗翻】或【草稿】意思是先完成、再打磨。你可以先翻简单章节如 FAQ、小结类或认领校对工作——把【粗翻】文章润色到【已完成】同样是重要贡献。Q2不知道选哪篇文章翻译打开README.md首页展开各年度目录优先挑选带【未翻译】或【草稿】标记的条目也可以在仓库的 Issue 区留言认领避免与他人重复劳动。Q3文章中的图片如何处理将原文图片下载到你新建的文章目录内然后用相对路径引用如保证图片与文字同目录避免引用网络图片导致日后失效。Q4编号冲突了怎么办编号以年度目录下现有最大编号 1 为准。如果提交时别人已经加了新文章直接顺延下一个空号即可。7. 小结你的第一篇翻译只需 5 步克隆 translation 仓库git clone https://gitcode.com/gh_mirrors/transla/translation从年度目录如tiemao_2025/选一篇【未翻译】文章创建编号目录按第 4 节的模板完成翻译图片本地化、页脚署名称git add→git commit→git push提交到你的分支更新年度索引并发起合并请求translation 项目的价值正来自每一位译者的持续投入——哪怕只是润色一个段落、校对一条术语都是在让中文技术读者受益。现在就可以克隆仓库写下你的第一行翻译吧【免费下载链接】translation翻译文档项目地址: https://gitcode.com/gh_mirrors/transla/translation创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考