 |
Visual Studio Code |
|---|
万事开头难。第一次做某件事情的时候总是很困难，尤其是在协作的时候，犯错并不是一件舒服的事情。但是开源的本质就是协作和共同工作。我们希望简化新的开源贡献者第一次学习和贡献的方式。
阅读文章和观看教程会有所帮助。但是，有什么比在不搞砸任何东西的情况下实际操作更好的呢？这个项目旨在提供指导并简化新手进行首次贡献的方式。记住：你越放松，学习效果就越好。如果你正在寻找进行你的第一次贡献，只需按照下面的简单步骤操作即可。我们保证，这会很有趣。
如果你的电脑上还没有安装 Visual Studio Code，请点击此处安装。
注意： 本教程是在 Windows 10 系统上使用 Visual Studio Code（版本 1.27.2）制作的。在本教程的后面部分，我们将使用一些键盘快捷键。这些快捷键在其他操作系统（macOS/Linux）以及不同的键盘语言（英国、德国等）上可能会有所不同。你可以通过在命令面板中搜索"快捷键"来查看你的快捷键列表。
点击页面右上角的 fork 按钮来 fork 这个仓库。这会在你的 GitHub 账户中创建一个该仓库的副本。
GitHub 会记录你的仓库和你 fork 的源仓库之间的关系。你可以把你的仓库看作是一个工作副本。
大多数顶级 GitHub 仓库（即不是从其他仓库 fork 而来的仓库）都有一个小型的核心团队，可以直接提交更改。所有其他贡献者必须 fork 仓库，在 fork 后的仓库中进行更改，然后创建一个 Pull Request 来请求将他们的更改合并回顶级仓库。如果顶级仓库管理员喜欢这些更改，它们就会被合并，你会立即获得名气和财富！稍后我们会详细介绍如何做到这一点。
下一步是将你的仓库克隆到你的电脑上，这样你就可以开始进行更改了。VS Code 需要你的仓库的 URL，所以点击 code 按钮，然后点击"复制到剪贴板"图标。
注意： 新贡献者常犯的一个错误是克隆你 fork 来源的仓库，而不是克隆你自己的仓库。检查你的浏览器地址栏，确保你克隆的是你自己的仓库。
现在打开 Visual Studio Code。VS Code 的欢迎页面会弹出。在那里按下 F1 打开下面显示的命令栏。注意文本字段中已经有一个 >（大于号）符号。你也可以通过按下 CTRL-P 然后输入 > 字符来打开输入提示。
你可能会注意到下面已经列出了一些晦涩的命令。这些是我最近使用的命令，所以不用在意它们。
现在输入 git clone，或者只输入 git 或 clone（它就像搜索一样工作）。
选择 Git: Clone 选项，然后按 Enter 键。
粘贴你仓库的 URL，然后按 Enter 键。这会打开一个文件资源管理器，你可以在其中选择 Git 仓库的存储位置。
重要提示： 确保这是你 fork 的仓库，而不是原始仓库，否则它将无法工作。
你应该会在 Visual Studio Code 的右下角看到一个状态弹出窗口。完成后，你可以使用对话框中的按钮打开克隆的仓库（现在是你电脑上的一个文件夹）。
再次按 F1 打开命令面板。输入 branch，然后从那里选择 create branch 命令。下一步输入你的新分支的名称，例如 add-david-kroell。按回车键，分支就会被创建。该分支也已经被检出。什么是检出？
打开 Contributors.md 文件，在文件的任意位置添加你的名字。这个文件使用 GFM（GitHub 风格的 Markdown），这是 Markdown 语法的一个专有变体。
复制其他贡献者的某一行，然后用你的名字修改它，以确保语法正确——Markdown 对语法要求很严格。保存文件以记录更改。
在 VS Code 的左侧有一个显示 5 个图标的菜单。选择版本控制/源代码管理图标。 （快捷键：Ctrl + Shift + G）
文件资源管理器会显示上次提交后所有被更改的文件。将鼠标悬停在文件上，点击 +（加号）就可以暂存文件。
在资源管理器顶部的输入栏中输入一些内容，然后点击对勾按钮。现在更改已经提交到你的本地副本。接下来需要将更改推送回 GitHub。
使用三点图标打开菜单，在菜单中选择 Publish Branch 选项。这会打开一个对话框，让你输入你的 GitHub 凭据。
到目前为止，你已经完成了更改，但这些更改仍然只存在于你的仓库中。这一步将向你展示如何向顶级仓库的管理员提交请求，以合并你的更改。
在你 GitHub 上的仓库中，你会在新分支通知旁边看到 Compare & pull request 按钮。点击这个按钮。
现在提交 pull request。
我很快就会把你所有的更改合并到这个项目的主分支中。一旦更改被合并，你会收到一封通知邮件。
恭喜你！你刚刚完成了作为贡献者经常会遇到的标准 fork -> clone -> edit -> PR 工作流程！
你可以前往网页应用庆祝你的贡献，并与你的朋友和关注者分享。