技術人如何搭建自己的技術博客

上次有人留言說,技術博客是程序員的標配,但據我所知絕大部分技術同學到現在仍然沒有自己的技術博客。原因有很多,有的是懶得寫,有的是怕寫不好,還有的是一直想憋個大招,幻想做到完美再發出來,結果一直胎死腹中。

但其實更多程序員是不知道如何去搭建一個博客,其實如今搭建一個個人技術博客非常簡單,其中最簡單搭建方式莫屬使用 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/

注:點擊下方藍字‘閱讀原文’即可參觀我的博客。最後,歡迎大家留言談談自己和博客的那些事。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章