转: 借助GitHub托管你的项目代码

转自:http://www.cnblogs.com/edisonchou/p/5990875.html

备注: 原贴关于github使用说明,非常详细易懂。建议看原帖。

借助GitHub托管你的项目代码

PS:话说自己注册了GitHub都很久了,却没有怎么去弄,现在系统学习一下,也把自己的学习经历总结下来share给大家,希望大家都能把GitHub用起来,把你的项目代码happy地托管起来!

一、基本概念

  1.1 必须了解的概念

  (1)仓库 - Repository

  仓库即你的项目,你想在GitHub上开源一个项目,那就必须要新建一个Repository。如果你开源的项目有多个,那么你就有多个Repositories。

  (2)收藏 - Star

  收藏项目,方便下次查看。如果你的项目被收藏的次数越多,那么你的项目也就越受广大开发者的欢迎咯。

  (3)复制克隆项目 - Fork

  如果你开源了一个项目,别人想在你这个项目的基础之上做些改进,然后应用到自己的项目中,这时他就可以Fork你的项目,然后他的GitHub主页上就多了一个项目,只不过这个项目是基于你的项目为基础(本质上是在你的项目基础之上建立了一个分支Branch)。Fork之后,他就可以随心所欲地去改进,但是丝毫不会影响原有项目的代码与结构。

  (4)发起请求 - Pull Request

  如果别人在你的项目基础之上做了一些改进,并且觉得改得很不错,应该要把这些改进让更多的人受益。于是,他就想把自己的改进合并进原有项目之中,这时他就可以发起一个Pull Request。而原有项目创建人也就是你,可以收到这个请求,这个时候你可能会仔细review他的代码,并且测试后觉得OK,就可以接受他的Pull Request,之后他做的改进就可以融入到原有项目之中了。

  (5)关注 - Watch

  类似于微博中的关注,如果你Watch了某个项目,那么以后只要这个项目有任何更新,你都会第一时间收到关于这个项目的通知提醒。

  (6)事务卡片 - Issue

  你开源了一个项目,别人发现你的项目中有bug,或者哪些地方做的不够好,他就可以给你提一个Issue(即问题)。你如果看到了这些Issue,就可以逐个去Fix修复,修复OK之后就可以一个一个地Close掉。

  (7)GitHub主页

  如果你注册了一个GitHub账号,那么久会有一个属于你的GitHub主页,该页面左侧主要显示用户动态以及关注用户/仓库的动态,右侧则显示所有的Git库。

  (8)仓库主页

  仓库主页主要显示项目的信息,如:项目代码、版本、收藏/关注/Fork情况 等等。

  (9)个人主页

  个人信息:头像、个人简介、关注我的人,我关注的人,我关注的Git库,我的开源项目,我贡献的开源项目信息 等等。

  你可以通过下图“形(Xie)象(E)”地理解GitHub主页。

  看完上面这张图,你是不是秒懂呢?

  1.2 必须完成的准备

  要使用GitHub,首先必须得注册一个GitHub账号啦!

  注册过程很easy,就跟你平时注册小网站会员一样,详细信息可以浏览:点此了解注册详情

  需要注意的地方就是,选择Free免费账号完成设置!那么收费的跟免费的有什么区别呢?私有的仓库只有自己或者指定的朋友才有权限操作。

  注册完成之后,记住要验证邮箱!如果未验证邮箱,那么你是没法做后续操作的。

二、GitHub基本操作

  2.1 创建仓库

  在GitHub中点击New repository活着Start a Project即可:

  现在我新建一个仓库,这个仓库假设是我写的一个数据结构的实例程序Demo程序库:

  Step1.填写必要信息:

  Step2.浏览仓库主页

  2.2 创建文件

  在刚刚的仓库主页中点击 Create new file 按钮,即可进入新文件页面:

  Step1.填写必要信息之文件信息

  Step2.填写必要信息之记录信息

  Step3.浏览提交文件记录

  Step4.浏览具体文件信息

  2.3 编辑文件

  在指定的文件名处直接点击文件名链接,即可进入编辑界面:

  Step1.点击文件名:

  Step2.修改文件信息

  假如我们要加入一行文本信息:

  继续填写提交记录日志信息:

  Step3.浏览修改后的文件

  2.4 删除文件

  在指定的文件名处直接点击文件名链接,即可进入文件信息界面,点击删除按钮:

  Step1.点击删除按钮

  Step2.填写日志记录并点击Commit Changes

  Step3.删除的文件不会出现在项目结构中,只能通过提交日志记录查看:

  

  2.5 上传文件

  在仓库主页点击Upload files按钮进入上传页面,选择要上传的文件,点击上传即可。注意:这里可以一次性上传多个文件。

  2.6 搜索仓库文件

  在仓库主页点击Find file按钮,即可进入搜索页面:

  假如我要搜索log,由于项目中没有log文件,所以没有搜索结果:

  2.7 下载/检出项目

  在仓库主页点击Clone or download按钮,即可弹出下载提示框:

  2.8 GitHub Issues

  假如张三发现了李四的开源项目中存在一个bug,那么张三就可以为这个项目新建一个issue,我们可以把它理解为项目的问题列表,参与这个项目的开发者们可以在问题列表中进行交流:

  Step1.新建Issue

  Step2.填写Issue信息,告知项目开发者

  Step3.修复完成之后,可以回复Issue信息,告知提问者该Issue已修复

  Step4.一般来说会由提问者来Close这个Issue,当然也可以由项目拥有者来Close。

  

  2.9 Fork 复制克隆一个开源项目

  假设我最近对StackExchange.Redis这个开源客户端项目很感兴趣,那么我可以Fork一下,看看有什么可以学习有什么可以优化的,我只需要点击Fork按钮,即可一秒建立一个Branch:

  克隆之后,你的主页会多一个project,并且会注明forked from StackExchange.Redis

  如果你在修改完善了部分代码之后觉得你想把你的change融入到原有项目之中,让更多的人受益,那么你可以发起一个Pull Request:

  点击之后,会显示所有你的修改,相当于你在提交之前review一下你的修改记录,这里我啥也没改,所以显示 There isn’t anything to compare.

  当你commit你的change之后,原有项目的所有者就会在他的GitHub主页看到谁谁谁提交了他的代码,并会看到你的comment。

  这时,他就可以看到你做的文件修改,并选择review你的代码,最后决定是否merge到他的原有项目之中。

  好了,现在我们来复习一下GitHub基本流程:

三、Git基本操作

  3.1 安装Git

  可以去官网选择下载,这里使用的是Git-2.9.0 64位版本:点我下载

  全程傻瓜化安装,下一步即可,可以把命令模式和图形界面模式都勾选上。

  3.2 Git基本流程

  3.3 Git初始化操作及仓库管理

  这里我们主要采用命令行模式,这也是Linux服务器的精髓所在,图形模式很easy,看看就会了。

  (1)设置基本信息

-- 设置用户名

git config --global user.name ‘zhangsan‘

-- 设置账户邮箱

git config --global user.email ‘[email protected]‘  

  新建一个文件夹作为你的Git Workspace,然后打开Git Bash命令行界面:

  (2)初始化一个新的Git仓库

  Step1.创建一个仓库文件夹,这里取名跟刚刚在GitHub里面一样的DataStructure.Demo.CSharp

  Step2.在文件内初始化Git(创建Git仓库)

--初始化

git init

  (3)向仓库中添加文件

  假设我们写了一个MyArrayStack类,我们把他copy到该文件夹中,使用以下命令加入到暂存区中:

git add MyArrayStack.cs

  然后我们需要将暂存区文件添加到仓库:

git commit -m ‘add MyArrayStack.cs‘

  这时我们再通过git status查看,你会发现已经没有什么文件更改或要提交的文件了。

  (4)修改文件

  当你修改了文件之后,通过git status可以查看到你修改了什么东西,同样还是要经历提交到暂存区再提交到仓库的步骤,此处不再赘述。

  (5)删除文件

  当你不再想要某个代码文件时,你可以通过git rm filename的命令删除文件:

git rm MyArrayStack.cs

  3.4 使用Git管理远程仓库

  我们刚刚提到Git的基本流程是工作区到暂存区再到Git仓库,那么Git仓库和远程仓库又是如何联系起来的呢?

  (1)Git克隆操作:将远程仓库复制到本地

git clone https://github.com/edisonchou/DataStructure.Demo.CSharp  

  (2)修改代码,按照老步骤提交到Git仓库

  这里因为原始项目是啥也没有,所以我索性把我之前写的一个数据结构的Demo程序库直接拖动到了这个文件夹中。

-- 添加所有文件

git add --all 

git status

git commit -m ‘add solution code‘ 

  这时我们已经提交到了git仓库,需要同步到github远程仓库了:

git push

-- 后面可能会要求你输入账号和密码

  这时我们再次进入GitHub主页,可以看到我们的项目已经有刚刚同步的代码了:

  PS:如果出现git push错误,提示The requested URL returned error : 403 Forbidden while accessing.你可以输入用户名密码或者远程地址采用这种类型(vi.git/config)

  将[remote "orgin"] url=https://github.com/用户名/仓库名.git

  改为[remote "orgin"] url=https://github.com/用户名:密码@github.com/用户名/仓库名.git

四、GitHub Pages搭建网站

  4.1 个人站点

  GitHub要求个人站点的仓库名称必须是 用户名.github.io, 例如edisonchou.github.io

  建立方法很简单,也是新建一个repository,然后填写你的个人站点名,例如 edisonchou.github.io。之后通过Git,你可以将你在本地开发的html网页同步到github,之后你就可以通过域名访问你的个人站点啦!

  发布之后的个人站点如下:

  4.2 项目站点

  搭建后的访问域名为:https://用户名.github.io/仓库名

  (1)进入项目主页,点击Settings

  (2)在Settings页面,点击Launch automatic page generator来自动生成主题页面

  (3)新建站点基础信息设置

  (4)选择主题

  (5)生成网页

参考资料

(1)GitHub-百度百科

(2)手把手教你最简单的开源项目托管

(3)怎么使用GitHub-知乎

(4)廖雪峰-Git教程

(5)杨晓辉-GitHub for Windows使用教程 => Windows下可以使用GitHub for Windows工具进行操作,很方便!

作者:周旭龙

出处:http://www.cnblogs.com/edisonchou/

本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文链接。

时间: 2024-11-04 22:46:36

转: 借助GitHub托管你的项目代码的相关文章

借助GitHub托管你的项目代码

PS:话说自己注册了GitHub都很久了,却没有怎么去弄,现在系统学习一下,也把自己的学习经历总结下来share给大家,希望大家都能把GitHub用起来,把你的项目代码happy地托管起来! 一.基本概念 1.1 必须了解的概念 (1)仓库 - Repository 仓库即你的项目,你想在GitHub上开源一个项目,那就必须要新建一个Repository.如果你开源的项目有多个,那么你就有多个Repositories. (2)收藏 - Star 收藏项目,方便下次查看.如果你的项目被收藏的次数越

windows环境下使用git客户端、github和tortoisegit管理项目代码

一.为什么 为什么不用svn? svn是一个优秀的代码和版本管理工具,使用svn只需要搭建好svn中央仓库,配置本地svn客户端即可,自从google code关闭服务之后,互联网上已经没有非常好的公共svn仓库,如果是公司内部使用,还可以用上公司内网搭建的svn服务器,但个人就没那么方便了. 为什么用git? git和svn同样作为代码和版本管理工具,git的理念更先进,而且公共git仓库github真的好用,众多优秀的开源项目都放在github 什么是git.github.tortoiseg

GitHub托管

借助GitHub托管你的项目代码 PS:话说自己注册了GitHub都很久了,却没有怎么去弄,现在系统学习一下,也把自己的学习经历总结下来share给大家,希望大家都能把GitHub用起来,把你的项目代码happy地托管起来! 一.基本概念 1.1 必须了解的概念 (1)仓库 - Repository 仓库即你的项目,你想在GitHub上开源一个项目,那就必须要新建一个Repository.如果你开源的项目有多个,那么你就有多个Repositories. (2)收藏 - Star 收藏项目,方便下

iOS:使用Github托管自己本地的项目代码

管理代码的地方主要有:Github(国外流行).CocoaChina.Cocoa4App.中国开源社区.CSDN.博客园.简书等等..... 现在主要介绍如何使用Github托管自己的项目代码. 尊重原创,特地说明接下面的介绍转载自简书:http://www.jianshu.com/p/f3cba0a3f1bd 注意: 此教程只针对iOS项目,其他项目请参考此网站 http://jingyan.baidu.com/article/b907e627aadbb246e7891cf1.html 1.首

iOS:使用Github托管自己本地的项目代码方式三(命令行方式: Terminal Line)

使用终端命令行将本地项目代码上传到github上进行托管 对于IOS开发者来说,Github的使用是必须要掌握的一种技能,而把项目由本地上传到Github有多种方式 1.开发工具Xcode配置Git,由Xcode-->Source Control-->Commit: 2.使用Github客户端上传代码: 3.使用终端命令行上传到Github.其中我的Github地址有我根据实际项目制作的一个配置说明书https://github.com/FISHBALL1/Xcode-git ,现在来介绍第三

使用git和github管理项目代码

以前不知道使用代码管理工具,最后写的一些东西都没有了,由于硬盘坏了或者不小心格式化了之类的,后来使用了Git 和Github来托管自己的代码和读书笔记方便了不少,到哪里只要有网就可以把自己的东西拷贝下来继续使用. 我这里简单的记录一下我使用的过程,最简单的使用都是,高级的功能我一直没有使用到,虽然买一本<Git权威指南> 但是很多东西用不到就不能够真的会.下面开始简单介绍我使用的方法,我这个是在windows上使用的.我使用分两种情况, 因为我的代码都是在Linux下写的,所以在linux下主

在GitHub上创建上传下载开源项目代码

1.注册GitHub帐号,创建GitHub项目代码仓库 1.1.注册GitHub帐号 在使GitHub之前,需要先登录其官网注册一个免费使用的账号.登录 https://github.com/join?source=header-home进行注册. 1.2 在GitHub上添加SSH Key 为什么要在GitHub上添加SSH Key呢?因为 GitHub 需要识别出提交的代码确实是你提交的而不是别人.Git支持SSH协议,因此GitHub只要知道了你的公钥,就可以确认代码是你提交的.当然, G

spring framework项目源码github托管地址

方法一:直接下载,github托管地址:http://repo.spring.io/simple/libs-release-local/org/springframework/spring/ 方法二:svn检出 一次性源码全量包下载的方法.spring的项目包会托管到github网站上,所以可以从github网站上得到spring任意版本的全量包(使用svn客户端下载),方法如下:1.安装svn客户端,随便使用自己喜欢的一个就行,通常用的最多的是TortoiseSVN.自己下载安装.2.检出(下

使用github for windows 来将代码托管到github中

本博文只是简单的介绍一下使用github for windows 来将代码托管到github上,可能讲得不会太深入, 如果想深入了解原理性的东西,可以去阅读一下<GIT权威指南>这本书~~~~本人觉得挺不错的... 其实简单总结以下,git的简单使用无非是上传.下载.修改,导入工程. 以下讲解均默认你已经正确安装了github for windows. 一.上传代码 1.在github官网上,用你的账户创建一个新的仓库(repository,简写repo). 该过程的图示如下图所示: 1) 2