上次有人留言說,技術部落格是程式設計師的標配,但據我所知絕大部分技術同學到現在仍然沒有自己的技術部落格。原因有很多,有的是懶的寫,有的是怕寫不好,還有的是一直想憋個大招,幻想做到完美再發出來,結果一直胎死腹中。但其實更多程式設計師是不知道如何去搭建一個部落格,其實如今搭建一個個人技術部落格非常簡單,其中最簡單搭建方式莫屬使用 GitHub Pages + Jekyll 了,我的部落格就是使用這種技術。
GitHub Pages
Github Pages 是面向使用者、組織和專案開放的公共靜態頁面搭建託管服務,站點可以被免費託管在 Github 上,你可以選擇使用 Github Pages 預設提供的域名 github.io 或者自定義域名來發布站點。Github Pages 支援 自動利用 Jekyll 生成站點,也同樣支援純 HTML 文件,將你的 Jekyll 站點託管在 Github Pages 上是一個不錯的選擇。
使用 Github Pages 搭建部落格有以下幾個優點:
- 完全免費,其中伺服器、流量、域名什麼的都需要管,完全零費用搭建一個技術部落格
- 寫部落格就是提交程式碼,讓寫作和程式設計的體驗保持一致
- 支援繫結自己的域名
- 提供流行的網頁主題模板
缺點也是有的:
- 不支援動態內容,部落格必須都是靜態網頁,一般會使用 Jekyll 來構建內容。
- 部落格不能被百度索引,因 Github 和百度有過節,所以 Github 就把百度給遮蔽了。
- 倉庫空間不大於1G
- 每個月的流量不超過100G
- 每小時更新不超過 10 次
Github Pages 使用 Jekyll 來構建內容,那麼 Jekyll 是什麼呢?
Jekyll 介紹
Jekyll 是一個簡單的部落格形態的靜態站點生產機器。它有一個模版目錄,其中包含原始文字格式的文件,通過一個轉換器(如 Markdown)和我們的 Liquid 渲染器轉化成一個完整的可釋出的靜態網站,你可以釋出在任何你喜愛的伺服器上。Jekyll 也可以執行在 GitHub Page 上,也就是說,你可以使用 GitHub 的服務來搭建你的專案頁面、部落格或者網站,而且是完全免費的。
但如果我們只是在 GitHub 上面使用的話,到不需要知道 Jekyll 的語法,一般 Github 會自動將我們寫的 Markdown 檔案轉換成靜態頁面。使用 Jekyll 需要使用 Markdown 語法來寫你的文章,不過 Markdown 語法非常簡單,做為程式設計師來講基本上兩三天就掌握了,大家也可以參考這篇文章:markdown 使用總結。
給大家分享一些 Jekyll 主題,這個網站下有很多 http://jekyllthemes.org/ 主題,大家可以根據自己的愛好去選擇部落格主題。
我的個人部落格
我的部落格經過了三個階段,第一個階段,完全依託於使用 GitHub Pages 來構建;第二個階段,將部落格託管於國外的一個服務商;第三個階段,伺服器遷移回到國內、域名備案。之前也寫過幾篇關於技術部落格的文章,如下:
使用 Github Pages + Jekyll 構建一個技術部落格很簡單,基本上步驟就是網上找一個自己喜歡的主題,直接 Fork 到自己的 Github ,然後在刪掉原部落格中的內容,在上傳自己的文章即可,以我自己的部落格為例。
我的部落格最初使用的是Yummy-Jekyll,但這個主題已經盡兩年多都沒有更新了。因此後期我在這個主題的基礎上做了一些改動,其中有依賴元件的更新,結合個人情況對個別頁面進行了改版,就成為了現在的樣子:
使用這個主題的原因是,我比較喜歡簡潔大氣的風格,並且此部落格主題對程式碼展示支援良好。
快速構建一個部落格
以我的部落格為例,介紹如何最快搭建一個部落格。這也是我部落格經歷的第一個階段。
1、首先開啟地址https://github.com/ityouknow/ityouknow.github.io,點選 Fork 按鈕將程式碼複製一份到自己的倉庫。
過上一分鐘,你的 github 倉庫發現一個 ityouknow.github.io 專案。
2、刪除 CNAME 檔案
刪除專案中的 CNAME 檔案,CNAME 是定製域名的時候使用的內容,如果不使用定製域名會存在衝突。
3、設定 GitHub Pages
點選 Settings 按鈕開啟設定頁面,頁面往下拉到 GitHub Pages 相關設定,在 Source 下面的核取方塊中選擇 master branch ,然後點選旁邊的 Save 按鈕儲存設定。
4、重新命名專案
點選 Settings 按鈕開啟設定頁面,重新命名專案名稱為:github_username.github.io。
github_username 是你的 github 登入使用者名稱
5、重新命名之後,再次回到 Settings > GitHub Pages 頁面
會發現存在這樣一個地址: https://github_username.github.io
這個時候,你訪問此地址已經可以看到部落格的首頁,但是點選文章的時連結跳轉地址不對,這是因為少配置了一個檔案。
6、配置 _config.yml
開啟專案目錄下的 _config.yml 檔案,修改以下配置:
repository: github_username/github_username.github.io
github_url: https://github.com/github_username
url: https://github_username.github.io
這時候在訪問地址: https://github_username.github.io
,就會發現部落格就已經構建完成了。剩下的事情就是去專案的 _posts 目錄下刪除掉我的文章,然後按照 Jekyll 的語法就寫自己的文章就好了。
github_username 為你的 github id。
自定義域名
雖然通過地址https://github_username.github.io
可以正常訪問部落格,但是技術小夥伴們肯定有人想使用自己的域名訪問部落格,這樣的需求 GitHub Pages 也是支援的。
首先需要設定域名解析,將域名的地址指向自己的 github 部落格地址。這裡以萬網的域名配置為例,選擇需要設定的域名點選解析,在域名解析頁面新增以下兩條記錄
空框內,需要填寫自己
github_username
值。
然後重新開啟專案的 Settings > GitHub Pages 頁面,Custom domain 下的輸入框輸入剛才設定的域名:xxx.com,點選儲存即可。
重新配置 _config.yml
開啟專案目錄下的 _config.yml 檔案,修改以下配置:
url: http://www.xxx.com
等待一分鐘之後,瀏覽器訪問地址:www.xxx.com
即可訪問部落格。
自定義 DIY 部落格
一般同學到上面這一步也就完成了,基本滿足了 80% 技術同學的需求。但還是有一些同學們有更高的追求,比如說使用 Github Pages 雖然簡單方便,但是不能被百度檢索白白流失了大量的流量,還有一個原因有些時候,部落格網路訪問穩定性不是很高。
當時我在國外有幾個虛擬機器,本來用作它用,後來在上面安裝了一個 Nginx 作為靜態頁面的伺服器。首先我在本機(win10)安裝了 Jekyll 環境,將 Github 上的部落格程式碼下載下來之後,在本機編譯成靜態的 Html ,然後手動上傳到服務的 Nginx 目錄下;然後將域名指向虛擬機器。
非常不建議大家實踐以上這段內容,win10 上面安裝 Jekyll 環境是一段慘痛的經歷。
就這樣很麻煩的步驟我用了幾個月後,實在是受不了了,一方面因為伺服器在國外,有時候仍然不穩定(可能因為伺服器安裝了代理),另一方面我需要使用一些功能,使用這些功能的前提是網站需要備案,那段時間騰訊雲在做活動,就把部落格又從國外搬了回來,順便重新優化了一下流程。
仍然把部落格託管在 Github 上面,每次提交完程式碼後,在騰訊雲上面執行一個指令碼,這個指令碼會自動從 Github 拉取最新更新的檔案,並自動生產靜態的 Html 檔案推送到 Nginx 目錄,域名重新指向這臺伺服器。可以在 Github 上面設定一些鉤子,當提交程式碼的時候自動觸發指令碼,也可以定時觸發指令碼來發布文章。
指令碼內容如下:
cd /usr/local/ityouknow.github.io
git pull http://github.com/ityouknow/ityouknow.github.io.git
jekyll build --destination=/usr/share/nginx/html
執行此指令碼的前提是安裝好 git\jekyll 環境,這個網上有很多案例,這裡就不再多描述了。
關於 Jekyll 環境搭建和使用可以參考這裡:https://jekyllcn.com/docs/home/
最後,大家可以在這篇文章下留下你的個人部落格地址,方便同行們觀賞、交流、學習。