一個博客的誕生

之前的博客都是記錄在簡書,偶爾有些零散的文章會往掘金和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.jsonyuqueConfig中定義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

綁定完域名,試驗下,個人感覺還行,不過讓其他朋友試試發現還是有些問題

image.png
image.png

所以訪問性優化第一步就是換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了

image.png
image.png

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托管,其他平臺如果可以自動發布的話支持一下,是不是就可以走上人生巔峰了呢,想想還有些小激動呢~

最后

本博客第一篇文章終于完成了,后續會把其他平臺的文章逐漸遷移過來,也會不斷進行技術博客輸出,敬請關注

一波廣告

sunhapper的博客
sunhapper的github

致謝

感謝幫助我完成博客搭建所用到的開源工具以及平臺
Hexo
yuque-hexo
hexo-theme-matery
語雀

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,460評論 6 538
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,067評論 3 423
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事?!?“怎么了?”我有些...
    開封第一講書人閱讀 177,467評論 0 382
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,468評論 1 316
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,184評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,582評論 1 325
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,616評論 3 444
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,794評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,343評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,096評論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,291評論 1 371
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,863評論 5 362
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,513評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,941評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,190評論 1 291
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,026評論 3 396
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,253評論 2 375

推薦閱讀更多精彩內容