一步步讲解如何开源自己的项目到GitHub上,Mac机示例

如果你有自己的优秀项目,想要分享给大家,那GitHub会是你正确的选择。如何才能将自己的项目上传到GitHub上呢?接下来请一步一步跟着走。

需要准备的资源:

    1.一台Mac机

    2.安装git客户端(下载地址:http://code.google.com/p/git-osx-installer/downloads/list?can=3),下载好直接安装就好。

    3.一个GitHub账户(注册地址:https://github.com/join?source=header-home)

    4.一个电子词典(如果是英文水平不错的小伙伴,就不需要了,因为注册流程为全英的,其他操作也是英文的)

    5.你的项目

准备好上面的以后就可以开始了。

一.创建属于你的SSH。SSH是Secure Shell的缩写,意为安全外壳协议,具体内容请百度搜索“SSH”。创建步骤如下:

1.1在GitHub网站登录后,找到下图所示的按钮,选择“Settings”

1.2接下来你会看到下图,选择“SSH and GPG keys”

1.3接下来就可以新建你的SSH keys,找到下图中所示的按钮“New SSH keys”

问题来了

这两个框框里填什么呢?

不要着急,下面的代码框里的东西会告诉你里面应该填什么,不过这里我们可能要岔开一会,讲一讲这两个框里的东西从哪来?不要着急,很短,不要跑神儿哦!不过我会提醒你再回到正轨上的。

打开终端

黑题是要手动输入的,“/**/”里时提示语,告诉你那里是干嘛用的$ssh-keygen -t rsa -C [email protected]   /*注册github时的email*/
        Generating public/private rsa key pair.
        Enter file in which to save the key (/Users/.../.ssh/id_rsa): /*此处光标会停下来,等待你的输入,不用输入,直接回车“enter/return”*/
        Created directory ‘/Users/.../.ssh‘.
        Enter passphrase (empty for no passphrase): /*此处是让你设置你SSH的密码,不输的话,默认没有密码*/
        Enter same passphrase again: /*重新输入密码,用来验证*/
        Your identification has been saved in /Users/.../.ssh/id_rsa.
        Your public key has been saved in /Users/.../.ssh/id_rsa.pub.
        The key fingerprint is:
        18:16:11:c9:01:6c:48:09:7f:27:c6:43:0d:7f:3f:84 [email protected]
        The key‘s randomart image is:
        +--[ RSA 2048]----+
        |.o.++===         |
        |.ooo.+. .       |
        |  ..* = E .      |
        |   o = + o       |
        |      . S o      |
        |           .     |
        |                 |
        |                 |
        |                 |
       +-----------------+

接下来请打开上面显示的路径(打开文件管理器,commend+shift+g,将路径粘贴进去回车),你就可以看到两个文件“id_rsa”和“id_rsa.pub”,使用文本编辑器打开“id_rsa.pub”将其中的内容全部复制。

好了放松一下,回到正轨上啦!且回到刚刚的网页,首先在“Title”下的文本框中输入你的注册邮箱,在“Key”下的文本框中粘贴刚刚复制的东西,点击带有“Add SSH key”字样的绿色按钮,就大功告成了。

二.创建完自己的SSH后,请创建你的项目的profile。

2.1还记得刚刚GitHub网站停留在哪一页吗?对,是设置SSH keys那一页,现在,在这一页找到下图所示的按钮,点击“New repository”

2.2你会看到

2.3接下来是要填入信息的解释:Repository name ->你项目的名称;Description->你项目的简单描述;下面的单选决定该项目是公有还是私有,公有时所有人都可以看,私有时可以选择给谁看;下面的复选框决定是否将你的项目介绍写入“README.md”文件。接下来点击“Create repository”即可。

三.好了,上传项目的工作已经接近尾声,坚持住,往下看。

3.1打开终端,输入以下命令

cd ~/.ssh

如果上面的步骤都没问题,此时你应该会进入该路径。下面将会发生神奇的事,在终端中即可完成代码的上传工作。

上传前请确保终端已经连接到GitHub,输入以下命令测试

ssh -T [email protected]

连接成功的返回应该是

Hi "your name"! You‘ve successfully authenticated, but GitHub does not provide shell access.

3.2以此键入以下命令

touch README.md //新建一个记录提交操作的文档
git init //初始化本地仓库
git add README.md //添加文件
git commit -m "first commit"//提交到本地仓库,并注释
git remote add origin [email protected]:youname/Test.git //连接远程仓库并建了一个名叫:origin的别名
git push -u origin master //将本地仓库的东西提交到地址是origin的地址,master分支下

上面的代码做了什么?其实它只是讲一个文本文件提交到了“master”分支上,没什么特别的,值得注意的是,里面的“add”,“commit”和“push”三个操作,“add”可以添加多个文件分多行键入,也可添加当前目录下的所有文件“add .”即可,“commit”操作是提交到本地仓库,注意是本地仓库,这一操作不会影响远端的代码;“push”操作则是将本地修改的代码push到远端分支。

3.3最后一步,上传你的项目到GitHub。键入以下命令

首先切换到你项目所在的路径
git init
git add .
git commit -m "first commit"
git remote add origin [email protected]:youname/Test.git
git push -u origin master

解释一下,上面现切换到你的项目所在的路径,从而可以使用“add .”命令将项目所有问价都上传到GitHub。

3.4本来到这你应该已经把自己的项目成功上传上去了,但是,也可能会遇见一些问题

例如

To [email protected]:PaulPaulBoBo/ForHealth.git
 ! [rejected]        master -> master (non-fast-forward)
error: failed to push some refs to ‘[email protected]:xxx.git‘
hint: Updates were rejected because the tip of your current branch is behind
hint: its remote counterpart. Integrate the remote changes (e.g.
hint: ‘git pull ...‘) before pushing again.
hint: See the ‘Note about fast-forwards‘ in ‘git push --help‘ for details.

上面说上传一些“refs”错误,在pushing之前请pull,为什么会这样呢?原因是本地代码跟远端的冲突造成的,应该先将远端的代码拉回到本地再上传。

git pull --rebase
git push --dry-run --verbose origin HEAD:master
git push origin HEAD:master

这样就可以解决冲突问题了。当然,后期开发的时候,如果冲突问题比较多的话,还得手动修改某些冲突文件后才可以上传。推荐使用SourceTree客户端(下载地址:https://www.sourcetreeapp.com/download/)。

好了,项目上传完毕,你可以跟全世界一起讨论你的项目了!  

时间: 2024-10-10 03:56:03

一步步讲解如何开源自己的项目到GitHub上,Mac机示例的相关文章

GitHub Android 最火开源项目Top20 GitHub 上的开源项目不胜枚举,越来越多的开源项目正在迁移到GitHub平台上。基于不要重复造轮子的原则,了解当下比较流行的Android与iOS开源项目很是必要。利用这些项目,有时能够让你达到事半功倍的效果。

1. ActionBarSherlock(推荐) ActionBarSherlock应该算得上是GitHub上最火的Android开源项目了,它是一个独立的库,通过一个API和主题,开发者就可以很方便地使用所有版本的Android动作栏的设计模式. 对于Android 4.0及更高版本,ActionBarSherlock可以自动使用本地ActionBar实现,而对于之前没有ActionBar功能的版本,基于Ice Cream Sandwich的自定义动作栏实现将自动围绕布局.能够让开发者轻松开发

Linux下git的使用——将已有项目放到github上

本地已经有一个项目了,需要将该项目放到github上,怎么操作? 步骤: 本地安装git,有github账号是前提. (1)先在github创建一个空的仓库,并复制链接地址.使用https,以.git结尾的那个地址. (2)初始化本地仓库,并提交内容到本地 要先打开命令行终端,然后通过cd命令切换到需要添加到github的项目的目录下,然后依次执行如下命令,具体命令及其含义如下: touch README.md --创建说明文档 git init --初始化本地仓库 git add . --添加

第一次使用Git上传本地项目到github上

对于程序原来说都听说过GitHub,GitHub有许多开源的的项目和一些前沿的技术.因为自己在刚刚开始使用Git把自己写的一些小dome放到GitHub上遇到许多的坑,这么长时间过去了,想对第一次使用Git上传代码做一下总结,以免使自己忘记. 1.下载Git软件:https://git-scm.com/downloads,据说ios自带的有git软件,这个我就不太清楚了. 2.下载之后安装就很简单了,一路下一步就可以了.安装完成后鼠标右击和者开始->程序会出现,打开Git Bash,进入bash

git 把本地创建的项目放到github上

很早之前就注册了Github,但对其使用一直懵懵懂懂,很不熟练.直到昨天做完百度前端技术学院的task,想把代码托管到Github上的时候发现自己对于Git的操作是如此之愚钝,所以今天决定把Git好好学习一遍,好让自己以后能更好地使用Github,主要还是通过Git教程 - 廖雪峰的官方网站来学习.简要步骤可以直接看最后的总结. Git的安装就不说了. 第一步:我们需要先创建一个本地的版本库(其实也就是一个文件夹). 你可以直接右击新建文件夹,也可以右击打开Git bash命令行窗口通过命令来创

命令行提交本地项目到github上

1.github账号要有. 2.配置ssh key ①  defaults write com.apple.finder AppleShowAllFiles -bool true     终端 显示隐藏文件(需要重新运行Finder). ② 点击桌面顶部菜单  前往>个人  看看自己电脑上有没有个 .ssh 的隐藏文件,有的话个人建议删除,新建个. ③  mkdir .ssh    终端新建个 .ssh文件 ④  cd .ssh   进入到刚才新建的.ssh文件目录下 ⑤  ssh-Keygen

用git上传本地项目到github上

首先确认自己已经安装了git,打开git bash,输入ssh-keygen -t rsa -C "自己的邮箱地址@XXX.com" ,生成自己的公钥与私钥   一路默认回车,会生成公钥.私钥到以下文件夹下id_rsa是私钥,id_rsa.pub是公钥,打开公钥等下要用到   浏览器进入自己的github,打开设置,进入ssh and GPG keys   点击NEW ssh key,自己填个标题,下面内容复制前面打开的公钥,最后添加   可以用ssh -T [email protec

通过Git Gui Here上传本地项目到GitHub上

1. 打开git Gui Here,选择 Create New Repository(在本地创建一个仓库),如下 2.选择你所要托管的项目本地存放的位置(即本地新建仓库的位置),如: 3.完成点击创建以后,会弹出可视化窗:点击Remote-->Add... 4. 弹出以下框以后输入你Github的用户名(如shanerou是我的github名称)和你需要将你本地的项目放在Github的远程仓库的地址,如我在Github上创建了一个repository名称为Test的,然后添加如下,点击创建,弹出

如何托管你的项目到github上详细教程

一.首先你要有三个东西  github账号.上传工具msysgit 和 你的项目. 1.注册一个github账号 要托管到github,那你就应该要有一个属于你自己的github帐号,所以你应该先注册一个账号. 打开浏览器,在地址栏输入地址:https://github.com(如下图),填写用户名(name20151231).邮箱([email protected]).密码(********),点击Sign up for GitHub ,跳转到下一界面,拖动到页面最下面点击Finish Sig

PUSH项目到Github上

添加已有项目到github 新建repository,可以在github网站上直接新建或者使用windows github工具. 进入github repository 项目 在github windows工具中使用git Bash打开项目,使用cd命令进入已有项目根目录下 touch README.md //新建说明文件 git init //在当前项目目录中生成本地git管理,并建立一个隐藏.git目录 git add . //添加当前目录中的所有文件到索引 git commit -m "f