Githubpage+HEXO : 折騰了2年的建站歷程

這篇文章前面講了很多我建博客的心路歷程酌媒，想要看簡單教程可以拉到最后。

時間線

2016年開始，萌發(fā)自己建立一個博客的想法茶没。

2017年初肌幽，學(xué)習(xí)python，據(jù)說最簡單的編程語言礁叔，花了3個月牍颈，證明自己是小白。結(jié)業(yè)作業(yè)覺得自己實(shí)現(xiàn)不了個人博客的目標(biāo)琅关，就GitHub上找了個爬蟲程序了事煮岁。學(xué)完之后工作帶娃很忙，沒有時間和精力涣易，就暫時作罷画机。

2018年2月春節(jié)假期，重新啟動這個計劃新症。本來想要花1周的時間搞定步氏，熬夜也可以，但是花了一周之后徒爹，并沒有很好地運(yùn)氣荚醒。就像重新回到初學(xué)Python的時候，會被貌似簡單的事情卡住隆嗅，我想我可以給自己再多一點(diǎn)時間界阁。我生日的時候做好，送給自己吧胖喳。我的生日是9月泡躯。

2018年生日正逢中秋節(jié)假期，為了一個小問題熬到3點(diǎn)丽焊，blog還是沒有建好较剃。但我好像對一些終端命令更熟悉了，效率提升了技健，建立博客的思路也縷清了写穴，即使沒弄好，也是有了信心雌贱。

2018年10月份國慶節(jié)假期确垫，我又給自己更多時間折騰，終于階段性成功帽芽，hexo博客成功關(guān)聯(lián)到了GitHubpage删掀。

博客和寫作

我的計劃是，先建立好博客导街，然后再開始寫作計劃披泪。但是建立博客的歷程，比我想象得漫長搬瑰。工作和帶娃款票，學(xué)習(xí)變成很奢侈的事情控硼。

學(xué)Python和自己獨(dú)立建博客兩個階段，都是困難重重艾少，挫折感爆棚卡乾。對于我來說，任何困難缚够，都是困難幔妨。任何困難，可能都是欠缺基礎(chǔ)功谍椅，把我困住误堡。

Python導(dǎo)師大媽曰過：

一個簡單的日常動作，要被迫點(diǎn)亮多少新技能雏吭∷“

開智同學(xué)ZX說：

搭博客對懂編程的群友只是小事，對沒有任何編程基礎(chǔ)的群友就emmm…真的可能掉幾天坑也沒折騰出來杖们，臉上掛滿了挫敗和懷疑悉抵；就算折騰出來可能也花了很多時間，還不知道為啥突然就搞成功摘完±咽危……分享作為小白當(dāng)時的心路歷程... 完全不知道 git 、命令行是何物描焰，第一天在 git+命令行卡了很久媳否，不知道原來本地的命令行和遠(yuǎn)程倉庫是互通的栅螟，本地命令行可以連接荆秦、操作遠(yuǎn)程倉庫；照葫蘆畫瓢瞎弄力图，折騰到半夜兩三點(diǎn)步绸，終于搭成功了。吃媒。不知道為什么就成功了說的就是我 ??

我的寫作計劃瓤介，要通過我個人博客來實(shí)現(xiàn)，但是博客一再被耽擱赘那，我心情變得很糟糕刑桑。感覺自己的人生大事都被這件事情卡住了。

我的心態(tài)也很不好募舟，我只想僥幸可以順利通過祠斧，命令報錯的時候，我不是很有耐心差錯拱礁，查到自己不知道的概念琢锋，也會很無力辕漂。學(xué)海何洋洋，我不是游泳吴超，是在溺水钉嘹。

但是后來我冷靜下來了，因?yàn)槲野l(fā)現(xiàn)鲸阻，對我而言跋涣，對我來說建博客就是為了建博客，和寫博客是2件事情赘娄。博客不是為了寫作仆潮，博客是為了博客，是為了了解Cyber世界遣臼，這個世界的邏輯和語言性置，冷靜的交流方式。

所以我的困難揍堰，對我來說鹏浅，是補(bǔ)基礎(chǔ)功的過程。為了維護(hù)我的內(nèi)心的秩序屏歹，保持我的自我效能隐砸，我的重點(diǎn)，不在是是否僥幸讓博客成功搭建蝙眶。而是是否季希，我理解了Cyber世界的語言、規(guī)則和秩序幽纷。

博客選擇困難

為什么建立博客已經(jīng)不需要再糾結(jié)了式塌。除了以上我自己寫的寫作的理由，知名博主劉未鵬在這篇博文《為什么你應(yīng)該（從現(xiàn)在開始就）寫博客》中已經(jīng)把你想過的沒想過的都提煉出來了友浸。需要糾結(jié)的是做什么博客以及怎么弄峰尝。說是選擇困難，其實(shí)是因?yàn)楹芏鄸|西都不懂收恢。

博客方式

知名播主阮一峰提到博客有三階段：

第一階段：選擇一個免費(fèi)空間

例子：新浪博客武学，CSDN博客
比喻：租一個房子，在里面住伦意，但是地不是自己的火窒，也不能自己選擇有哪些房間和設(shè)備

第二階段：自己購買域名和空間，搭建獨(dú)立博客

原因：免費(fèi)空間限制太多
比喻：自己買地驮肉，自己造房子熏矿，自己搞硬裝，因?yàn)樘哿耍攒浹b一般都很丑吧

第三階段：保留控制權(quán)曲掰，讓別人來管疾捍，自己只負(fù)責(zé)寫

原因：獨(dú)立博客管理太麻煩
比喻：自己買了地，但是用別人的樣板間栏妖，硬裝就直接用別人的方案

第一個階段經(jīng)歷過乱豆，大學(xué)的時候用新浪博客寫博客，寫了好幾年吊趾。后來發(fā)現(xiàn)宛裕，我想把博客導(dǎo)出來的時候，很麻煩论泛，得一篇一篇復(fù)制出來揩尸。那幾年的時光記錄，花了好長時間去這樣整理屁奏。必經(jīng)不是自己的地方岩榆，太不方便了。所以現(xiàn)在坟瓢，我很不喜歡在各大平臺上寫作勇边，顧忌是，如果有一天我想整理這些內(nèi)容折联，會很麻煩粒褒。

第二個階段沒有經(jīng)歷過，很簡單诚镰，沒有這個能力奕坟。

所以現(xiàn)在在嘗試的就是第三個階段。

博客類型：靜態(tài)網(wǎng)頁 VS 動態(tài)網(wǎng)頁

靜態(tài)網(wǎng)頁：每個網(wǎng)頁都是獨(dú)立文件清笨，沒有數(shù)據(jù)庫支持
動態(tài)網(wǎng)頁：①以數(shù)據(jù)庫技術(shù)作為基礎(chǔ)月杉，可實(shí)現(xiàn)更多功能；②根據(jù)用戶的要求相應(yīng)地響應(yīng)和改變

這個結(jié)論很簡單：選擇靜態(tài)網(wǎng)頁博客函筋。原因是：

博客不需要太多交互沙合，我只想安靜得做圖文奠伪，甚至是純文博客跌帐。
靜態(tài)更穩(wěn)定，也更輕绊率。
更重要的是谨敛，動態(tài)網(wǎng)頁更復(fù)雜，我應(yīng)該搞不來滤否，從最簡單的開始脸狸。

博客框架：Jekyll vs hexo vs Pelican

其實(shí)博客階段選擇，以及靜態(tài)動態(tài)選擇，都是默認(rèn)選項(xiàng)炊甲。真正困難的是選擇什么服務(wù)泥彤，我看了很多人家的經(jīng)驗(yàn)貼。因?yàn)槲页晒β室幌蚝艿颓浞龋幌翊笈Ｒ髁撸梢越ㄍ赀@個，覺得不順心再換一個颈娜，所以折騰成本相對較高剑逃。在選擇的時候，也盡量慎重官辽，害怕自己因?yàn)橐粫r無知給自己后面留無法填補(bǔ)的坑蛹磺。

我看了主流的一些選項(xiàng)，發(fā)現(xiàn)主要PK是Jelyll和Hexo同仆。這兩個博客服務(wù)的攻略貼很多萤捆。大媽還提出Python選項(xiàng)的pelican。

jelyll

jelyll比較硬核俗批，陽老師推薦這個鳖轰。并且是GitHub默認(rèn)支持的選項(xiàng)。

之所以用Jekyll扶镀，是希望專注于寫作而非版式蕴侣、圖片等〕艟酰——陽志平

缺點(diǎn)是：

擴(kuò)展性不太好

用Jekyll管理博客昆雀，單純寫文章很便捷，但是它的擴(kuò)展性蝠筑，靈活性和對配置的支持都相對局限狞膘，這是我轉(zhuǎn)向Hexo最重要的原因。棄Jekyll投Hexo

對非程序員不太友好

jekyll用的liquid語法確實(shí)不是對程序員友好的什乙，用起來很痛苦挽封。不過jekyll功能比hexo強(qiáng)大很多，有時間折騰的可以選它臣镣。 wordpress-jekyll-octopress-hexo四博客引擎比較

提交到 GitHub 上生成的靜態(tài)頁速度很慢把 Blog 從 Jekyll 遷移到 Hexo

Hexo

選擇Hexo的比較多辅愿，開智的同學(xué)大多數(shù)選擇了Hexo，比如浚宇 & 廣鶴忆某。

Pelican

大媽推薦了 Pelican点待，并對hexo做了點(diǎn)評。

Hexo 是 nodejs 的作品 , 本身除了豐富的動態(tài)效果, 對于靜態(tài) blog 系統(tǒng)本身的功能并沒有多少創(chuàng)新,在理解了靜態(tài)網(wǎng)絡(luò)發(fā)布的流程后,使用 python 開發(fā)的同類系統(tǒng), 還能自主加以改進(jìn),可能是更加嗯哼的選擇...俺推薦 Pelican ;-)

查了資料弃舒，了解了一下Pelican的優(yōu)點(diǎn)癞埠。

今天我終于用用Python開發(fā)的Pelican靜態(tài)博客系統(tǒng)和Github Pages替代了原來的WordPress博客状原，站點(diǎn)變得清爽和輕量級多了，靜態(tài)站點(diǎn)了訪問速度非趁缱伲快颠区，重要的是: 徹底告別臃腫的WordPress管理后臺，文章可以直接用markdown格式在Sublime Txt里寫通铲，提交到Github用版本庫管理起來瓦呼，正式發(fā)布則只需要敲一行fab命令——Felinx Lee:博客復(fù)活

結(jié)論:

選Hexo：有全職工作沖刺KPI的老母親，經(jīng)不起折騰
不排除通過哪個庫成功测暗，所以最后選哪個的可能性

實(shí)際操作的時候央串，這3個都嘗試過，但是初次嘗試都不太成功碗啄。主要是很多概念不太清楚质和。包括Git，GitHubpage如何關(guān)聯(lián)之類的稚字。后來主要選擇了Hexo作為主攻對象饲宿。

時空迷路癥狀

出現(xiàn)癥狀：安裝好jekyll后，推到Gitpage上失敗了胆描。

現(xiàn)在查看log瘫想，猜測當(dāng)時失敗的原因是：在安裝jekyll之前：①已經(jīng)在GitHub上建好倉庫，好像還把這個倉庫clone到了本地; ②安裝過Pelican昌讲，關(guān)聯(lián)了GitHub的倉庫

Where do you want to create your new web site? [.] https://yiiina.github.io
> Done. Your new project is available at /Users/Yina/Desktop/blog/https:/yiiina.github.io

安裝jekyll自動建立了一個文件夾/Users/Yina/blog国夜，這個文件夾和GitHub倉庫clone到本地的文件夾/Users/Yina/Desktop/blog/https:/yiiina.github.io不是同一個文件，所以沖突了短绸。

當(dāng)時不知道為什么车吹，當(dāng)時對各種空間概念很模糊，所以即使出錯也不知道錯在哪里醋闭，所以復(fù)習(xí)了一下Git的教程窄驹。并梳理出博客空間地圖。

一定要很有空間概念证逻，知道文件數(shù)據(jù)是如何在不同位置傳遞的

博客時空地圖.png

起點(diǎn)：你想成為一個創(chuàng)作者乐埠，于是在本地開始進(jìn)行創(chuàng)作，本地會有一個文件夾
終點(diǎn): 你想讓大家看到你的作品囚企，所以要將本地作品發(fā)布到網(wǎng)頁端

本地文件夾 →【創(chuàng)建本地服務(wù) → 遠(yuǎn)程托管】（版本管理） → 發(fā)布

1. 本地：從起點(diǎn)「文件夾」開始

這個很好理解丈咐，就是日常使用的放文件的文件夾。

然后你需要進(jìn)行高效的版本管理洞拨，所以使用了Git扯罐，Git是很厲害的版本管理理念负拟，超級靈活的時空穿梭機(jī)烦衣。

2. 大腦時空穿梭：本地工作區(qū) → 暫緩區(qū) → 倉庫（版本庫）

空間這塊，有幾個重要的概念：

本地工作區(qū)
暫緩區(qū)
倉庫（或者叫做版本庫）

版本庫，就是你可以準(zhǔn)備提供的服務(wù)了花吟，這里面有了不同時間點(diǎn)秸歧，你曾經(jīng)提交過的版本，可以自由穿梭衅澈。

在這之前的暫緩區(qū)键菱，是你新做好了一些工作，但是還不確定今布，所以先待定经备，或者改動比較小，無所謂作為一個版本部默。

在暫緩區(qū)之前的本地工作區(qū)侵蒙，就是你的草稿紙，資料室傅蹂，工作臺了纷闺。

工作區(qū)就是可以看到的本地文件夾的文件，暫緩區(qū)和版本庫份蝴，其實(shí)是肉眼不可見的犁功，沒有GUI(圖形交互界面)，所以會很難理解婚夫。

3. 本地訪問：4000

4. 遠(yuǎn)程訪問：服務(wù)器浸卦、空間和域名

給用戶提供服務(wù)，需要通過服務(wù)器案糙。不然很多人訪問你的個人PC,不是要崩潰镐躲？你如果不聯(lián)網(wǎng)，別人就無法訪問了侍筛。

開發(fā)完成后萤皂，只能在本地工作，別人電腦訪問不到匣椰，希望讓別人也看到裆熙，就需要部署。

部署：開發(fā)的產(chǎn)品在某一環(huán)境中運(yùn)營起來禽笑。

所以你需要把自己的博客入录，提交給網(wǎng)絡(luò)主機(jī)，他們裝有服務(wù)器佳镜，可以讓更多人僚稿，隨時隨地訪問你的博客內(nèi)容。

域名：讓別人找到你的名字蟀伸。
空間：你購買的服務(wù)器提供的服務(wù)蚀同。

用戶可以通過域名缅刽，調(diào)取你在服務(wù)器中的數(shù)據(jù)，訪問你的博客內(nèi)容蠢络。

服務(wù)器是衰猛，管理資源并為用戶提供服務(wù)的計算機(jī)軟件
服務(wù)器包括：文件服務(wù)器、數(shù)據(jù)庫服務(wù)器刹孔、應(yīng)用程序服務(wù)器
運(yùn)營以上軟件的計算機(jī)啡省，稱為網(wǎng)絡(luò)主機(jī)（Host）
最大的特點(diǎn)：運(yùn)算能力非常強(qiáng)大，短時間完成所有運(yùn)算工作
作為硬件：計算能力高髓霞，給多個用戶使用的計算機(jī)卦睹。
PC 給一個用戶服務(wù)，服務(wù)器可以給多個用戶使用方库，主機(jī)通過終端給用戶使用分预，服務(wù)器通過網(wǎng)絡(luò)給客戶端用戶使用。
服務(wù)器的構(gòu)成與一般的PC比較相似薪捍，但是服務(wù)器在穩(wěn)定性笼痹、安全性、性能等方面都要求更高酪穿，因?yàn)镃PU凳干、芯片組、內(nèi)存被济、磁盤系統(tǒng)救赐、網(wǎng)絡(luò)等硬件和普通PC有所不同。

域名解析就是域名到IP地址的轉(zhuǎn)換過程只磷。域名的解析工作由DNS服務(wù)器完成经磅。

DNS （Domain Name System）根據(jù)域名查出IP地址，你可以把它想象成一本巨大的電話本钮追。

5. Git & GitHub & Githubpage

git
Git進(jìn)行版本控制预厌，軟件源代碼托管服務(wù)
分享學(xué)習(xí)，協(xié)同合作

github
你可以在GitHub上保管項(xiàng)目元媚，也可以分享項(xiàng)目轧叽，學(xué)習(xí)別人的項(xiàng)目
github提供的用于為用戶，用戶博客刊棕，項(xiàng)目甚至整本書提供的靜態(tài)網(wǎng)頁托管服務(wù)
GitHub還提供一個網(wǎng)頁托管服務(wù)炭晒，相當(dāng)于提供免費(fèi)的服務(wù)器，域名和空間甥角，讓你的博客內(nèi)容讓其他人看到

Githubpage:

a static site hosting service
designed to host your personal,organization,or project pages
directly from github repository

6. 用戶訪問：Web

現(xiàn)在用戶可以訪問你博客上的內(nèi)容啦网严。

習(xí)慣養(yǎng)成：像看說明書一樣看文檔

遇到問題，去看文檔嗤无，一開始我也是拒絕的震束×梗總是抱著僥幸的心理，說不定哪個博客的神奇操作就解決了問題驴一，路就走通了呢休雌。然而運(yùn)氣總會用完灶壶，文檔是你可靠的朋友肝断，不會給你虛假的希望〕哿荩看文檔需要：耐心胸懈、看大段英文的勇氣，看多了看英文也就不怵了恰响。

在我建博客過程中趣钱，遇到了3個大坎，都通過官方文檔胚宦，解決了問題首有。

配置有問題，導(dǎo)致HEXO安裝遇到問題枢劝，硬頭皮磕源文檔井联，成功解決
后來不太懂SSH是什么，也好像掉進(jìn)了一個坑里您旁，后來通過官方文檔解決
hexo和GitHub關(guān)聯(lián)遇到問題烙常，看了很多博客，后來也是在官方文檔找到了解決方案

安裝HEXO, 生成本地的服務(wù)

最一開始鹤盒，按照一般的教程配置HEXO環(huán)境有問題蚕脏，導(dǎo)致無法成功安裝HEXO。安裝就遇到問題侦锯，這是新手小白很痛苦的體驗(yàn)驼鞭。后來完全跟著文檔走，解決了問題尺碰。

安裝node.js终议，包含環(huán)境變量和npm

npm安裝HEXO,沒有成功,報錯信息關(guān)鍵詞：errno -13、access

$ npm install -g hexo-cli

看HEXO文檔提示,安裝Xcode和命令行工具

Mac 用戶:您在編譯時可能會遇到問題葱蝗，請先到 App Store 安裝 Xcode穴张，Xcode 完成后，啟動并進(jìn)入 Preferences -> Download -> Command Line Tools -> Install 安裝命令行工具两曼。

重新安裝HEXO皂甘，還是沒有成功

$ npm install -g hexo-cli

看錯信息關(guān)鍵詞，沒有搞明白問題在哪里悼凑，也沒有看文檔偿枕。在別人博客看到在安裝命令之前加了sudo璧瞬，就成功了，就也想有這種運(yùn)氣渐夸，好像裝好了嗤锉。

$ sudo npm install -g hexo-cli

但初始化的時候，結(jié)果還是沒有成功墓塌，卡住了瘟忱，有npm WARN，回避不了NMP的問題

$ hexo init myblog

Google搜到問題討論ISSUE,順藤摸瓜苫幢，找到NMP的文檔How to Prevent Permissions Errors
官方提供2種方法

用版本管理器重置NPM(推薦)——nvm
手動改NPM的默認(rèn)目錄

方法2是人家博客里SUDO做的事情访诱，但是我不太懂目錄，之前這么操作也沒有成功韩肝。
方法1是官方推薦触菜，就老實(shí)照做了，并且像看說明書一樣看文檔哀峻，一步一步去排查問題和操作

安裝nvm

$ curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.11/install.sh | bash

新開一個終端涡相，驗(yàn)證nvm是否安裝成功

$ command -v nvm

nvm安裝npm

$ nvm install node

安裝HEXO

$ npm install -g hexo-cli

用HEXO新建一個網(wǎng)站 → 生成靜態(tài)文件 → 啟動服務(wù)器,成功了，可以在本地服務(wù)器看到頁面了剩蟀，打開有點(diǎn)小小激動呢催蝗，這是一個第一個里程碑哦。

$ hexo init blog
$ hexo g
...
INFO  28 files generated in 362 ms
$ hexo s
INFO  Start processing
INFO  Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.

image.png

HEXO和GitHub關(guān)聯(lián)

建站之后喻旷，一直卡在HEXO和Githubpage的關(guān)聯(lián)上生逸。

時空地圖

開始之前，我先想搞清楚一個問題且预。

A 先從GitHubpage clone到本地槽袄，在本地重新建一個HEXO？
B 還是先本地建一個HEXO,再關(guān)聯(lián)到Githubpage的倉庫锋谐？

這個本質(zhì)上是我對Git和GitHub的時空感還不太好遍尺。

實(shí)踐過程中，又發(fā)現(xiàn)并解決了2個關(guān)鍵的問題：

SSH
HEXO部署到GIT

實(shí)踐A：的過程中遇到SSH的問題

通過實(shí)踐再理解一下Git和Github時空地圖過程中涮拗，在本地建了一個blog文件夾乾戏，然后想把遠(yuǎn)程的clone下來, 再進(jìn)行HEXO建站。

$ Git init
$ Git clone Git@git@github.com:yiiina/yiiina.github.io.git

但是失敗了三热，原因是 Permission denied (publickey)

谷歌搜索到GitHub的官方幫助鼓择，列出很多可能的原因，其中有一個是是否有在用的key就漾。

之前已經(jīng)在SSH上昏過一次呐能，我以為解決了，但是還是出現(xiàn)了問題。

第一個命令之前看到過摆出，但是有反饋朗徊，我以為我有，就沒有再去弄偎漫。

$ eval "$(ssh-agent -s)"
Agent pid 26950

但是看到下面這句話爷恳，試了一下確實(shí)沒有。

The ssh-add command should print out a long string of numbers and letters.
If it does not print anything, you will need to generate a new SSH key and associate it with GitHub.

$ ssh-add -l
The agent has no identities.
$ ssh-add

所以要新建KEY

$ ssh-keygen -t rsa -b 4096 -C "n****@gmail.com"

再試一下,現(xiàn)在確實(shí)有一串?dāng)?shù)字和文字出來了象踊。

$ eval "$(ssh-agent -s)"
Agent pid 26996
$ ssh-add -l
The agent has no identities.
$ ssh-add
Identity added: /Users/Yina/.ssh/id_rsa (/Users/Yina/.ssh/id_rsa)
$ ssh-add -l
4096 ....:Nf7t......JA /Users/Yina/.ssh/id_rsa (RSA)

SSH建好了温亲，把這個秘鑰打開，輸入到github的設(shè)置里通危。這個步驟有參考《GitHub入門與實(shí)踐》P29
很直觀铸豁。

yina:blog Yina$ cat ~/.ssh/id_rsa.pub
ssh-rsa AAA.......w== niceyina@gmail.com

這次再試一下灌曙，就OK了菊碟。

yina:blog Yina$ git clone git@github.com:yiiina/yiiina.github.io.git

從github克隆到本地的倉庫，HEXO無法初始化在刺，必須要在空文件夾, 路徑A證明失敗

not empty, please run hexo init on an empty folder and then copy your files into it

實(shí)踐B：漏掉HEXO部署到GIT的步驟

現(xiàn)在就是路徑B了。其實(shí)路徑B的方法，就是本地生成HEXO的時候毛好，修改注冊表信息负间。

之前看開智極簡教程，漏了一個步驟：把HEXO部署到GIT颖杏。

整個過程一直無知覺的狀態(tài)纯陨。后來搜一個不太直接相關(guān)的問題，在一個博客里發(fā)現(xiàn)了這個步驟留储，再去文檔查到了這個翼抠。

$ npm install hexo-deployer-git --save

說這個包已經(jīng)不再維護(hù)了，按照提示获讳，輸入修復(fù)命令,OK了

$ npm audit fix

此時再進(jìn)行部署

$ hexo d

這時候LOCAL host和網(wǎng)頁端的就一樣了阴颖。