這兩天看了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
注意:這時右鍵點(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)郎汪。
然后按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)晨逝。
注意:項目名需要與你的用戶名相同蛾默,還有就是要選擇“公開項目”。
這是別人的圖片捉貌,雖然用戶名不是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)
然后系統(tǒng)會要你輸入密碼:
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
這個設(shè)置是防止別人往你的項目里提交內(nèi)容刘急,我直接回車。
看到入下圖所示后浸踩,SSH key就生成成功了。
然后你可以去開始统求,打開你的用戶目錄检碗,有一個“.ssh”文件夾,里面有
“id_rsa” “id_rsa.pub” 和 “known_hosts”這三個文件码邻。
其中“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賬戶密碼,按保存按鈕完成操作案怯。
這樣我們本地就和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.
我們就連接成功了。
設(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++ 打開谱俭。
找到其中的 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等等就成功部署上了!如圖:
每次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:
- 有網(wǎng)友反應(yīng)右鍵菜單中沒有g(shù)it bash選項,可以進(jìn)入開始菜單找到git bash仅政,然后通過cd進(jìn)入相應(yīng)目錄執(zhí)行命令垢油。
- 在github部署完成之后,馬上訪問可能出現(xiàn)404錯誤圆丹,這是正常的滩愁,(最多)等待十分鐘左右就可以訪問了。如果還不行辫封,那很可能是 github 發(fā)送給你的驗證郵件你沒有打開看硝枉,據(jù)多方反映廉丽,驗證后就沒問題了。
- 如果在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í)行命令。
- 有的同學(xué)可能不是 IT 界的雏逾,或者對shell 命令不太了解裁良。在要求輸入密碼時,你輸入之后密碼是不顯示的校套,這是為了安全,并非是你沒輸上牧抵。
- 出現(xiàn)亂碼的笛匙,不要使用 windows 中的「記事本」打開并編輯文件,推薦使用 sublime text犀变,很簡單妹孙。如果已經(jīng)在「記事本」中編輯過,需要使用 sublime text 轉(zhuǎn)碼為「utf8」获枝。
- 安裝 hexo 時卡在那兒不動蠢正,很可能是網(wǎng)絡(luò)不給力,能全局 break wall 就好了省店。
- 遇到什么其他的問題嚣崭,不妨刪除.deploy 和db.json 再重新生成試一試。
問題集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)步!