GitHub hello 入门

时间  2021-01-22 标签 GitHub 建立一个新仓库

【文章】https://github.com/

              https://guides.github.com/activities/hello-world/

 一、建立一个新仓库  

  1. 在最上面的右角上，有一个加号,点击选择New repository.
  2. 给仓库取个名字 hello-world.
  3. 简单描述一下这个项目的功能.
  4. 选择 Initialize this repository with a README.
    
    点击 Create repository.
二、分支
   1、基本概念：
       分支：在一个时间里，一个仓库工作在不同版本上的一种方式，就是代码的版本控制。
 默认的，你的仓库有一个名叫master的分支，这是最终分支，表示发布的最终工程.
我们使用分支进行实验并在提交之前进行编辑.

   总结：1）上面第一步后，默认的建立一个master分支存放代码

              2）可以再建立一个分支来修改master的代码

              3）然后再合并到master代码里面去。


 当你从一个master分支建立一个新的分支，你正在复制，或snapshot. 如果别人对master 分支做出修改，而你正工作在你的分支上,你能（拉进） pull in 这些，更新到你自己的分支上。

    图如下:
  • 建立工程后默认的建立一个 master 分支
  • 建立一个feature 新分支，(because we’re doing ‘feature work’ on this branch)
  • feature 分支经历以下几个过程后，然后合并到 master
      

   曾经保存一个文件的不同版本，一些像这样:

  • story.txt
  • story-joe-edit.txt
  • story-joe-edit-reviewed.txt

Branches 完成 GitHub repositories同样的目标。

在GitHub这儿, 我们 developers, writers, and designers 使用分支，使bug代码得到修复，且修复工作和产品分支相互分离。当修改分支代码改好后，他们才合并到master.

2、建立一个新分支
   1、去你新仓库 hello-world.
   2、往中间看，有一行button 按钮，最左边的，写着“branch: master”，然后点击下拉框   at the top of the file list that says branch: master.
   3、输入一个分支名字 readme-edits到文本框里。
   4、回车.

     现在你有两个分支， master and readme-edits.准确说，它们看起来完全一样, 但不会太久！紧接招我们增加我们的改变到新分支上。

 三、修改和提交
     太棒了!现在, 你已经在你代码 readme-edits 分支视图里面,是 master 复制品，让我们来开始编辑吧！

在 GitHub, 保存改变叫commits（提交）. 每一个commit有一个commit message相连接,它是解释改变的原因. Commit messages 捕获你改变的历史,因此其它贡献者能理解你已经做了什么，理由是什么。

  步骤：

  1. 点击 README.md 文件.
  2. 点击右边笔的图标去编辑.
  3. 在编辑器里，随便写一些关于你自己的信息。
  4. 写一个a commit message 描述你刚改变.
  5. 点击 Commit changes button.
      
   在你的 readme-edits 分支下， README文件做了改变, 因此现在这个分支包含的内容和master不一样。
四、 打开一个 Pull Request，这一过程非常重要，你能不能加入到项目的关键就看这一步了。

     你已经脱离  master分支，建立了新分支，且在新分支上做了修改。现在你能打开一个 pull request，向项目建立者提议你的改变，且请求某人审核你的代码，然后能把你拉入到贡献者中，最后合并改变的代码到master分支中。

    一旦你提交改变，你能打开一个 pull request ，然后供大家开始讨论, 是不是让你加入到项目中，一直到代码合并到master分支.这一个过程结束。

     在你的 pull request 信息中,通过使用GitHub’s @mention system向特定的人或团队发消息。,请求回复，不管他们在哪里。

     你甚至能在你自己的仓库中打开pull requests，合并它们. 在开发一个大项目之前，了解GitHub Flow是非常好的方法。     

  当改变README 后，打开一个 Pull Request

Click on the image for a larger version

步骤 截图
点击Pull Request tab, 然后从Pull Request页, 点击绿色 New pull request 按钮. pr-tab
选择你建立的分支 readme-edits, 去和 master 进行比较(the original). branch
在比较页，查看代码改变的地方，确保这些改变是你想要提交的。 diff
当你满意这些改变去提交，点击大绿色 Create Pull Request按钮。 create-pull
给你的pull request一个标题，然后写一个你改变的描述。 pr-form

When you’re done with your message, click Create pull request!

Tip: You can use emoji and drag and drop images and gifs onto comments and Pull Requests.

五、 合并 Pull Request

  把你的readme-edits 分支合并到 master 分支.

  1. 点击绿色的 Merge pull request 按钮去把改变的部分合并到master.
  2. 点击 Confirm merge.
  3. 继续删除修改的分支, 因为改变已经合并了， 点击Delete branch 按钮.

mergedelete

Celebrate!

By completing this tutorial, you’ve learned to create a project and make a pull request on GitHub! :tada: :octocat: :zap:

Here’s what you accomplished in this tutorial:

  • Created an open source repository
  • Started and managed a new branch
  • Changed a file and committed those changes to GitHub
  • Opened and merged a Pull Request

     看看你的GitHub profile，然后你看见你是新的贡献者 contribution squares!

To learn more about the power of Pull Requests, we recommend reading the GitHub Flow Guide. You might also visit GitHub Explore and get involved in an Open Source project :octocat:

Tip: Check out our other Guides, YouTube Channel and On-Demand Training for more on how to get started with GitHub.

联系我们 沪ICP备13005482号-10