通过 Github 贡献

先决条件

为了能够通过拉取请求做出贡献，有几个先决条件：

知道如何使用最少的 Git
拥有一个 Github 帐户
有一个你希望贡献的项目的分支

在进入细节之前，有必要对词汇表做一个小的说明。这是我们在 Git/Github 中经常使用的一个小词汇表：

repo：“Repository”的缩写。我们使用这个词来指定一组使用 Git 进行版本控制的文件。
分支：这是 Git 项目中的一个分支。分支允许您在历史的某个时间点创建代码的并行版本。
master：指定回购的主要分支。
origin：指定远程仓库。例如，托管在 Github 上。
拉取请求：这是允许您对 Github 上的项目提出代码修改的操作。
fork：这是一个 repo，它是另一个 repo 的副本。这使您可以从现有项目开始修改、改进、更正或使用它做其他事情。
upstream：在 fork 的情况下，指定 fork 来自的 repo。
fetch：这是在本地从远程检索数据的操作。
推送：这是允许将本地数据发送到远程的操作。

配置

分叉

要做的第一件事是去 Github，为你希望贡献的项目创建一个 fork。

例如，要为 Leek Wars 客户端做出贡献，请转到此处：Leek Wars Client

然后，只需单击右上角的“fork”按钮。

通过“分叉”该项目，Github 将在您的帐户上创建一个新的 repo。这将是原始项目的副本。

然后通过 url 地址或单击绿色的“克隆或下载”按钮获取 github 存储库的地址。

转到要放置本地 repo 的位置并使用命令： git clone \ 不要忘记替换“\”。

所以。您已经创建了该项目的叉，并且您已经在您的机器上本地检索了它。但是为了以后能够无后顾之忧的继续使用，还需要做一件事。

上游

然后您必须配置 upstream，这将允许您从项目一更新您的 repo。

git remote -v 命令允许您列出配置的远程地址。

来源 https://github.com/YOUR_USERNAME/YOUR_FORK.git（获取）来源 https://github.com/YOUR_USERNAME/YOUR_FORK.git（推送）

现在，您应该看到两个配置为 origin 的地址。一个在 fetch 中，当你想从你的 remote 恢复新功能时，你的 repo 托管在 Github 上。而另一个在 push 中，相反，它允许您将本地新闻发送到远程 repo。

为此，我们将添加上游。为此，请获取您刚刚分叉的项目的地址。始终通过 url 或“克隆或下载”按钮。

添加 upstream 的命令是：git remote add upstream \

如果您再次运行 git remote -v 命令，您现在应该会看到四个条目。两个用于 origin，两个用于 upstream。每个都复制成一个 fetch 和一个 push。

来源 https://github.com/YOUR_USERNAME/YOUR_FORK.git（获取）来源 https://github.com/YOUR_USERNAME/YOUR_FORK.git（推送）上游 https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git （获取）上游 https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git（推送）

你现在准备好贡献了！

保持最新状态

（如果你只是 fork，则不需要步骤。）

很可能您正在参与的项目并非一成不变。照顾它的人会让它进化。其他贡献可能会被接受。

因此，您的 repo 很快就会过时。这可能是个问题。

如果最初一个文件包含“A”，而你想提交一个将这个“A”更改为“B”的贡献。与此同时，也许其他人会把这个“A”改成“C”。

而当你提出你的修改意见时，就会出现冲突。无法将“A”更改为“B”，因为文件中不再存在“A”。

简而言之，重要的是保持 repo 是最新的以避免不愉快的意外。

别担心，现在您已经配置了上游，这将是小菜一碟！

要做的第一件事就是获得新的 m