git+jekyll部署备忘

github，会自动帮忙编译jekyll编写的文件，只要将文件放到gh-pages分支

(或者使用官方教程的二级域名方式，项目名字，可以随便起，官网的例子是 用户名.github.com 作为项目名字，可以使用  用户名.github.com  访问项目）

本文主要讲分支方式

登录后，访问https://github.com/new，创建仓库如下图：

 

 

创建本地仓库有2个方法

1.git clone https://github.com/username/abc 最终步骤可用username.github.io/abc访问；(.io或者.com均可)

其余步骤按照官网的即可

 

但是这个没有把页面放到gh-pages分支，所以建议还是提交前的步骤要转到下面设置；

2.手动调整

本地编辑及上传

在磁盘上创建一个目录，该目录与上面的项目名同名，在该目录下启用Git Bash命令行，并输入如下命令

1 $ git init

该命令实际上是在该目录下初始化一个本地的仓库，会在目录下新建一个.git的隐藏文件夹，可以看成是一个仓库数据库。

创建一个没有父节点的分支gh-pages，并自动切换到这个分支上。

1 $ git checkout --orphan gh-pages

$ git add .
$ git commit -m "first post"
$ git remote add origin https://github.com/username/projectName.git
$ git push origin gh-pages

1. 将当前的改动暂存在本地仓库
2. 将暂存的改动提交到本地仓库，并写入本次提交的注释是”first post“
3. 将远程仓库在本地添加一个引用：origin 第三部这个会失败，换个方式处理(h1.github.io,这个可以改为任意字符串，例如abc，这里是早期学习时的小bug...)

      git remote set-url origin https://github.com/tongxunlu/h1.github.io.git
      (git好像可有可无)

      git remote -v 查看位置是否写对，如下图：

4.向origin推送gh-pages分支，该命令将会将本地分支gh-pages推送到github的远程仓库，并在远程仓库创建一个同名的分支。该命令后会提示输入用户名和密码。

     现在，你可以泡杯咖啡，并等大约10分钟的时间，访问http://username.github.com/projectName就可以看到生成的博客了

 

 

参考资源 ：http://stackoverflow.com/questions/1221840/remote-origin-already-exists-on-git-push-to-new-repository 解决origin问题

 http://pages.github.com/ 官网

http://pchou.info/web-build/2013/01/05/build-github-blog-page-02.html 

域名配置教程

http://jekyllcn.com/docs/github-pages/ 

 

 

 

2014-08-20-补充

本地可以按照教程直接源码解压后的一级目录就得，注意配置一下配置文件，_config.yml指定对应参数；

 

按照官方的page.github.com教程，新建的项目是master，访问就是 用户名.github.io,

1.通常这种项目是单一不会带其他项目；

2.如果有其他子项目就必须通过二级目录的方式来访问，但是不建议，1个归1个；

 

总结如下：

1.如果是独立的项目，就按照官方教程page.github.com，来设置blog；

2.如果是组织公司，统一一个帐号，下属很多项目，就要用二级目录访问项目，例如

：http://teamwingui.github.io/ui2/

如果子项目众多，这时候，就根据官方教程步骤，建立一个父 pages，来索引子项目作为超链接，这个方式不错；

3.关于gh-pages,如果是通过第二种方式生成的，则建议，初始化时，先生成master项目，然后再生成gh-pages分支；（操作步骤，window客户端，比较简单，publish）

4.jekyll的配置，要根据官方教程，配置一下，由于bootstrap的项目文档，按照官方教程，可以直接jekyll serve运行，但是上传到github则不得，上传时，只能上传文档的源码，和_config.yml