创建新项目

转载 2012年03月30日 17:35:46

3.1. 创建新项目

3.1.1. 新版本库即是新项目

在GitHub,一个项目对应唯一的Git版本库,创建一个新的版本库就是创建一个新的项目。访问仪表板(Dashboard)页面,如图3-1,可以看到关注的版本库中已经有一个,但自己的版本库为零。在显示为零的版本库列表面板中有一个按钮“New Repository”,点击该按钮开始创建新版本库。

../images/new-repo-btn.png

图3-1:版本库列表面板

新建版本库的界面如图3-2所示。

../images/new-project.png

图3-2:创建新项目

我们为新建立的版本库命名为“helloworld”,相应的项目名亦为“helloworld”,创建完毕后访问项目页,提示版本库尚未初始化,并给出如何初始化版本库的帮助,如图3-3所示。

../images/project-uninitial.png

图3-3:项目尚未初始化

在图3-3中可以看到访问协议增加了一个支持读写的SSH协议,访问地址为:git@github.com:gotgithub/helloworld.git。注意任何GitHub用户均可使用该URL访问此公开版本库,但只有版本库建立者gotgithub具有读写权限,其他人只有只读权限。在初始化版本库之前,最好先确认是否是用正确的公钥进行认证,如下:

$ ssh -T git@github.com
Hi gotgithub! You've successfully authenticated, but GitHub does not provide shell access.

3.1.2. 版本库初始化

如果是从头创建版本库,可以采用先克隆,建立提交数据,最后再通过推送完成GitHub版本库的初始化。步骤如下:

  • 克隆版本库。

    克隆过程会显示警告,不过这个警告可以忽略,因为GitHub创建的版本库本来就是一个空白的版本库。

    $ git clone git@github.com:gotgithub/helloworld.git
    Cloning into 'helloworld'...
    warning: You appear to have cloned an empty repository.
  • 创建文件README.md[1]

    下面是一段示例文字,把这段文字保存为文件README.md,该文件的内容将会直接显示在项目首页中(显示效果参见后面的图3-5)。

    # 我的第一个GitHub项目
    
    这是项目 [helloworld](https://github.com/gotgithub/helloworld) ,
    欢迎访问。
    
    这个项目的版本库是 **Git格式** ,在 Windows、Linux、Mac OS X
    平台都有客户端工具可以访问。虽然版本库只提供Git一种格式,
    但是你还是可以用其他用其他工具访问,如 ``svn`` 和 ``hg`` 。
    
    ## 版本库地址
    
    支持三种访问协议:
    
    * HTTP协议: `https://github.com/gotgithub/helloworld.git` 。
    * Git协议: `git://github.com/gotgithub/helloworld.git` 。
    * SSH协议: `ssh://git@github.com/gotgithub/helloworld.git` 。
    
    ## 克隆版本库
    
    操作示例:
    
        $ git clone git://github.com/gotgithub/helloworld.git

    上面这段文字采用Markdown格式,您也可以使用其他支持的格式,只要确保README文件使用正确的扩展名。本书附录部分介绍了Markdown及其他GitHub支持的标记语言。关于Markdown,目前我们只需知道这一个易于识别和理解的纯文本格式,可以方便的转换为HTML。Markdown语法非常像我们在写邮件(纯文本)时用空行来分隔段落、用星号开启列表、用缩进表示引用内容等等。

  • 添加README.md文件并提交。

    $ git add README.md
    $ git commit -m "README for this project."
  • 向GitHub推送,完成版本库初始化。

    $ git push origin master

然后查看GitHub上新建项目的首页。项目首页的上半部分可见版本库包含了一个新的提交,以及版本库目录树中包含的文件,如图3-4所示。

../images/project-pushed-head.png

图3-4:完成推送后的项目首页上半部分

在项目首页的下半部分,会看到README.md文件被转换为HTML显示,如图3-5所示。

../images/project-pushed-tail.png

图3-5:完成推送后的项目首页下半部分

3.1.3. 从已有版本库创建

如果在GitHub项目初始化之前,数据已经存在于本地版本库中,显然像上面那样先克隆、再提交、后推送的方法就不适宜了。应该采用下面的方法。

为试验新的版本库初始化方法,先把刚刚新建的测试项目“helloworld”删除,同时也将本地工作区中克隆的“helloworld”删除。警告:删除项目的操作非常危险,不可恢复,慎用。

  • 点击项目首页中项目名称旁边的“Admin”按钮进入项目管理页,再点击页面最下方的删除版本按钮,如图3-6所示。

    ../images/project-delete.png

    图3-6:删除项目

  • 然后再重建版本库“helloworld”,如本章一开始图3-2所示。

接下来使用下面的步骤完成“helloworld”版本库的初始化。

  • 本地建立一个Git版本库。

    $ mkdir helloworld
    $ cd helloworld
    $ git init
  • 然后在版本库中添加示例文件,如README.md文件,内容同前。

    $ git add README.md
    $ git commit -m "README for this project."
  • 为版本库添加名为origin的远程版本库。

    $ git remote add origin git@github.com:gotgithub/helloworld.git
  • 执行推送命令,完成GitHub版本库的初始化。注意命令行中的-u参数,在推送成功后自动建立本地分支与远程版本库分支的追踪。

    $ git push -u origin master

[1] 以扩展名.md.mkd.mkdn.mdown.markdown等为结尾的文件,均以Markdown标记语言语法进行解析并显示。

Yii2.0 advanced如何添加新项目(添加application)

Yii2.0 advanced如何添加新项目(添加application)
  • shuzipai
  • shuzipai
  • 2017年02月03日 11:01
  • 668

创建新项目

复制以下文件 ant.properties ant_build.xml build.xml custom_rules.xml gamekey project.properties ...
  • cuijiahao
  • cuijiahao
  • 2014年10月11日 15:44
  • 271

PHPStrom+Wamp新建项目需要的一些基础设置

调试需求分类: 需求一:如果从后台(。PHP) 开始调试的话,点右上角编辑配置,添加PHP Web Application (填写相对应的Start URL 路径   并  选择Server(每...
  • weixin_34335563
  • weixin_34335563
  • 2017年08月11日 10:37
  • 159

创建Z-Stack项目的工具(Create Z-Stack Project For IAR)

Create Z-Stack Project For IAR      做Zigbee开发用CC2530肯定会用到Z-Stack,而开发环境一般选IAR Embedded Workbench,但是...
  • codegame
  • codegame
  • 2015年04月29日 12:09
  • 883

git基本环境配置和创建一个项目Demo

听说github是个很好的东西,这两天开始接触github,
  • u012217085
  • u012217085
  • 2014年05月13日 13:44
  • 1058

Cocos2d-lua-3.8.1在Cocos code ide中创建新项目的问题

[LUA ERROR] [string "cocos/cocos2d/Cocos2dConstants.lua"]:559: attempt to index a nil value
  • dl15600383645
  • dl15600383645
  • 2015年10月20日 15:38
  • 906

IntelliJ IDEA 使用---创建新项目(Java项目、JavaWeb)

一、创建Java项目 1、进入到IntelliJ IDEA启动界面,点击Create New Project  然后选择你下载的jdk的版本即可(本人安装的是JDK1.8的版本)。 ...
  • chengtengfei352
  • chengtengfei352
  • 2018年01月30日 23:19
  • 29

Coding创建项目

Coding创建项目创建项目在Coding的可视化界面上git操作 初始化仓库:git init 查看仓库状态:git status 添加文件项目(前提是项目文件必须在本地新建的文件夹下或者该文件的子...
  • kidmiddle
  • kidmiddle
  • 2016年12月18日 11:24
  • 799

git 新添加一个项目

如何将一个新的项目放到制定的git地址上: 1、创建一个项目 2、在githup上添加一个仓库: 3、在命令行模式下:在指定的目录下 git init(此处需要修改一下...
  • current112233
  • current112233
  • 2017年03月23日 10:38
  • 357

快速在sublime的一个目录下新建文件

(1)安装 AdvancedNewFile插件,ctrl+shift+p弹出 package control 然后选择 package control install(直接输入i就可快速找到),然后输...
  • liangrongliu1991
  • liangrongliu1991
  • 2017年03月26日 15:34
  • 462
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:创建新项目
举报原因:
原因补充:

(最多只允许输入30个字)