windows下搭建hexo博客并將其部署到GitCafe終極教程

這兩天看了N多教程后砰左,終于成功建立了個HEXO博客,并且將其托管到了GitCafe上俐巴。

下面是終極教程小白版(因為我就是小白--Q雇簟)

小提示(我走的彎路):

1. 所有標(biāo)點(diǎn)符號都是英文的,所以輸入時請切換到英文狀態(tài)铣揉。

2. 冒號后面一定要有個空格,否則回報錯饶深。

3. 所有文件(不管是以md為后綴的,還是以yml結(jié)尾的)逛拱,都必須轉(zhuǎn)換成UTF-8格式敌厘,可以在notepad++的格式里轉(zhuǎn)換下,否則在本地查看(localhost:4000)中會出現(xiàn)亂碼朽合。

4. 注意tags: [test, 測試]如果使用多個標(biāo)簽俱两,注意逗號和測試之間還有個空格。

5. 最新版Hexo(3.0.0或以上版本)默認(rèn)未安裝hexo-deployer-git插件曹步,即部署(上傳)到gitcafe或github要用的插件宪彩,所以如果不執(zhí)行這個命令,就要報錯讲婚。

6. Git Bash右鍵點(diǎn)擊左上角的圖標(biāo)尿孔,選擇屬性,右側(cè)編輯選項中“快速編輯模式”打勾,這是為了在Git Bash中點(diǎn)擊右鍵就能粘貼活合。

7. 不建議用默認(rèn)hexo主題雏婶,建議在網(wǎng)上找個其他主題,不僅因為好看白指,還因為其他主題往往集成了多說留晚、支持中文簡體等優(yōu)勢,省去了你自己折騰的時間告嘲。

開始


環(huán)境準(zhǔn)備

1.安裝 node.js
??去 Node.js 下載最新版的 Node.js错维,安裝到C盤。
2.安裝Git
??Windous下下載msysgit,我安裝到D盤橄唬。
??
??反正以后重裝系統(tǒng)后赋焕,這兩個程序都要重新安裝。

安裝hexo博客

1.雙擊桌面圖標(biāo)或者從開始菜單轧坎,所有程序宏邮,git,打開Git Bash


gitbash
gitbash

注意:這時右鍵點(diǎn)擊左上角的圖標(biāo)缸血,選擇屬性蜜氨,右側(cè)編輯選項中“快速編輯模式”打勾,這是為了在Git Bash中點(diǎn)擊右鍵就能粘貼捎泻。

該輸入代碼了:

$ npm install -g hexo

這條命令是安裝hexo飒炎,然后

#進(jìn)入D盤
cd d:
# 創(chuàng)建文件夾hexo,為了存放你的博客各種內(nèi)容及設(shè)置
mkdir hexo
# 進(jìn)入hexo文件夾
cd  hexo

這時看到Git Bash標(biāo)題欄的路徑為/D/hexo,如圖:


# 初始化文件hexo
hexo init
# 安裝依賴包
npm install 

注意:安裝hexo-deployer-git插件

npm install hexo-deployer-git --save

然后生成

#生成
hexo g
#啟動服務(wù)預(yù)覽
hexo s

代碼簡寫:
hexo g == hexo generate
hexo s == hexo server

當(dāng)看到“INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.”時就說明我們已經(jīng)搭建起本地的hexo博客了笆豁,然后到瀏覽器輸入localhost:4000看看(注意:不要打開提示的0.0.0.0:4000)郎汪。

enter description here
enter description here

然后按Ctrl+C停止服務(wù)(有時要按兩次Ctrl+C,因為有時Git Bash認(rèn)為當(dāng)前在進(jìn)行復(fù)制操作)闯狱,直到出現(xiàn) “$”標(biāo)志就結(jié)束了煞赢。
然后關(guān)閉Git Bash.

配置gitcafe


注意:以下假設(shè)你的gitcafe賬號或者用戶名是:hello,你的郵箱為:hello@gmail.com哄孤,密碼為hello123


https://gitcafe.com 注冊個賬號照筑,然后創(chuàng)建項目,右上角的那個圖標(biāo)可以新建項目瘦陈,右側(cè)也有“新建”字樣凝危。
反是選填的可以不填,其他默認(rèn)晨逝。

注意:項目名需要與你的用戶名相同蛾默,還有就是要選擇“公開項目”。

gitcaf項目
gitcaf項目

這是別人的圖片捉貌,雖然用戶名不是hello支鸡,但注意要一樣冬念,項目主頁可以不填。

配置SSH公鑰

首先我們需要檢查你電腦上現(xiàn)有的ssh key:

cd ~/.ssh

如果提示:No such file or directory 說明你是第一次使用git牧挣。

生成新的SSH Key:

ssh-keygen -t rsa -C "hello@gmail.com"

Generating public/private rsa key pair.
Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):<回車就好>

出現(xiàn)


sshkeygen
sshkeygen

然后系統(tǒng)會要你輸入密碼:

Enter passphrase (empty for no passphrase):
Enter same passphrase again:

這個設(shè)置是防止別人往你的項目里提交內(nèi)容刘急,我直接回車。

看到入下圖所示后浸踩,SSH key就生成成功了。


sshkeyok
sshkeyok

然后你可以去開始统求,打開你的用戶目錄检碗,有一個“.ssh”文件夾,里面有
“id_rsa” “id_rsa.pub” 和 “known_hosts”這三個文件码邻。

ssh文件
ssh文件

其中“id_rsa”是你的私鑰文件折剃,“id_rsa.pub”是你的公鑰文件,一會兒要用像屋。
接下來下載notepad++ 文本編輯器怕犁,比windows自帶的記事本更強(qiáng)大,這里我們主要用它來打開id_rsa.pub文件己莺。
這是他的官網(wǎng):notepad++官網(wǎng)
下載后奏甫,直接把“id_rsa.pub”文件拖進(jìn)notepad++中,然后復(fù)制里面的所有內(nèi)容到剪貼板凌受。

添加SSH Key到Gitcafe

然后去GitCafe阵子,點(diǎn)擊右上角的那個圖標(biāo),選擇賬戶設(shè)置胜蛉,左側(cè)SSH公鑰管理挠进,添加新的公鑰,在名稱文本框中輸入任意字符誊册,在公鑰文本框粘貼剛才復(fù)制的公鑰字符串全部內(nèi)容(包括結(jié)尾的郵箱)领突,輸入GitCafe賬戶密碼,按保存按鈕完成操作案怯。

enter description here
enter description here

這樣我們本地就和GitCafe服務(wù)端連接上了君旦。

測試是否可以連接GitCafe服務(wù)器

在桌面上雙擊打開Git Bash,輸入:

ssh -T git@gitcafe.com 

如果是第一次連接的話殴泰,會出現(xiàn):

The authenticity of host 'gitcafe.com (50.116.2.223)' can't be established.
#RSA key fingerprint is 84:9e:c9:8e:7f:36:28:08:7e:13:bf:43:12:74:11:4e.
#Are you sure you want to continue connecting (yes/no)?

直接輸入yes回車,然后會提示你輸入 passphrase 口令:

Enter passphrase for key ‘/c/Users/USERNAME/.ssh/id_rsa’: 

剛才我們根本就沒設(shè)置于宙,所以這次也直接回車,當(dāng)看到

Hi starsky! You've successfully authenticated, but GitCafe does not provide shell access.

我們就連接成功了。


enter description here
enter description here

設(shè)置用戶信息

# 設(shè)置你的用戶名
git config --global user.name "hello"  
# 設(shè)置你的郵箱
git config --global user.email "hello@gmail.com"

到此為止悍汛,SSH Key配置成功捞魁,本機(jī)已成功連接到gitcafe.
就差最后一步了,把博客部署到gitcafe.

修改hexo配置文件

在 Hexo 文件夾下找到 _config.yml 文件离咐,并拖到notepad++ 打開谱俭。


enter description here
enter description here

找到其中的 deploy 標(biāo)簽奉件,改成下圖所示,并保存:

deploy:
  type: git
  repository: https://gitcafe.com/hello/hello.git 
  branch: gitcafe-pages

注意:除了 “https://” 中的冒號以外昆著,其他每個冒號后面都有個空格,最后保存县貌。

把hexo博客部署到gitcafe

注意:以下假設(shè)你注冊gitcafe時使用的密碼是hello123

打開我的電腦,進(jìn)入D盤的hexo目錄凑懂,在該目錄內(nèi)右鍵煤痕,選擇Git Bash,打開后看到Git Bash標(biāo)題欄的路徑為/D/hexo.

注意:以后我們很多的博客操作都要在此目錄下運(yùn)行Git Bash才行接谨,比如新建博文摆碉、上傳部署等等。

輸入:

hexo d

運(yùn)行中要輸入你的用戶名:輸入hello脓豪,回車巷帝,然后要輸入密碼,輸入hello123(這時當(dāng)你輸入時扫夜,你會發(fā)現(xiàn)輸入之后密碼是不顯示的楞泼,也不顯示星號,這是為了安全笤闯,并非是你沒輸上)堕阔,回車后顯示Deploy done等等就成功部署上了!如圖:

enter description here
enter description here

每次deploy時不輸入郵箱和密碼

如果覺得每次部署的時候都要輸入用戶名和密碼望侈,可以這樣解決:開始印蔬,到你的用戶目錄下新建一個_netrc文件。
我的操作:可以直接復(fù)制一個.gitconfig文件復(fù)件脱衙,然后改名為_netrc侥猬,注意:n前面有個下劃線。
然后把_netrc文件拖入notepad++ 里捐韩,輸入:

machine gitcafe.com
login hello
password hello123

退唠,這樣每次部署的時候就不用輸入用戶名和密碼了。
來源:
把Hexo同時部署到GitHub和GitCafe
Git push時重復(fù)輸入用戶名密碼的問題

大功告成 :)

這時你就成功把hexo博客部署到了gitcafe上荤胁,快打開 http://hello.gitcafe.io/ 看看吧瞧预!

歡迎訪問我的博客:http://starsky.gitcafe.io/

其他問題

問題集1:

  1. 有網(wǎng)友反應(yīng)右鍵菜單中沒有g(shù)it bash選項,可以進(jìn)入開始菜單找到git bash仅政,然后通過cd進(jìn)入相應(yīng)目錄執(zhí)行命令垢油。
  1. 在github部署完成之后,馬上訪問可能出現(xiàn)404錯誤圆丹,這是正常的滩愁,(最多)等待十分鐘左右就可以訪問了。如果還不行辫封,那很可能是 github 發(fā)送給你的驗證郵件你沒有打開看硝枉,據(jù)多方反映廉丽,驗證后就沒問題了。
  2. 如果在hexo d之后出現(xiàn)fatal: 'username.github.io' does not appear to be a git repository妻味,一是檢查 repo 的名字是否合乎規(guī)范正压、是否含有大寫字母、config.yml 中的 deploy 配置是否正確责球,二是把 git bash 關(guān)掉焦履,重新打開再執(zhí)行命令。
  3. 有的同學(xué)可能不是 IT 界的雏逾,或者對shell 命令不太了解裁良。在要求輸入密碼時,你輸入之后密碼是不顯示的校套,這是為了安全,并非是你沒輸上牧抵。
  4. 出現(xiàn)亂碼的笛匙,不要使用 windows 中的「記事本」打開并編輯文件,推薦使用 sublime text犀变,很簡單妹孙。如果已經(jīng)在「記事本」中編輯過,需要使用 sublime text 轉(zhuǎn)碼為「utf8」获枝。
  5. 安裝 hexo 時卡在那兒不動蠢正,很可能是網(wǎng)絡(luò)不給力,能全局 break wall 就好了省店。
  6. 遇到什么其他的問題嚣崭,不妨刪除.deploy 和db.json 再重新生成試一試。

來源:hexo系列教程:(二)搭建hexo博客

問題集2:

1.安裝NoteJs懦傍,出現(xiàn)問題雹舀,安裝到最后提示error 52**
過程:重新下載安裝了幾次都不行搏讶,不懂為什么逗余,最后通過Hexo的文檔提供下載地址進(jìn)行下載,然后安裝問題就沒有出現(xiàn)了牛郑。 可能原因:
a.下載的安裝包有問題的原因
b.我的C盤占用過多寸认,盤符標(biāo)紅签财,然后卸載一些不常用軟件解決,再安裝再加上上面重新下載的安裝包偏塞,之后安裝成功唱蒸。

2.部署提示找不到git
解決辦法: 在Hexo 3.0版本后deploy git 被分開的,所以需要安裝烛愧,安裝命令如下:npm install hexo-deployer-git --save ,安裝好后在嘗試一下就ok油宜。

3.部署提示 `event type error ***`
解決辦法:
安裝了git bash沒有配置到環(huán)境變量path中掂碱,添加進(jìn)去在試試。

4.部署的時候執(zhí)行:hexo deploy 命令行沒有任何輸出慎冤,也沒有錯誤疼燥。
解決辦法:
在部署的_config.yml文件中,找到deploy:標(biāo)簽蚁堤,在每個冒號后面必須要空格醉者,否則就會出現(xiàn)上述問題。我的配置如下:
deploy:
type: git
repository: https://github.com/wx962464/wx962464.github.io.git
branch: master
順便提示下披诗,如果使用ssh部署不成功的話撬即,請使用https的方式試試,這個就是每次會讓你輸入用戶名和密碼呈队。其實效果是一樣的剥槐。

5.修改主題不起作用,而且hexo generate還報錯
解決辦法:
需要到相應(yīng)的主題文件夾下面進(jìn)行修改宪摧,比如我的主題為:themes\jacman 則在根目錄下找到該文件夾下粒竖,修改_config.yml文件,根目錄下面也有個同樣的名字几于,不注意蕊苗,容易弄混,要主要修改的文件是否正確沿彭。

6.執(zhí)行hexo server顯示running at http://0.0.0.0:4000/
問題說明:
開始的時候以為啟動服務(wù)器有問題朽砰,一直在找問題,找了半天沒有答案喉刘,最后在瀏覽器直接嘗試http://0.0.0.0:4000/ 是沒辦法訪問的瞧柔,然后就試了下http://localhost:4000/ 發(fā)現(xiàn)是可以訪問的,大喜睦裳!~~

7.執(zhí)行hexo server提示找不到該指令
解決辦法:
在Hexo 3.0 后server被單獨(dú)出來了非剃,需要安裝server,安裝的命令如下:npm install hexo-server --save 安裝此server后再試推沸,問題解決备绽。

8.以上就是我在這幾天使用Hexo的一些問題,當(dāng)然問題列的不夠詳細(xì)鬓催,只是一個大致思路肺素,這些也是憑著自己的印象做的筆記,所以有些錯誤的地方希望大家指出宇驾,共同學(xué)習(xí)倍靡,共同進(jìn)步!

來源:Hexo 使用中遇到的問題總結(jié)


參考:

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末课舍,一起剝皮案震驚了整個濱河市塌西,隨后出現(xiàn)的幾起案子他挎,更是在濱河造成了極大的恐慌,老刑警劉巖捡需,帶你破解...
    沈念sama閱讀 207,248評論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件办桨,死亡現(xiàn)場離奇詭異,居然都是意外死亡站辉,警方通過查閱死者的電腦和手機(jī)呢撞,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,681評論 2 381
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來饰剥,“玉大人殊霞,你說我怎么就攤上這事√兀” “怎么了绷蹲?”我有些...
    開封第一講書人閱讀 153,443評論 0 344
  • 文/不壞的土叔 我叫張陵,是天一觀的道長顾孽。 經(jīng)常有香客問我瘸右,道長,這世上最難降的妖魔是什么岩齿? 我笑而不...
    開封第一講書人閱讀 55,475評論 1 279
  • 正文 為了忘掉前任,我火速辦了婚禮苞俘,結(jié)果婚禮上盹沈,老公的妹妹穿的比我還像新娘。我一直安慰自己吃谣,他們只是感情好乞封,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,458評論 5 374
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著岗憋,像睡著了一般肃晚。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上仔戈,一...
    開封第一講書人閱讀 49,185評論 1 284
  • 那天关串,我揣著相機(jī)與錄音,去河邊找鬼监徘。 笑死晋修,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的凰盔。 我是一名探鬼主播墓卦,決...
    沈念sama閱讀 38,451評論 3 401
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼户敬!你這毒婦竟也來了落剪?” 一聲冷哼從身側(cè)響起睁本,我...
    開封第一講書人閱讀 37,112評論 0 261
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎忠怖,沒想到半個月后呢堰,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,609評論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡脑又,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,083評論 2 325
  • 正文 我和宋清朗相戀三年暮胧,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片问麸。...
    茶點(diǎn)故事閱讀 38,163評論 1 334
  • 序言:一個原本活蹦亂跳的男人離奇死亡往衷,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出严卖,到底是詐尸還是另有隱情席舍,我是刑警寧澤,帶...
    沈念sama閱讀 33,803評論 4 323
  • 正文 年R本政府宣布哮笆,位于F島的核電站来颤,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏稠肘。R本人自食惡果不足惜福铅,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,357評論 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望项阴。 院中可真熱鬧滑黔,春花似錦、人聲如沸环揽。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,357評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽歉胶。三九已至汛兜,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間通今,已是汗流浹背粥谬。 一陣腳步聲響...
    開封第一講書人閱讀 31,590評論 1 261
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留辫塌,地道東北人帝嗡。 一個月前我還...
    沈念sama閱讀 45,636評論 2 355
  • 正文 我出身青樓,卻偏偏與公主長得像璃氢,于是被迫代替她去往敵國和親哟玷。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,925評論 2 344

推薦閱讀更多精彩內(nèi)容