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均可)
其余步骤按照官网的即可
![](https://note.wiz.cn/api/document/files/unzip/4f0de0c7-d8c2-11df-afb9-0e452e19f47b/4bb5472c-a7e8-41b5-8145-eb88d84757c0.6005/index_files/1cae9cd7ee4225b75f6913e4d0d1d460.jpg)
但是这个没有把页面放到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
$ git commit -m "first post"
$ git remote add origin https://github.com/username/projectName.git
$ git push origin gh-pages
- 将当前的改动暂存在本地仓库
- 将暂存的改动提交到本地仓库,并写入本次提交的注释是”first post“
- 将远程仓库在本地添加一个引用:origin 第三部这个会失败,换个方式处理(h1.github.io,这个可以改为任意字符串,例如abc,这里是早期学习时的小bug...)
git remote set-url origin https://github.com/tongxunlu/h1.github.io.git
(git好像可有可无)
git remote -v 查看位置是否写对,如下图:
![](https://note.wiz.cn/api/document/files/unzip/4f0de0c7-d8c2-11df-afb9-0e452e19f47b/4bb5472c-a7e8-41b5-8145-eb88d84757c0.6005/index_files/071f0908869a09ec4e7204bffc10b852.jpg)
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/ 官网域名配置教程
2014-08-20-补充
本地可以按照教程直接源码解压后的一级目录就得,注意配置一下配置文件,_config.yml指定对应参数;
按照官方的page.github.com教程,新建的项目是master,访问就是 用户名.github.io,
1.通常这种项目是单一不会带其他项目;
2.如果有其他子项目就必须通过二级目录的方式来访问,但是不建议,1个归1个;
总结如下:
1.如果是独立的项目,就按照官方教程page.github.com,来设置blog;
2.如果是组织公司,统一一个帐号,下属很多项目,就要用二级目录访问项目,例如
如果子项目众多,这时候,就根据官方教程步骤,建立一个父 pages,来索引子项目作为超链接,这个方式不错;
3.关于gh-pages,如果是通过第二种方式生成的,则建议,初始化时,先生成master项目,然后再生成gh-pages分支;(操作步骤,window客户端,比较简单,publish)
4.jekyll的配置,要根据官方教程,配置一下,由于bootstrap的项目文档,按照官方教程,可以直接jekyll serve运行,但是上传到github则不得,上传时,只能上传文档的源码,和_config.yml