在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>/
特點:
- 單獨使用一個目錄與項目本身源碼分離,適合希望文檔管理與項目提交同時管理和更新的項目。