[轉]建立GitHub技術博客全攻略

時間 2019-11-14

標籤建立 github 技術博客攻略欄目 Git 简体版

原文原文鏈接

原文連接：http://blog.csdn.net/renfufei/article/details/37725057css

說明: 首先,你須要註冊一個 github 帳號,最好取一個有意義的名字,好比姓名全拼,暱稱全拼,若是被佔用,能夠加上有意義的數字.
本文中假設用戶名爲 tiemaocsdn

1. 註冊帳號:
地址: https://github.com/
輸入帳號、郵箱、密碼,而後點擊註冊按鈕.html

圖1 第1步

2. 初始設置
註冊完成後,選擇Free免費帳號完成設置。git

圖2 第2步

2.1 驗證郵箱
請打開你的郵箱，查看發送給你的確認郵件，你須要驗證郵箱後,後面生成的我的主頁纔會被接受和發佈.

3. 建立頁面倉庫
地址: https://github.com/new
這個倉庫的名字須要和你的帳號對應，如 tiemaocsdn.github.io
輸入基本信息,而後點擊建立倉庫.github

圖3 第3步

4. 進入項目設置頁面
由於這個項目就是專門的放頁面的,因此master分支便可. 若是是你的某個倉庫的頁面,你須要設置到 gh-pages 分支中,關於這些,請參考本文末尾提到的參考資料.瀏覽器

圖4 第4步

5. 進入自動頁面生成器
在設置頁面,下拉到底部, 默認分支(master)不用管.安全

圖5 第5步

6.1 建立用戶頁面(即技術博客站點)
輸入一些內容,能夠本身編輯,也能夠從readme加載：併發

圖6-1 第6-1步

6.2 繼續,選擇主題工具

圖6-2 第6-2步

7. 選擇主題,而後發佈
以下圖所示,其實這些之後你均可以本身修改替換,這只是生成一些css,html,img到你的倉庫裏面.學習

圖7 第7步

8. 查看效果
如今,你能夠訪問本身的GitHub.io 上的主頁了，例如：
http://tiemaocsdn.github.io/
頁面效果以下圖所示:網站

圖8 第8步

9. CNAME綁定域名

到這一步,其實已經很明確了, http://tiemaocsdn.github.io/ 這麼一個域名，就指向了剛剛構建的這個站點/頁面。若是嫌棄這個域名太土了怎麼辦?

其實很好辦，花錢買個喜歡的域名映射過去就行了。在根路徑下建立一個文件, 文件名是大寫的 "CNAME", 注意沒有後綴。由於tiemaocsdn 沒有購買域名，那麼就拿另外一個來講事吧。

相似下面這樣：

https://github.com/renfufei/renfufei.github.io/blob/master/CNAME

裏面的內容，就是訪問此 xxx.github.io 時會重定向到此域名，因此其實這個地址能夠是任意值。可是爲了有意義，咱們能夠定義爲某個固定的域名，例如 :

[plain] view plain copy

blog.cncounter.com

文件的內容只有一行，這樣訪問 http://renfufei.github.io 時瀏覽器就接收到重定向指令,跳轉到CNAME裏面指定的域名去了。

大體的響應頭和狀態碼以下，你也可使用Chrome打開NetWork，勾選上 Preserve Log 保留日誌看一看相關信息：

[plain] view plain copy

Request URL:http://renfufei.github.io/
Request Method:GET
Status Code:301 Moved Permanently
Location:http://blog.cncounter.com/
Server:GitHub.com

這樣就很明白了，訪問此站點時，若是域名不是 blog.cncounter.com ,那麼就會跳轉到 http://blog.cncounter.com/，我的惡意推測,即使你將CNAME文件的內容設置爲 www.baidu.com 也是可行的，這樣訪問的時候直接跳轉到百度了。
可是，若是 http://blog.cncounter.com/ 是空的怎麼辦? 這就須要你本身保證咯。

固然，要是這麼結束掉，那本文就是一篇坑文。
若是你持有這個域名，那麼你能夠將域名的對應記錄也CNAME到 "renfufei.github.io" . 記住， renfufei.github.io 已是一個互聯網上能明肯定位到的地址，因此DNS記錄徹底能夠映射到此路徑.

例如以下的記錄， DNS中，A記錄那就是直接指定一個IP。 CNAME就是重命名，指向另外一個域名。主機記錄就是前綴，例如: blog, 與 cncounter.com 拼接在一塊兒就是 blog.cncounter.com ，若是你想映射 www.cncounter.com，那麼主機記錄就是 www ,記錄類型是CNAME，記錄值是renfufei.github.io；若是想將 http://cncounter.com 這個根域名也映射到，那麼記錄類型也是CNAME,主機記錄就是一個英文的 at: "@". 你能夠將多個域名都映射到 xxxxx.github.io 之類的你本身的站點上，但原則上都會跳轉到你新建的 CNAME文件中的域名上。【放心，不會死循環。。。】.好的，恭喜你!

注意事項:

若是報404，或者其餘錯誤,請稍等,或者檢查你的郵箱，看看構建失敗的提示信息.
好比個人,由於最初沒有驗證郵箱,結果收到了好幾回發佈失敗的通知(以下面的郵件提示)。
之後每次你提交(或在線修改後提交)文件到這個倉庫,GitHub 都會自動爲你構建,併發布。
因此,有問題,請修改並提交某個文件，從新試試吧！

[plain] view plain copy

The page build failed with the following error:
You need a verified email address in your GitHub account to publish Pages.
You can verify your email addresses from your Settings panel:
https://github.com/settings/emails
If you have any questions please contact us at https://github.com/contact.

下面是參考的一部分:

您能夠經過GitHub的頁面自動生成器快速爲項目,用戶(User,好比你的帳號),或組織(Organization, 好比 alibaba) 建立一個網站(其實就是技術博客啦)。

生成用戶/組織的網頁

要生成用戶/組織的網站頁面,你須要建立一個倉庫(repository,代碼庫),名爲: username.github.io 或 orgname.github.io ；用戶名或組織名必須是你本身的帳號/或所屬的組織, 不然GitHub Pages 站點不會幫你生成(build,構建,編譯,)。 GitHub的頁面自動生成器能夠經過倉庫的設置頁面(Settings page)看到。您能夠閱讀更多關於用戶和組織頁面的內容。

警告: GitHub頁面網站在互聯網上是公開,即便其所屬的倉庫是私有的。若是你有敏感數據在頁面倉庫中,您可能須要在發佈以前刪除他們。

參考地址: