设置github上项目主页

 

在github上设置项目首页有三种方式

 

1.新建分支gh-pages

新建独立分支gh-pages
git checkout --orphan gh-pages

删除暂存区内容
git rm -rf .

增长项目内容
echo "project home page" > index.html

提交
git add .
git commit -m "gh-pages first commit"
git push origin gh-pages

完成后便可访问 http://<github username>.github.io/<github project name>/

特色：

• 单独创建一个分支与项目自己分离，对于非网站类项目很是合适，避免与源码之间的耦合
• github会自动识别gh-pages分支做为项目pages的来源，无需设置
• 单独管理文档，不予项目的提交放在一块儿

2.在master分支上

在master分支上增长index.html文件做为项目首页

在github项目下的settings里设置：在GitHub Pages 里选择master branch 点击save按钮

 

 

完成后便可访问 http://<github username>.github.io/<github project name>/

特色：

• master分支即为项目pages，很是合适网站类项目，源码结构与线上网站结构相对应

3.在master的docs目录下

在master分支上docs目录下增长index.html文件做为项目首页

在github项目下的settings里设置：在GitHub Pages 里选择master branch/docs folder 点击save按钮

完成后便可访问 http://<github username>.github.io/<github project name>/

特色：

• 单独使用一个目录与项目自己源码分离，适合但愿文档管理与项目提交同时管理和更新的项目。