之前的博客都是記錄在簡書,偶爾有些零散的文章會往掘金和CSDN發一發,雖然這些平臺寫作體驗還是挺不錯的,不用考慮推廣也有一些流量,但是前段時間簡書整頓了一波,有幾篇文章無辜被鎖,覺得很惱火。
再想想這些寫作平臺頁面千篇一律不夠個性化,還不如自己搭個個人博客,一來不用擔心審查什么的帶來的附帶傷害,也折騰一下沒搞過的東西,給人生增加點樂趣。
個人需求
仔細考慮了下個人的需求,其實比較簡單,就是要逼格一定要高。
所以主題得找自己喜歡的~
所以個人域名一定是要的~
所以一定不能寫完了還要敲幾行命令別人才能看到~
所以評論啊,人數統計啊,字數統計啊,該有的絕對不能少~
當然還得夠快。
現在的各種公眾號 vlog等自媒體形態潮的飛起,相比之下博客顯得有點Old School。不過這帶來的好處就是技術方案基本都比較成熟了,在網上隨便找找,果然成熟的技術就是好,直接有方案可以滿足大部分自己的需求
Hexo 博客終極玩法:云端寫作,自動部署
總結起來就是
- 阿里的語雀平臺進行寫作
- webhook觸發travis-ci 自動構建
- 下載語雀的文章生成md文件
- hexo 生成博客
- github-pages作為頁面托管
搭建工作
之前沒搞過前端的工作,整個環境的搭建還是費了些功夫,不過關于整個搭建工作,按照網上文章step by step的做也就差不多了,這里只記錄下自己的粗心大意的地方,浪費了不少時間
首先是hexo theme的命名
這是一個比較低級的錯誤,不過確實卡了我有半個小時,在下載主題的時候我直接下載的zip解壓,文件夾名字是帶分支的,和_config.yml
中的theme名字不對應,導致生成不了正常的頁面
再就是Travis-CI ssh的問題
- 注意
.travis/ssh_config
中的配置,rsa文件的路徑要正確,因為我配置了多個git倉庫,所以一個也不能漏
Host github.com
User git
StrictHostKeyChecking no
IdentityFile ~/.ssh/id_rsa_ci
IdentitiesOnly yes
Host gitee.com
User git
StrictHostKeyChecking no
IdentityFile ~/.ssh/id_rsa_ci
IdentitiesOnly yes
Host git.dev.tencent.com
User git
StrictHostKeyChecking no
IdentityFile ~/.ssh/id_rsa_ci
IdentitiesOnly yes
yuque-hexo 中語雀token
文檔中說是公開庫可以不用token,但是自己嘗試公開庫依然需要token,且token應在travis-ci中定義環境變量,更安全一些,不過依賴travis-ci進行每次調試很費時間,可以在 package.json
的yuqueConfig
中定義token,見#30
持續優化
博客撘完,導入幾個模板測試一下,一切順利,然而一個愛折騰的程序員怎么能就此滿足呢
這個博客還有幾個問題
- 沒有一個自己的域名,掛在
github.io
下面逼格不夠 - github在國內訪問不太穩定
- 語雀的文章只是生成了靜態頁面push到github上,而且每次都是強制推送沒有歷史記錄,原始的md文件也沒有進行備份
域名申請
因為貧窮,在freenom 上申請了一個免費的域名sunhapper.tk
,綁定到github也很簡單
- 在 freenom 的dns管理中設置一個子域名的CNAME指向
sunhapper.github.io
,我設置的是BLOG
- 在github托管博客的頁面綁定之前注冊的子域名
blog.sunhapper.tk
現在使用訪問blog.sunhapper.tk
就可以定向到sunhapper.github.io
了
網上不少文章說要設置A記錄指向github的ip地址,實際沒有必要,A記錄的設置是在擁有自己的公共IP時將域名和ip進行綁定的,github的ip實際并不是你自己維護的,這樣綁定沒有意義
訪問穩定性提升
dns
綁定完域名,試驗下,個人感覺還行,不過讓其他朋友試試發現還是有些問題

所以訪問性優化第一步就是換dns服務器,申請了dnspod作為dns服務器,因為之前公司的dns用的就是dnspod,而且對這種個人博客也是免費的,切換過程比較順暢,在dnspod設置完將freenom的dns服務器改成自定義的就完了
cdn
因為github在國內的訪問也是不太穩定的,所以考慮使用cdn進行加速,但是最終沒有使用,主要因為
- 國內的cdn全部需要進行域名備案,只是一個個人博客不是很想折騰這個
- 嘗試了cloudflare,雖然不用備案,但是它的免費方案節點應該都是在國外的,加速效果非常一般
基于以上原因,沒有使用cdn,而是使用了國內的git倉庫進行頁面托管
國內git托管
國內的提供pages功能的git倉庫有coding、gitee,之前用gitee比較多,但是gitee要收費版本才有自動發布和自定義域名功能,貧窮讓我使用了coding
往coding推送靜態頁面和github并沒有什么不同
在dnspod上設置下指向coding的CNAME并設置為默認,github.io設置為國外訪問
因為coding的ssl證書站點在國外,所以如果設置為github.io作為國外路線的CNAME則會對開啟https有影響,所以為了https只好忍痛放棄多線路的支持,改成所有訪問都定向到coding
備份
因為同步語雀文章,生成靜態頁面,向托管倉庫部署頁面都是在travis上進行的,這導致博客源碼倉庫不會發生任何變化,而靜態頁面的托管倉庫的推送都是強制的,所以也沒有歷史記錄,這樣讓版本回滾非常困難,而且完全依賴語雀平臺,語雀萬一掛了,博客文章的修改及更新就變得比較困難
所以在travis-ci中執行同步文章操作后會添加一個提交,并推送到github,安全起見,在gitee弄了鏡像倉庫,也備份一下,畢竟前段時間MYZ github也是有一些動作的
這個備份操作還是比較順暢的,畢竟幾個倉庫都配了ssh key,擁有完全的讀寫權限,就是在生成新的commit_message時耽誤了比較久
來看下到底被什么給block了
serverless函數
回過頭看看Hexo 博客終極玩法 中serverless函數這一段,這個函數的功能是將語雀的webhook調用轉換成travis-ci api的形式,其中帶上了被修改的文件名作為message放在body的request字段里
$post_data = json_encode(array(
"request"=> array(
"message"=>$message,
"branch"=>$branch
)
));
按照travis-ci的文檔,這個message應該覆蓋 TRAVIS_COMMIT_MESSAGE
環境變量,但是實際并沒有見https://github.com/travis-ci/travis-ci/issues/8641 ,每次 TRAVIS_COMMIT_MESSAGE
都是最新的提交的message,這樣我想創建一個新的commit它的message是什么就沒有依據了
查了下文檔,Triggering builds with API V3 發現config的env字段可以添加環境變量,所以自己加個環境變量作為commit-message好了
$post_data = json_encode(array(
"request"=> array(
"message"=>$message,
"branch"=>$branch,
"config"=>array(
"env"=>array(
"DESC"=>preg_replace("/\t/","",$message)
)
)
)
));
.travis.yml
.travis.yml
中修改
- NEW_MESSAGE=${DESC:-$TRAVIS_COMMIT_MESSAGE} //有DESC環境變量就用DESC,沒有就用TRAVIS_COMMIT_MESSAGE
- echo ${NEW_MESSAGE}
這里有個問題,travis-ci在取環境變量的字符串時,如果中間有空格,會只取空格前的字符串,這個還沒想到方式解決,只好生成DESC時不加空格了
坑已踩完,每次語雀更新文章都會在git上生成一個包含修改文件的commit了

todo
干了兩天,終于獲得了一個自定義域名,國內外分線路訪問,自動部署的個人博客了,當然有些事情還沒做完,標記下備忘
圖床問題
現在暫時使用的是直接復制到語雀編輯頁面自動生成md圖片地址,但是這個地址只有在生成md時才看的到,在其他地方使用比較麻煩,比如封面等,所以需要考慮其他圖床
圖片備份
看到網上各種博客上裂開的圖片,天生對圖床有種不安全感,所以圖片展示可以用圖床,但是在git倉庫應該也需要一個備份,以便圖床掛了可以及時遷移
一行代碼提取markdown文件中圖片
語雀生成的md文件格式化
語雀生成的md文件中多了很多html標簽,例如段落的換行都是使用 <br>
,這在不同md解析器中效果不同,所以需要格式化成較為標準的格式,方便其他地方發布
使用下面命令進行文本替換
sed -E -i "s/<br \/>/ \n/g" $1 ## 刪除<br \/
sed -E -i "s/<a\sname=\"\w*\"><\/a>//g" $1 ## 刪除標簽
sed -E -i "s/\xc2\xa0/ /g" $1 ## 刪除html空格特殊字符
html特殊字符這個東西還是挺坑的,之前 front-matter 有問題也是因為這個,具體解決方案見
How to deal with NBSPs in a terminal
多平臺發布
每篇文章都是自己的心血,當然想讓更多的人看到,而且使用了travis自動部署,那么除了git托管,其他平臺如果可以自動發布的話支持一下,是不是就可以走上人生巔峰了呢,想想還有些小激動呢~
最后
本博客第一篇文章終于完成了,后續會把其他平臺的文章逐漸遷移過來,也會不斷進行技術博客輸出,敬請關注
一波廣告
致謝
感謝幫助我完成博客搭建所用到的開源工具以及平臺
Hexo
yuque-hexo
hexo-theme-matery
語雀