環(huán)境配置
前言
Hexo是一個(gè)基于Node.js的靜態(tài)博客程序,可以方便的生成靜態(tài)網(wǎng)頁(yè)托管在github和Heroku上。作者是來自臺(tái)灣的tommy351。-
安裝Node.js
Node.js下載地址
Node.js安裝流程
安裝完成后,執(zhí)行 node --version和npm --version 命令,如果輸出如下圖所示結(jié)果饶碘,就代表安裝成功了。
Paste_Image.png
git的安裝和github賬戶的注冊(cè)和配置我在這里就不在贅敘了馒吴。
使用GitHub Pages建立博客
GitHub賬號(hào)建立好之后扎运,就可以方便的使用它提供的Pages服務(wù)瑟曲,GitHub Pages分兩種,一種是你的GitHub用戶名建立的username.github.io這樣的用戶&組織頁(yè)(站)豪治,另一種是依附項(xiàng)目的pages洞拨。想建立個(gè)人博客用的是第一種,形如cytmxk.github.io這樣的可訪問的站负拟,每個(gè)用戶名下面只能建立一個(gè)烦衣。
-
github上建立倉(cāng)庫(kù)
登錄后系統(tǒng),在github首頁(yè)掩浙,點(diǎn)擊頁(yè)面右下角「New Repository」
Paste_Image.png - 填寫項(xiàng)目信息:
project name:cytmxk.github.io
注:Github Pages的Repository名字是特定的花吟,比如我Github賬號(hào)是cytmxk,那么我Github Pages Repository名字就是cytmxk.github.io厨姚。
點(diǎn)擊「Create Repository」 完成創(chuàng)建衅澈。
安裝和配置Hexo
- 執(zhí)行如下命令安裝hexo
$ npm install -g hexo - 搭建本地博客
$ hexo init blog
上面的命令會(huì)在當(dāng)前目錄下創(chuàng)建一個(gè)blog目錄,用來存放構(gòu)建靜態(tài)網(wǎng)頁(yè)的資源谬墙,目錄結(jié)構(gòu)如下所示:
Paste_Image.png
其中source文件夾就是用來存放MarkDown文件的今布,默認(rèn)會(huì)存放一個(gè)hello-world.md文件。
執(zhí)行如下命令將source中的MarkDown文件生成相應(yīng)的html文件:
$ hexo generate
執(zhí)行上面的命令后拭抬,多了一個(gè)public目錄部默,該目錄就是用來存放生成的html文件,目錄結(jié)構(gòu)如下圖示:
Paste_Image.png
在部署到github上之前造虎,需要將資源庫(kù)cytmxk.github.io配置到_config.yml文件中傅蹂,具體配置如下所示:
deploy:
type: git
repo: git@github.com:cytmxk/cytmxk.github.io.git
branch: master
執(zhí)行如下命令將public文件夾中存放的html文件部署到資源庫(kù)cytmxk.github.io中:
$ hexo deploy
執(zhí)行完上面的命令后會(huì)生成一個(gè).deploy_git的目錄,該目錄實(shí)際上存放的實(shí)一個(gè)git資源庫(kù)算凿,對(duì)應(yīng)的遠(yuǎn)程資源庫(kù)就是_config.yml文件中配置的資源庫(kù)份蝴,目錄結(jié)構(gòu)如下圖所示:
Paste_Image.png
打開瀏覽器輸入https://cytmxk.github.io/
就可以看到自己的博客首頁(yè)了,至此一切好像大功告成了澎媒,但是還有一個(gè)問題沒有解決,就是多臺(tái)電腦之間博客同步的問題波桩。
多臺(tái)電腦之間博客同步
我們通過 hexo deploy會(huì)將public目錄(html文件)自動(dòng)push到遠(yuǎn)程倉(cāng)庫(kù)的master分支戒努。但這個(gè)對(duì)多終端博客同步?jīng)]有任何意義,因?yàn)槲覀兠看蝖exo generate都會(huì)根據(jù)source目錄下的markdown源文件重新生成html文件镐躲,所以解決問題的關(guān)鍵是怎么同步source目錄下的源文件储玫,不僅如此,還有配置文件_config.yml萤皂,依賴包記錄文件package.json撒穷,scanffolds目錄,themes目錄裆熙。
-
首先我們進(jìn)入到博客系統(tǒng)的根目錄端礼,比如blog目錄禽笑,這里邊有個(gè).gitignore文件(如果該文件不存在,自己創(chuàng)建一個(gè))蛤奥,里邊默認(rèn)已經(jīng)把該忽略的目錄文件都寫好了佳镜,里邊內(nèi)容如下:
Paste_Image.png - 然后在blog目錄初始化倉(cāng)庫(kù),切換到source分支凡桥,關(guān)聯(lián)遠(yuǎn)程倉(cāng)庫(kù)蟀伸,并push到遠(yuǎn)程倉(cāng)庫(kù)的source分支:
$ cd blog
$ git init
$ git checkout -b source
$ git add .
$ git commit -m "first commit"
$ git remote add origin git@github.com:cytmxk/cytmxk.github.io.git
$ git push origin source - 操作完成后,在另外一臺(tái)電腦上缅刽,首先按照上面的進(jìn)行環(huán)境配置啊掏,然后創(chuàng)建
注意不要再執(zhí)行:
$ hexo init blog
取而代之的是
$ git clone -b source git@github.com:cytmxk/cytmxk.github.io.git
$ npm install //根據(jù)package.json來下載依賴包
執(zhí)行上面的命令就把遠(yuǎn)程倉(cāng)庫(kù)的source分支克隆下來并且安裝依賴包。接下來我們就可以繼續(xù)寫博客了
$ hexo new "about hexo sync"
$ hexo generate$ hexo deploy
$ git add .$ git commit -m "add blog"
$ git push origin source
這樣就完成了多終端的博客同步衰猛。
遇到的問題
-
執(zhí)行 hexo deploy 報(bào)錯(cuò)迟蜜,如下圖所示:
Paste_Image.png
上面的報(bào)錯(cuò)是由于依賴包hexo-deployer-git沒有安裝,所以執(zhí)行如下命令安裝即可:
$ npm install hexo-deployer-git --save