翻译的第一篇文章,翻译得不好,欢迎大家提修改意见。(另外还没翻完,后面修改后继续翻...)
原文地址: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:将这个指导页面在一个单独的浏览器窗口打开,这样当你执行下面步骤的时候可以很方便地看这个教程。
1. 点击右上角、你的用户名旁边的 + 按钮;
2. 命名代码库为hello-world;
3. 写一个简短的项目描述;
4. 选择自动创建README(Initialize this repository with a README);
点击创建代码库(Create repository)。哇唔,代码库创建好了!
现在你已经有了一个代码库,但是它暂时几乎还是空的。可以在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分支包含的文件和提交已经是不一样的了。
原文地址:http://blog.csdn.net/buxizhizhou530/article/details/44830081