码迷,mamicode.com
首页 > 其他好文 > 详细

GitHub 指导手册之第一个项目 Hello World

时间:2015-04-02 13:30:04      阅读:210      评论:0      收藏:0      [点我收藏+]

标签:github   git   

翻译的第一篇文章,翻译得不好,欢迎大家提修改意见。(另外还没翻完,后面修改后继续翻...)

原文地址:https://guides.github.com/activities/hello-world/

在计算机程序设计领域,Hello World算是老字号示例了。每当学一个新东西的时候,我们都可以通过Hello World来获得简单的练习。下面我们开始学习GitHub的Hello World吧!


GitHub是一个项目托管和协作的平台。你不用担心硬盘上的数据丢失,也不用费时间在不同计算机上同步以管理项目。最重要的是,GitHub能让软件工程在合作、异步工作流中完成得更好。


这个教程引导您熟悉GitHub的以下要点:Repositories代码仓库,Branches分支,Commits提交,Issues问题,以及Pull Requests。(注:Issue一直不知道翻译为什么好,就是能明白那个意思,但翻不过来。可能这里翻为“话题”更好些。)


熟悉这些操作,你就可以玩转GitHub了。通过这个hello-world示例代码仓库,你可以熟悉这个过程,而且也可以在这里记录你的很好的想法(也可以说是未来代码仓库,比如 jlord/hello-world),存储资源文件,或是记录一些笔记,甚至是在这里和别人进行讨论(比如holman/feedback)。


安装和代码自由区

在下面的教程中我们都是用GitHub.com来完成,所以你不需要知道命令行,甚至不需要安装Git(这是GitHub用以记录项目变化的软件)。你甚至都不需要知道怎么编程。但是,你需要一个GitHub账号;所以,如果你还没有一个账号,赶紧注册一个吧!

Tip:将这个指导页面在一个单独的浏览器窗口打开,这样当你执行下面步骤的时候可以很方便地看这个教程。


创建一个代码库

代码库是GitHub最基本的单元,通常意味着是一个单独的项目。代码库可以保护文件夹、文件,包括图片——任何你的项目需要的东西。我们推荐每个代码库都包含一个类似于README的描述项目的文件。当你创建一个新的代码库时,可以很方便地选择由GitHub自动创建一个这样的README文件。你也可以选择自动创建其他的文件如许可证等,这里我们暂时不考虑这些。


创建一个新的代码库具体步骤

1.      点击右上角、你的用户名旁边的 + 按钮;

2.      命名代码库为hello-world;

3.      写一个简短的项目描述;

4.      选择自动创建README(Initialize this repository with a README);

技术分享

点击创建代码库(Create repository)。哇唔,代码库创建好了!


新建一个通知Issue

Issue是关于该代码库需要注意的一些东西。它可以是一个bug,功能需求,一个问题或其他的一些东西。GitHub上,你可以通过打标签、搜索、分派issue很方便地管理一个active的项目。


现在你已经有了一个代码库,但是它暂时几乎还是空的。可以在README中提供多一些信息以便别人知道这个项目是干啥的。来,新建一个issue吧!


给README新建一个issue

1.      从工具栏中点击这个Issues标签;

2.      点击新建Issue(New Issue);

3.      填写Issue的标题和描述

技术分享

完成后点击提交新Issue(Submit new Issue)。这样这个issue就有了一个永久的URL,在你关闭后还可以使用这个URL。

后面就是你去编辑README这个文件以及关闭这个issue。


创建新分支

分支是用来同时在一个代码库的不同部分进行工作。当你创建一个代码库后,默认地它会有一个名为master的分支(主分支)。你可以就在这个分支上继续编写,也可以一直都只有这一个分支,这些都是可以的。但如果你有一个新功能或新想法想试一试,你可以基于master分支创建另一个新的分支,这样master分支可以保持当前的版本而不改变。


你创建一个分支时,其实你是对原分支的当前状态(就像快照)进行了一个复制。当你在新分支上进行修改时,如果原分支有了变化或修改,不用担心,你总是可以引入这些更新。

技术分享

在你之前的工作中,你也许保存过一个文件的不同版本,如”story.txt”、”story-joe-edit.txt”、”story-sue-edit.txt”。GitHub上的分支功能很方便地完成了这样的效果。

GitHub上,开发者、编码者以及设计者都新分支来调bug,以及在保留主分支(可能是一个产品)版本的情况下,增加一个新功能。当新功能完成后或bug调好了,将新分支合并到主分支中。


创建一个新分支的步骤

1.      首先到hello-world代码库页面;

2.      然后在文件列表最上面点击branch:master打开下拉框;

3.      输入一个分支名,如readme-edits;

4.      选择蓝色的“Createbranch”选项框,或直接回车。

技术分享

选择你有两个分支了,一个是master,一个是readme-edits。它们看起来是一样的,但只是暂时!以后我们在新分支里加入一些东西。


提交

GitHub中用以保存的操作叫做提交。提交是非常棒的一个操作,因为所有的提交版本在一起就是你的项目不断改进的记录。

 

每个提交都有一个相应的提交信息,一般用来描述为什么要进行一次修改。通过这些提交消息,你以及其他人可以很快明白你都做了哪些修改以及这样做的原因。

 

你应该仍在readme-edits分支的页面,现在进行一些修改吧!


提交修改的步骤

1.      点击README文件;

2.      点击文件栏右上角的铅笔样式按钮,对文件进行编辑;

3.      在编辑区写一些关于你自己的东西;

4.      再写一些描述你做的修改的信息。

技术分享

点击提供更改(Commit changes)。现在这些更改已经更新到readme-edits分支的README文件了,而且这个分支和master分支包含的文件和提交已经是不一样的了。


合并

合并是GitHub协同工作的核心。


GitHub 指导手册之第一个项目 Hello World

标签:github   git   

原文地址:http://blog.csdn.net/buxizhizhou530/article/details/44830081

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!