使用 GitHub 提交翻译

提示：本页所述内容面向完全没有 Git 及 GitHub 基础的译员。

GitHub 是什么

GitHub 是通过 Git 进行版本控制的软件源代码托管服务平台¹。

简单来说，Git 是用来管理代码更改的软件，GitHub 把它搬上了云端。我们用它来管理翻译的更改。

举个简单的例子，在仓库的 History（历史）页面中，你能看到仓库创建以来的一万七千余次提交commit（对一个或多个文件的改动集合）。又如某个文件夹或文件的 History（历史）页面会记录该文件夹或文件的更改记录，以 Ender IO 的为例：Ender IO 的 History 。

除了能查看每次提交的提交者和内容，Git 还能还原revert（一个作用为删除某个提交的提交）某个 commit，这都是后话了。

文件路径

projects / {Minecraft 版本} / assets / {CurseForge 项目名称} / {命名空间} / lang / zh_cn.json

此例子演示的是 1.16 json 文件路径，而 1.12 lang 文件路径也十分类似。

Tinkers Construct 的 CurseForge 页面地址为 https://www.curseforge.com/minecraft/mc-mods/tinkers-construct，则 {CurseForge 项目名称} 为 mc-mods/ 到下一个 / 之间的内容，即 tinkers-construct。

Tinkers Construct 英文原文的路径为 assets/tconstruct/lang/en_us.json，则 {命名空间} 为 assets/ 和 /lang 之间的内容，即 tconstruct。

最终你要提交翻译文件的路径为 projects/1.16/assets/tinkers-construct/tconstruct/lang/zh_cn.json。

利用在线编辑器（github.dev）提交

视频教程

其本质是一个在线 Visual Studio Code（一款文本编辑软件），下文也称 VS Code。

1. Fork：选择页面最上方仓库名右侧按钮中的“Fork”。这时网页应跳转到名为 {你的用户名} / Minecraft-Mod-Language-Package 的仓库。
2. 打开在线 VSC：按下句号键，或者把网址中的.com改为.dev并按下回车键，这时将打开在线版 VS Code。
3. 新建分支：左下角有一绿色背景的“GitHub”字样，选择其右侧的“main”，在弹出窗口中选择“创建新分支...Create new branch...”，输入要提交翻译模组英文名或者命名空间。按下回车键。

• 分支名不能含有空格，可以使用驼峰命名法或使用“-”代替空格。

4. 切换分支：在弹出的窗口中选择“切换到新分支Switch to Branch”。
5. 搜索文件：按下 Ctrl + P 呼出搜索，输入 CurseForge 项目名称或命名空间查找。
6. 新建文件（夹）：如果没有搜到就选择侧边栏中的“资源管理器Explorer”（上数第一个）按钮，依照上文“文件路径”创建路径和文件。右击 assets 文件夹，选择“新建文件夹...New Folder...”，输入CurseForge 项目名称/命名空间/lang来一次性创建三个文件夹。最后在 lang 文件夹下新建zh_cn.json以及en_us.json文件，如果作者母语非英语且提供了其母语的语言文件，请一并新建。
7. 提交commit：对语言文件做出你想做的更改后，选择侧边栏“源代码管理Source Control”面板，在“源代码管理SOURCE CONTROL”你可以看到你做出的所有更改Changes。确认无误后，点击“暂存所有更改Stage all changes”图标“+”。随后在上方的消息message框中填入修改说明，再选择上方的提交并推送Commit & Push图标“√” 提交你的更改。
8. 准备 Pull request： 返回仓库的 Code 页，选择上方的“Pull request”，再选择“New pull request”，在弹出的页面中选择“compare across forks”，使得下方比较框呈现类似“base repository: CFPAOrg...”的状态。然后把 head repository 更改为你的仓库，compare 改为第 3 步创建的分支。如果操作正确，下方应会出现你上一步提交的更改。
9. 填写 Pull request 主对话：选择 Create pull request。仔细阅读提交模板中的事项并照做，把- [ ]改成- [x]（x，第二十四个字母）。如果有其他事项交代，插入到那些提示之前。
10. 提交 Pull request：选择输入框右下的“Create pull request”以创建 PR。如果汉化没有完成，可创建 draft PR，方法是点击“Create pull request”右侧的向下三角，然后选择“Create draft pull request”。

利用 GitHub 网页提交

查找或创建文件

1. Fork：选择页面最上方仓库名右侧按钮中的“Fork”。这时网页应跳转到名为 {你的用户名} / Minecraft-Mod-Language-Package 的仓库。
2. 搜索：确保你在“Code”页中。选择文件树上方的“Go to file”（转到文件）。输入命名空间查找。输入框在“……Language-Package /”的斜杠之后，如果丢失焦点请选择那里。
3. 找到文件：如果下方列表显示符合“文件路径”的文件，选择它，跳到下一个小节“commit change（提交更改）”，否则继续第 4 步。
4. 新建文件：选择导航栏中的“Code”返回主页，打开projects/{Minecraft 版本}/assets文件夹。选择右上角的“Add file”>“Create new file”，在“Name your file”输入框中输入{CurseForge 项目名称}/{命名空间}/lang/zh_cn.json（具体规则见“文件路径”一节）。

commit change（提交更改）

1. 进入编辑：选择文件右上角的“笔”形图标进入编辑，若是新建的文件则已经处于编辑中了。
2. 做出更改：做出你想要的更改。例如把本地的整个汉化文件粘贴过来。
3. Commit 中文：拉到网页底部，选择绿色的“Commit changes”或“Commit new file”。
4. Commit 英文：再次利用“Go to file”找到 en_us.json 或者 “Add file”一个 en_us.json，commit 它。
5. 准备 Pull request： 返回仓库的 Code 页，选择上方的“Pull request”，再选择“New pull request”，在弹出的页面中选择“compare across forks”，使得下方比较框呈现类似“base repository: CFPAOrg...”的状态。然后把 head repository 更改为你的仓库，compare 改为第 3 步创建的分支。如果操作正确，下方应会出现你上一步提交的更改。
6. 填写 Pull request 主对话：选择 Create pull request。仔细阅读提交模板中的事项并照做，把- [ ]改成- [x]（x，第二十四个字母）。如果有其他事项交代，插入到那些提示之前。
7. 提交 Pull request：选择输入框右下的“Create pull request”以创建 PR。如果汉化没有完成，可创建 draft PR，方法是点击“Create pull request”右侧的向下三角，然后选择“Create draft pull request”。

利用 GitHub Desktop 提交