設置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>/

特色：

• 單獨使用一個目錄與項目自己源碼分離，適合但願文檔管理與項目提交同時管理和更新的項目。