免費網站實作 – Git Page

什麼是GitHub頁面？

GitHub Pages 是github提供的一種靜態網站託管服務，旨在直接從GitHub存儲庫託管您的個人、組織或專案頁面。

而GitHub Pages是一個靜態站點託管服務，不支持服務器端代碼，如PHP，Ruby或Python。
所以呢！最適合建置的就是拿來做形象網站、電子書、部落格等提供資訊的網站

要了解有關不同類型的GitHub頁面站點的更多信息，請參閱官方網站說明。

Get started today 

1. 創建一個index.md在docs資料夾中（docs資料夾必須在根目錄之下，同時確保是在master 分支）
2. 寫點東西吧～

1. 到專案的設定分頁
2. 選擇好來源位置為/docs
3. 按下 “save”

GitHub Pages將讀取/ docs目錄的內容，將index.md轉換為HTML，並在GitHub Pages URL上發布結果。

這將生成最基本的HTML輸出，您可以使用模板，CSS和Jekyll中提供的其他功能進一步自定義。 因此直接將index.md換成index.html也是可以的，當然js和css也是可以使用的。

要查看所有可能的示例，請查看GitHub頁面展示。

除錯

以上是官方提供的教學然後這邊我有遇到一些問題

1. 1. 1. 為什麼不使用根目錄，而要另外開一個資料夾？
         這邊我有試過使用跟根目錄，其實是可以一樣的成功的！但是，當你專案太大時，會出現timeout而失敗，至於原因的話，主要是GitHub Pages是先clone你的專案才去生成頁面，所以使用根目錄時會導致使用整包去處理，所以太大時才會出錯。
      2. 為什麼出現404？
         主要是GitHub Pages是先clone你的專案才去生成頁面，所以需要等一段時間。

    

   reference: https://blog.github.com/2016-08-22-publish-your-project-documentation-with-github-pages/

   ---

   ---