版權聲明:本文原創發佈於公衆號 wingjay,轉載請務必註明出處! https://www.jianshu.com/p/99665608d295
對程序員而言,最好的簡歷就是個人博客和GitHub
零、個人博客
每個優秀的程序員都會有個人獨佔的一方網絡空間,那裏是他個人的舞臺,聽說過他的人會逐漸匯聚進來,認識他,熟悉他,鼓勵他,讚揚他。而對他個人而言,他有了一個可以暢所欲言的小房間,他可以專研學術,聊聊情懷。同時和喜愛他的讀者成爲好友,共同成長。
這難道不是一件很cool的事情嗎?
一、先看成果
教方法前先來看看最終的效果吧。http://wingjay.com是本人搭建的個人博客,可作爲模版參照,主要特性有以下幾點:
1. 個人域名: wingjay.com
2. 無需購置服務器,本站同時掛載在Github Pages 和 GitCafe Pages上,免服務器費的同時還能做負載均衡,想想還有點小激動
3. 在GitHub上同時管理你的博客和相應代碼,再也不用擔心博客遺失
4. SSL支持,即"http://" -> "https://",更安全也更高大上
二、再看兵器
- 博客框架:Hexo 3,這是一款能快速、簡潔且高效的博客框架,支持Markdown編輯,自動渲染出漂亮的靜態頁面。
- 前端主題:Next,效果參考http://wingjay.com
- 域名購買:類似萬網的平臺都可以,你可以選購自己名字的域名,一年幾十元左右,兩杯咖啡的錢。
- SSL:CloudFlare
三、抄起傢伙
本文寫作方式是安裝流程主線
+ 優質參考文章
。由於網絡上關於Hexo搭建博客的教程玲琅滿目,若讀者完全自己動手則要一篇篇找,浪費時間走彎路;相反,若作者悉數摘抄進來,反倒未必符合各人情況,且不利閱讀。
所以,主線
講解思路,參考
深入閱讀。
下文以搭建 http://wingjay.com 個人博客爲例。
1. GitHub Pages
在不購買服務器的前提下,我們的網站需要掛在GitHub Pages上。
- 你需要擁有一個GitHub賬號,去完成新手任務吧。
- 進入GitHub Pages,一步步做,完成後就能在瀏覽器打開http://wingjay.github.io了。
至此,我們已經利用GitHub Pages搭建好了個人博客雛形了。下面要做的,就是個性化了。
2. 安裝Hexo博客框架
經過上面步驟,我們已經擁有了一個初步域名:http://username.github.io 加一個免費網絡空間了。好比房間有了,但還沒有任何傢俱。所以下面我們需要把空白的博客豐富起來。
放心,不需要你手寫一大堆html、css文件,也不用找jQuery來實現酷炫的頁面效果。Hexo是一款博客框架,它會幫我們搭建。
i. 安裝Hexo
參考中文文檔或英文文檔。完成該步後,你的電腦便擁有了Git、Node.js和Hexo。
ii. GitHub管理
爲了讓自己未來的博客和代碼處在git管理之下,我們要把剛剛在Github上博客項目拉到本地。如本人創建的https://github.com/wingjay/wingjay.github.io,在本地創建文件夾,名字任意,此處設爲myblog
,進入該文件夾,把項目代碼clone下來。
git clone https://github.com/wingjay/wingjay.github.io
好了,此時會自動在myblog
目錄下創建子文件夾wingjay.github.io
,那裏就是我們博客的代碼,以後的操作都在git的管理之下了,此時默認的branch爲master
。
iii. 初始化Hexo
請參考文檔。init命令中的<folder>
就是文件夾wingjay.github.io
。初始化後,wingjay.github.io
裏面就已經有完整的Hexo框架了。
iv. 熟悉Hexo
爲了讓讀者快速瞭解Hexo
,我作幾個簡單介紹吧。當然,更多的還是需要仔細閱讀文檔才能瞭解更詳細。
-
_config.yml
是整體的配置文件,很多基礎配置、插件配置等都需要在裏面進行。要注意的是,該文件格式要求極爲嚴格,缺少一個空格都會導致運行錯誤。小提示:不要用Tab縮進,用兩個空格符。 -
layout
,包括draft(草稿)、page(頁面)、post(文章)
。這個就是三種文件的基本格式,其中post
是你發表的文章,會顯示在你的網站裏,一篇post會包括title標題、date日期、tags標籤
等信息;draft
是草稿,只有你在本地能看到,必須要publish
後才能成爲post
,draft和post差別是date,因爲draft沒有發表,所以不需要指定日期。page
是一個頁面,對應一個新的html頁面,比如博客內容展示頁是一個頁面,留言本也是一個頁面。 -
public文件夾
,這個文件夾是最終會發布到網站上的真實內容。怎麼理解呢?我們可以把public
文件夾當作是真正的被用戶看到的,而其他的source、themes
等都是爲public
服務的。Hexo裏有一個很重要的指令hexo generate
,這個指令就是利用所有代碼裏的配置信息、source裏寫的文章、themes裏的樣式,共同生成最終的靜態html文件
,存入public
文件夾內。在我們執行了發佈指令hexo deploy
後,就會把public
的內容部署到GitHub Pages
上。當用戶在訪問我們的博客時,他們會看到public裏生成的html文件。這個概念非常重要,即代碼和真實靜態頁面是獨立的
。 -
generate和deploy
,generate
會把我們的配置、文章和主題結合起來生成一堆酷炫的html靜態文件放在public裏面。但此時用戶還看不到本地public文件
裏的頁面,我們必須用後一個指令deploy
才能把靜態文件部署到GitHub Pages
上。不過,在部署前,需要配置讓它自動部署到我們前面創建的Github項目中。 -
deploy
相關配置。爲了能夠讓項目自動把public文件夾的內容部署到GitHub項目中,我們可以按部署文檔進行配置,其中選擇的branch
爲master
。此後,每次運行deploy後,項目就會自動把public文件夾內容全部覆蓋到當前的GitHub項目master分支上。 -
代碼
和靜態文件
分開管理。根據上面知道,每次部署後,public文件內容會覆蓋
掉項目整個master分支。這樣可以實現網站靜態文件
的版本控制,但是,仔細對比這個master分支,我們會發現裏面只剩下靜態文件了,我們的代碼比如source、themes統統沒有了,這就導致無法對代碼進行版本管理了。這意味着我換一臺電腦,我就再也找不到代碼
了,只剩下一堆之前編譯出來的靜態文件。所以,爲了對代碼也進行版本控制,我們創建一個新的分支:code,然後在這個分支裏進行代碼控制,master裏則保存部署的新的靜態文件。大家可以自行比對這兩個branch的內容差異。
v. 配置Hexo
做一些基礎配置即可,請參考配置文檔
vi. 小結
到這裏,我們已經完成了hexo的配置,我們可以分別管理代碼和靜態文件。執行deploy操作後,刷新你的網頁 http://username.github.io 你就能看到默認的內容了。
但此時還是默認主題,不夠美觀,所以下一步要配置Next主題。
3. 配置主題Next
Hexo主題非常多,可以參考豐富多彩的Hexo主題,本文選Next爲主題,樣式參考我的博客。
進入配置階段,最好的文檔還是官方文檔,簡單得不能再細緻了。下面只提幾點注意:
- 第三方評論系統。評論系統很重要,你可以與讀者進行更多交流,配置也簡單,建議採用DISQUS,更國際化一點,配置見此。另外,前期建議開啓
不登陸評論
,即在Disqus的Comment Rule
裏允許Guest comment
。 - 創建留言板。熟悉
page
的創建與使用,參考這裏 - 給自己博客做
SEO
。有好的SEO便於搜索引擎索引你的網站,隨着以後讀者增多,他們可以更好搜索到你的網站。具體方法見此
4. 替換自己的域名
好了,經過上面的步驟,博客已經擁有了一個全新的主題啦。
下面,我們要對域名 http://wingjay.github.io 下手啦。
i. 購買域名
速速前往萬網或相關域名購買網站,按自己名字挑選一個閃閃發光的個人域名吧!
ii. 域名解析_1
以購買的域名wingjay.com
爲例,我們希望在訪問這個域名時能自動進入Github Pages,所以我們要在萬網建立一個CNAME紀錄來幫我們做一個域名跳轉:wingjay.com
-> wingjay.github.io
,www.wingjay.com
-> wingjay.github.io
。添加方法參考這裏,添加後可以看到兩條記錄:
然後萬網會在世界各地的DNS服務器上添加這兩條記錄,當用戶訪問
wingjay.com
時會自動去訪問wingjay.github.io
。
iii. 域名解析_2
但是,此時並不能成功訪問,因爲Github Pages是有限制的,它不允許任意域名都跳轉過來,而是只限制一個域名,而且這個域名必須聲明在CNAME文件中
。
所以,我們需要添加一個CNAME文件到項目的master中才行,參考這裏。讀者可以參考本人的CNAME文件內容。
不過,對於Hexo 3
,這裏有一個坑要注意:大家應該還記得上文說的,master分支裏的內容都是自動生成的,而且會完全覆蓋之前的內容。如果我們直接創建一個新文件CNAME,填好域名。但會發現在下一次部署後這個文件就消失了。不用驚訝,因爲hexo並不會自動生成CNAME文件,所以在部署時被覆蓋刪除了。
所以,我們就需要這個CNAME工具hexo-generator-cname,這時會自動在public裏生成一個CNAME文件,把你的域名加進去再部署一下吧!
5. HTTP -> HTTPS
HTTPS是安全版的HTTP協議,它在http協議與TCP之間加入SSL層,採用端口443,不僅會對傳輸數據加密,還會進行身份驗證。當然個人博客並沒有強制性要求採用該協議,這也只是本人的好奇而爲。
目前Github Pages已經支持https了,但是不支持自定義證書。不過我們可以利用CloudFlare來實現。具體實現可以參考這裏。
說明:po主網站的https正處在申請中
四、總結
經過上面的步驟,我們已經能夠通過訪問自己的域名進入自己酷炫的博客了。本文的任務也就告一段落。
除了上面的功能,本人還完成了支持雙域名同時登陸
,其中,支持雙域名的解決思路是考慮到Github Pages的CNAME紀錄只允許添加一個域名,所以本人又在Gitcafe上部署了一套。不過考慮到這點大家不一定能用的上,就沒有做介紹,有需要的話可以看下文的聯繫方式聯繫我。
五、一天變cool系列文章
如何在一天之內完成一款具備cool屬性的Android產品<簡詩>
如何在一天之內搭建以你自己名字爲域名且具備cool屬性的個人博客
謝謝!
wingjay