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

新建一个通知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协同工作的核心。

时间: 2024-08-01 17:56:38

GitHub 指导手册之第一个项目 Hello World的相关文章

学习phalcon框架按照官网手册搭建第一个项目注册功能

中文手册官网:http://phalcon.ipanta.com/1.3/tutorial.html#bootstrap 官网提供http://www.tutorial.com项目源码github地址:https://github.com/phalcon/tutorial 搭建时候需要注意的问题: 1.虚拟主机的搭建: <VirtualHost *:80> DocumentRoot "D:/web/tutorial/" ServerName www.tutorial.com

[个人翻译]GitHub指导文件(GitHub Guides[Hello World])

[个人翻译]GitHub指导文件(GitHub Guides[Hello World]) Mirage_j个人翻译,欢迎转载,最好标明出处http://www.cnblogs.com/mirageJ/ 原文地址https://guides.github.com/activities/hello-world/ Hello World是电脑编程史上悠久而又传统的工程.学习新事物时我们通常会以这个简单的小程序作为开始.我们就以此为开头了解GitHub吧! 通过这篇指导,你会学到如何: 建立并使用rep

&lt;转&gt;从Java转iOS第一个项目总结

从Java转iOS第一个项目总结 阅读目录 0.前言 1.项目介绍 2.项目使用的第三方开源库 3.工具和插件介绍 4.集成友盟 5.即时通讯 6.项目总结 0.前言 本人14年12月份,从网站开发组转到了移动开发组,自己的java两年半工作经验变成了object-c零经验.2015年1月份新启动了一个移动项目,年后因为人事变动,自己从辅助开发变成了"核心"开发,目前项目基本接近尾声,下面进行总结,希望对一些人能有帮助, 另外也希望ios大牛进行指导 回到顶部 1.项目介绍 项目属于一

[转] 从Java转iOS第一个项目总结

0.前言 本 人14年12月份,从网站开发组转到了移动开发组,自己的java两年半工作经验变成了objective-c零经验.2015年1月份新启动了一个移动 项目,年后因为人事变动,自己从辅助开发变成了"核心"开发,目前项目基本接近尾声,下面进行总结,希望对一些人能有帮助, 另外也希望iOS大牛进行指导 1.项目介绍 项目属于一款社区类软件,包含小组/帖子,视频,文章,评论,推荐搜索,即时通讯,好友,第三方登录/分享,推送等,涵盖常用app的基本功能 2.项目使用的第三方开源库 ht

Java 注解指导手册 – 终极向导

原文链接 原文作者:Dani Buiza 译者:Toien Liu  校对:深海 编者的话:注解是java的一个主要特性且每个java开发者都应该知道如何使用它. 我们已经在Java Code Geeks提供了丰富的教程, 如Creating Your Own Java Annotations, Java Annotations Tutorial with Custom Annotation 和 Java Annotations: Explored & Explained. 我们也有些文章是关于

【转载】如何在 Github 上发现优秀的开源项目?

之前发过一系列有关 GitHub 的文章,有同学问了,GitHub 我大概了解了,Git 也差不多会使用了,但是还是搞不清 GitHub 如何帮助我的工作,怎么提升我的工作效率? 问到点子上了,GitHub 其中一个最重要的作用就是发现全世界最优秀的开源项目,你没事的时候刷刷微博.知乎,人家没事的时候刷刷 GitHub ,看看最近有哪些流行的项目,久而久之,这差距就越来越大,那么如何发现优秀的开源项目呢?这篇文章我就来给大家介绍下. 1. 关注一些活跃的大牛 GitHub 主页有一个类似微博的时

28款GitHub最流行的开源机器学习项目

http://ml.ailab.cn/article-76485.html 现在机器学习逐渐成为行业热门,经过二十几年的发展,机器学习目前也有了十分广泛的应用,如:数据挖掘.计算机视觉.自然语言处理.生物特征识别.搜索引擎.医学诊断.DNA序列测序.语音和手写识别.战略游戏和机器人等方面. 云栖社区特意翻译整理了目前GitHub上最受欢迎的28款开源的机器学习项目,以供开发者参考使用. 1. TensorFlow TensorFlow 是谷歌发布的第二代机器学习系统.据谷歌宣称,在部分基准测试中

(转载)如何在 Github 上发现优秀的开源项目?

转载自:传送门 之前发过一系列有关 GitHub 的文章,有同学问了,GitHub 我大概了解了,Git 也差不多会使用了,但是还是搞不清 GitHub 如何帮助我的工作,怎么提升我的工作效率? 问到点子上了,GitHub 其中一个最重要的作用就是发现全世界最优秀的开源项目,你没事的时候刷刷微博.知乎,人家没事的时候刷刷 GitHub ,看看最近有哪些流行的项目,久而久之,这差距就越来越大,那么如何发现优秀的开源项目呢?这篇文章我就来给大家介绍下. 1. 关注一些活跃的大牛 GitHub 主页有

如何在 Github 上发现优秀的开源项目?

之前发过一系列有关 GitHub 的文章,有同学问了,GitHub 我大概了解了,Git 也差不多会使用了,但是还是搞不清 GitHub 如何帮助我的工作,怎么提升我的工作效率? 问到点子上了,GitHub 其中一个最重要的作用就是发现全世界最优秀的开源项目,你没事的时候刷刷微博.知乎,人家没事的时候刷刷 GitHub ,看看最近有哪些流行的项目,久而久之,这差距就越来越大,那么如何发现优秀的开源项目呢?这篇文章我就来给大家介绍下. 1. 关注一些活跃的大牛 GitHub 主页有一个类似微博的时