diff --git a/sources/tech/20190730 How to create a pull request in GitHub.md b/sources/tech/20190730 How to create a pull request in GitHub.md deleted file mode 100644 index 3c8ace6cf4..0000000000 --- a/sources/tech/20190730 How to create a pull request in GitHub.md +++ /dev/null @@ -1,144 +0,0 @@ -[#]: collector: (lujun9972) -[#]: translator: (furrybear) -[#]: reviewer: ( ) -[#]: publisher: ( ) -[#]: url: ( ) -[#]: subject: (How to create a pull request in GitHub) -[#]: via: (https://opensource.com/article/19/7/create-pull-request-github) -[#]: author: (Kedar Vijay Kulkarni https://opensource.com/users/kkulkarnhttps://opensource.com/users/fontanahttps://opensource.com/users/mhanwellhttps://opensource.com/users/mysentimentshttps://opensource.com/users/greg-p) - -如何在Github上创建一个拉取请求 -====== -Learn how to fork a repo, make changes, and ask the maintainers to -review and merge it. -![a checklist for a team][1] - -So, you know how to use git. You have a [GitHub][2] repo and can push to it. All is well. But how the heck do you contribute to other people's GitHub projects? That is what I wanted to know after I learned git and GitHub. In this article, I will explain how to fork a git repo, make changes, and submit a pull request. - -When you want to work on a GitHub project, the first step is to fork a repo. - -![Forking a GitHub repo][3] - -Use [my demo repo][4] to try it out. - -Once there, click on the **Fork** button in the top-right corner. This creates a new copy of my demo repo under your GitHub user account with a URL like: - - -``` -`https://github.com//demo` -``` - -The copy includes all the code, branches, and commits from the original repo. - -Next, clone the repo by opening the terminal on your computer and running the command: - - -``` -`git clone https://github.com//demo` -``` - -Once the repo is cloned, you need to do two things: - - 1. Create a new branch by issuing the command: - - -``` -`git checkout -b new_branch` -``` - - 2. Create a new remote for the upstream repo with the command: - - -``` -`git remote add upstream https://github.com/kedark3/demo` -``` - - - - -In this case, "upstream repo" refers to the original repo you created your fork from. - -Now you can make changes to the code. The following code creates a new branch, makes an arbitrary change, and pushes it to **new_branch**: - - -``` -$ git checkout -b new_branch -Switched to a new branch ‘new_branch’ -$ echo “some test file” > test -$ cat test -Some test file -$ git status -On branch new_branch -No commits yet -Untracked files: -  (use "git add <file>..." to include in what will be committed) -    test -nothing added to commit but untracked files present (use "git add" to track) -$ git add test -$ git commit -S -m "Adding a test file to new_branch" -[new_branch (root-commit) 4265ec8] Adding a test file to new_branch - 1 file changed, 1 insertion(+) - create mode 100644 test -$ git push -u origin new_branch -Enumerating objects: 3, done. -Counting objects: 100% (3/3), done. -Writing objects: 100% (3/3), 918 bytes | 918.00 KiB/s, done. -Total 3 (delta 0), reused 0 (delta 0) -Remote: Create a pull request for ‘new_branch’ on GitHub by visiting: -Remote:   -Remote: - * [new branch]         new_branch -> new_branch -``` - -Once you push the changes to your repo, the **Compare & pull request** button will appear in GitHub. - -![GitHub's Compare & Pull Request button][5] - -Click it and you'll be taken to this screen: - -![GitHub's Open pull request button][6] - -Open a pull request by clicking the **Create pull request** button. This allows the repo's maintainers to review your contribution. From here, they can merge it if it is good, or they may ask you to make some changes. - -### TLDR - -In summary, if you want to contribute to a project, the simplest way is to: - - 1. Find a project you want to contribute to - 2. Fork it - 3. Clone it to your local system - 4. Make a new branch - 5. Make your changes - 6. Push it back to your repo - 7. Click the **Compare & pull request** button - 8. Click **Create pull request** to open a new pull request - - - -If the reviewers ask for changes, repeat steps 5 and 6 to add more commits to your pull request. - -Happy coding! - -In a previous article , I discussed the complaints that have been leveled against GitHub during the... - -Arfon Smith works at GitHub and is involved in a number of activities at the intersection of open... - --------------------------------------------------------------------------------- - -via: https://opensource.com/article/19/7/create-pull-request-github - -作者：[Kedar Vijay Kulkarni][a] -选题：[lujun9972][b] -译者：[译者ID](https://github.com/译者ID) -校对：[校对者ID](https://github.com/校对者ID) - -本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 - -[a]: https://opensource.com/users/kkulkarnhttps://opensource.com/users/fontanahttps://opensource.com/users/mhanwellhttps://opensource.com/users/mysentimentshttps://opensource.com/users/greg-p -[b]: https://github.com/lujun9972 -[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/checklist_hands_team_collaboration.png?itok=u82QepPk (a checklist for a team) -[2]: https://github.com/ -[3]: https://opensource.com/sites/default/files/uploads/forkrepo.png (Forking a GitHub repo) -[4]: https://github.com/kedark3/demo -[5]: https://opensource.com/sites/default/files/uploads/compare-and-pull-request-button.png (GitHub's Compare & Pull Request button) -[6]: https://opensource.com/sites/default/files/uploads/open-a-pull-request_crop.png (GitHub's Open pull request button) diff --git a/translated/tech/20190730 How to create a pull request in GitHub.md b/translated/tech/20190730 How to create a pull request in GitHub.md new file mode 100755 index 0000000000..56bebaa9ae --- /dev/null +++ b/translated/tech/20190730 How to create a pull request in GitHub.md @@ -0,0 +1,137 @@ +[#]: collector: "lujun9972" +[#]: translator: "furrybear" +[#]: reviewer: " " +[#]: publisher: " " +[#]: url: " " +[#]: subject: "How to create a pull request in GitHub" +[#]: via: "https://opensource.com/article/19/7/create-pull-request-github" +[#]: author: "Kedar Vijay Kulkarni https://opensource.com/users/kkulkarnhttps://opensource.com/users/fontanahttps://opensource.com/users/mhanwellhttps://opensource.com/users/mysentimentshttps://opensource.com/users/greg-p" + + + +如何在Github上创建一个拉取请求 +====== +学习如何复刻一个仓库，进行更改，并要求维护人员审查并合并它 + +![a checklist for a team][1] + +所以，你知道如何使用 git。 你有一个 [GitHub][2] 仓库并且可以向它推送。这 一切都很好。 但是你如何为他人的 GitHub 项目做出贡献？ 这是我在学习 git 和 GitHub 之后想知道的。在本文中，我将解释如何复刻一个 git 仓库、进行更改并提交一个拉取请求。 + +当你想要在一个 GitHub 项目上工作时，第一步是复刻一个仓库。 + +![Forking a GitHub repo][3] + +你可以使用[我的演示仓库][4]试一试. + +一旦在这个页面，单击右上角的 Fork （复刻）按钮。这将在你的GitHub用户账户下创建我的演示仓库的一个新副本，其统一资源定位符如下： + + +``` +`https://github.com/<你的用户名>/demo` +``` + +这个副本包含了原始仓库中的所有代码，分支和提交。 + +接下来，打开你计算机上的终端并运行命令来克隆仓库： + + +``` +`git clone https://github.com/<你的用户名>/demo` +``` + +一旦仓库被克隆后，你需要做两件事： + + 1. 通过发出命令创建一个新分支 `new_branch` ： + +``` +`git checkout -b new_branch` +``` + + 2. 使用以下命令为上游仓库创建一个新的远程（ remote ）： + +``` +`git remote add upstream https://github.com/kedark3/demo` +``` + +在这种情况下，“上游仓库”指的是你创建复刻来自的原始仓库。 + +现在你可以更改代码了。 以下代码创建一个新分支，进行任意更改，并将其推送到 **new_branch** 分支： + +``` +$ git checkout -b new_branch +Switched to a new branch ‘new_branch’ +$ echo “some test file” > test +$ cat test +Some test file +$ git status +On branch new_branch +No commits yet +Untracked files: +  (use "git add <file>..." to include in what will be committed) +    test +nothing added to commit but untracked files present (use "git add" to track) +$ git add test +$ git commit -S -m "Adding a test file to new_branch" +[new_branch (root-commit) 4265ec8] Adding a test file to new_branch + 1 file changed, 1 insertion(+) + create mode 100644 test +$ git push -u origin new_branch +Enumerating objects: 3, done. +Counting objects: 100% (3/3), done. +Writing objects: 100% (3/3), 918 bytes | 918.00 KiB/s, done. +Total 3 (delta 0), reused 0 (delta 0) +Remote: Create a pull request for ‘new_branch’ on GitHub by visiting: +Remote:   +Remote: + * [new branch]         new_branch -> new_branch +``` + +一旦你将更改推送到您的仓库后， **Compare & pull request（比较和拉取请求）** 按钮将出现在GitHub。 + +![GitHub's Compare & Pull Request button][5] + +单击它，你将进入此屏幕： + +![GitHub's Open pull request button][6] + +单击 **Create pull request（创建拉取请求）** 按钮打开一个拉取请求。 这允许仓库的维护者们审查你的贡献。 从这个页面，如果你的贡献是好的，他们可以合并它，或者他们可能会要求你做一些改变。 + +### 太长，别看 + +总之，如果您想为一个项目做出贡献，最简单的方法是： + 1. 找到您想要贡献的项目 + 2. 复刻它 + 3. 将其克隆到你的本地系统 + 4. 建立一个新的分支 + 5. 进行你的更改 + 6. 将其推送回你的仓库 + 7. 单击**Compare & pull request（比较和拉取请求）**按钮 + 8. 单击**Create pull request（创建拉取请求）**以打开一个新的拉取请求 + +如果审阅者要求更改，请重复步骤5和6，为你的拉取请求添加更多提交。 + +快乐编码！ + +在之前的一篇文章中，我讨论了在...期间针对GitHub的投诉。 + +Arfon Smith在GitHub工作，并在开放的十字路口参与了许多活动...... + +-------------------------------------------------------------------------------- + +via: https://opensource.com/article/19/7/create-pull-request-github + +作者：[Kedar Vijay Kulkarni][a] +选题：[lujun9972][b] +译者：[译者ID](https://github.com/译者ID) +校对：[校对者ID](https://github.com/校对者ID) + +本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 + +[a]: https://opensource.com/users/kkulkarnhttps://opensource.com/users/fontanahttps://opensource.com/users/mhanwellhttps://opensource.com/users/mysentimentshttps://opensource.com/users/greg-p +[b]: https://github.com/lujun9972 +[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/checklist_hands_team_collaboration.png?itok=u82QepPk "a checklist for a team" +[2]: https://github.com/ +[3]: https://opensource.com/sites/default/files/uploads/forkrepo.png "Forking a GitHub repo" +[4]: https://github.com/kedark3/demo +[5]: https://opensource.com/sites/default/files/uploads/compare-and-pull-request-button.png "GitHub's Compare & Pull Request button" +[6]: https://opensource.com/sites/default/files/uploads/open-a-pull-request_crop.png "GitHub's Open pull request button"