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

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

原文地址: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)。哇唔,代码库创建好了!

新建一个通知IssueIssue是关于该代码库需要注意的一些东西。它可以是一个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.在编辑区写一些关于你自己的东西;

当世界给草籽重压时,它总会用自己的方法破土而出。

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

相关文章:

你感兴趣的文章:

标签云: