首页 > 代码库 > GitHub 创建 HelloWord仓库

GitHub 创建 HelloWord仓库

一、简介

创建HelloWord是学习编程传统而又有效的方法,现在这个简单的练习会带你一起学习一个全新的东西--------GitHub!
GitHub提供了一个团队和作的平台,你不必担心数据的丢失,也不必为管理多台电脑上的工程而烦恼,因为GitHub是分布式的、异步的。最重要的是,GitHub这样的特性让你更方便的与团队的协作。

一下是GitHub的要点:

Repositories(仓库), Branches(分支), Commits(提交), Issues(发布) 和 Pull Requests(拉拽请求).
使用GitHub你会走得更远。

安装和代码空间

你将在GitHub.com完成这个教程,在这里你不需要知道命令行和安装Git,甚至不需要知道怎么去码代码,你只要一个github账号,如果你还没有的话,赶紧注册一个吧!

二、创建仓库

仓库是GitHub 的一个基本单元,也是最常见的项目工程。 仓库可以包含文件夹或文件,包括图片等任何你工程需要的东西。所以我们建议你在每一个工程里面都包含一份README文件来描述这个工程。因此在你创建工程的时候GitHub提供了一个简单的README文件创建选项。它还提供了其他常见的选项如一个许可证文件,但目前我们可以跳过。

1、点击你github主页右上角用户名边上的+号按钮
2、为你的仓库命名如:HelloWord
3、写一个简单的描述
4、选择为这个仓库创建一个README文件

5、点击创建仓库。成功创建!

三、编写Issues

一个issue不仅仅是一个仓库需要注意的,这也许是一个bug,一个特性要求,一个问题或许多其他的事情,在GitHub可以标签,搜索和分配问题,简化管理一个活跃的项目。现在你已经有了一个空的仓库。它可以使用README,让人们知道这是一个什么项目。那么现在编写issue!

  1. 点击边上的  Issues 标签
  2. 点击New Issue
  3. 填写标题和描述
完成后点击提交new issue 。这时这个issue就有了一个url连接,你甚至可以直接用url访问这个issue。

接下来编辑你的README,最后关闭issue。

四、创建一个分支

创建分支是在一个仓库下进行不同分支编写的方式。

在你创建一个仓库的时候就存在了一个默认的分支master,你可以继续在这个分支上工作,但是哪天你有了一个新的想法的时候你就可以在此基础上创建另一个分支上实践你的想法,而不受原来主分支的束缚。

当你创建了一个分支的时候,其实也就是在拷贝一份现有的分支,你可以同时修改多个分支,当主分支改变了,不要担心,你可以随时更新、合并子分支。


在平时,你保存不同版本的文件也许是“story.txt”, “story-joe-edit.txt”, “story-sue-edit.txt”以这样的方式,但实现同样的管理GitHub更加简单。

在github,开发者、作者、设计师用分支来修复bug,实践新的想法。当bug修复,或者新想法实现的时候,你可以随时合并到主分支去。

步骤:

1、进入你新建的仓库HelloWord
2、在你的文件列表上点击下拉框branch:master
3、输入分支的名称readme-edit,然后点击创建


现在你就有了两个分支,一个主分支,一个子分支。现在它们是一样的,但是等会我们就要修改它们,并最后合并它们。

做一次commit

在GitHub,保存被称为commit(提交),Commit是非常让人骄傲的,因为这就是你项目的发展史。每一次的commit都关联一个提交描述信息message,这个信息包含了你为什么做了这些修改,就是这些信息让他人可以更简单的理解你做了什么。

接下来继续打开readem-edit分支的代码视图,现在来做一些改变。

提交修改

1、点击README文件
2、点击编辑
3、在编辑页面,写点东西,就写点关于你自己的信息吧
4、编写message信息

点击提交修改,README文件就在你的readme-edit分支做了修改,现在在主分支和子分支就有了不一样的内容。

五、打开一个Pull Request(合并请求)

pull request是GitHub团队合作的核心,当你提出一个pull request的时候,gtihub允许你比较两个分支的不同,哪些被改过,哪些被新建,并且显示绿色的可以合并和红色的不可以合并的提示。
 
一旦你做了修改,你就可以提出一个合并请求,通过使用@mention system系统在你的请求消息,您可以要求特定的人或团队的反馈。你甚至可以把子项目和子项目合并,这样可以发展出更大的项目,

为readme文件创建合并请求

步骤截图
点击Pull Request按钮,然后在pull request页面点击绿色的pull request 按钮 create pr
选择你创建的分支, readme-edits, 和 master主分支比较branch
查看你的修改,确定你是不是要提交修改diff
当你确定你的修改的时候,请点击绿色的按钮进行提交create-pull
给你的提交写一个标题,因为它直接影响到一个issue的问题,最后写一个简短的描述pr-form
但一切的ok后点击Send Pull Request!

合并请求

现在是时候让你的修改的分支进行合并了
1、点击绿色的按钮,合并你的修改到master
2、点击Confirm merge.
3、继续或者删除子分支,合并成功后你可以点击Delete branch 去删除分支


恭喜
你已经成功做了一个合并请求:tada: :octocat: :zap:


注:第一次翻译外文,由于本人英语也不好,在翻译软件的帮助下勉勉强强的完成了。感谢大家可以看完这次的译文。