title: Hexo博客 新手安裝及使用教程
date: 2017-10-07 14:46:55
tags: 教程
這是一篇基于Github搭建Hexo博客的基礎(chǔ)教程，內(nèi)容有：資源下載、安裝步驟、發(fā)布更新文章、更換主題
資源下載
node.js
- node.js ，官網(wǎng)下載地址,下載完成，雙擊打開(kāi)，選擇下一步安裝即可。注：盡量下載最新版本，避免報(bào)錯(cuò)。
Git
- Xcode自帶Git
安裝步驟
更換npm源
Node Package Manager 是node.js的模塊依賴(lài)管理工具，由于國(guó)內(nèi)有墻，使用時(shí)多有不便，國(guó)內(nèi)有很多優(yōu)秀的npm鏡像。例如：
淘寶npm
registry地址：http://registry.npm.taobao.org/
cnpmjs
搜索地址：http://cnpmjs.org/
registry地址：http://r.cnpmjs.org/
配置npm
1 . 臨時(shí)使用
* npm --registry https://registry.npm.taobao.org install express
2 . 持久使用
* npm config set registry https://registry.npm.taobao.org
// 配置后可通過(guò)下面方式來(lái)驗(yàn)證是否成功
* npm config get registry
// 或npm info express
3 . 使用cnpm
* npm install -g cnpm --registry=https://registry.npm.taobao.org
// 使用cnpm install expresstall express
安裝Hexo
1 . 終端執(zhí)行
$ sudo npm install -g hexo
輸入管理員密碼（Mac登錄密碼）即開(kāi)始安裝 (sudo:linux系統(tǒng)管理指令 -g:全局安裝)
2 . 創(chuàng)建博客文件夾
這里可以選擇一個(gè)固定的位置建立一個(gè)文件夾，例如我在‘文檔’下建立一個(gè)‘MyselfBlog’的文件，以后所有操作都在這個(gè)文件下進(jìn)行。
cd 到選擇的目錄，執(zhí)行：
$ hexo init MyselfBlog
cd 到MyselfBlog，安裝npm，執(zhí)行：
$ npm install
開(kāi)啟hexo 服務(wù)器，執(zhí)行：
$ hexo s
瀏覽器中打開(kāi)http://localhost:4000
沒(méi)有問(wèn)題就會(huì)顯示如下頁(yè)面：
如果，頁(yè)面打開(kāi)顯示為空，4000端口被占用，終端執(zhí)行：
$ hexo server -p 5000
如果是其他類(lèi)型的錯(cuò)誤，到官網(wǎng)排查。
關(guān)聯(lián)Git
- 登錄github，新建倉(cāng)庫(kù)，注意命名規(guī)則‘用戶名.github.io’,例如我的倉(cāng)庫(kù)名字就是‘SunShiLong.github.io’。倉(cāng)庫(kù)建立成功如下圖：
- cd 回到‘MyselfBlog’目錄，打開(kāi)_config.yml文件，找到下面這段代碼:
deploy:
type: git
repository: https://github.com/XXX/XXX.github.io.git
branch: master
注意：冒號(hào)后面有一個(gè)空格，把“XXX”換成自己倉(cāng)庫(kù)的名字。
- 生成靜態(tài)頁(yè)面，執(zhí)行：
$ hexo generate 或者：hexo g
// 此時(shí)若出現(xiàn)如下報(bào)錯(cuò)：
ERROR Local hexo not found in ~/blog
ERROR Try runing: 'npm install hexo --save'
// 則執(zhí)行命令：
$ npm install hexo --save
// 若無(wú)報(bào)錯(cuò)，自行忽略此步驟。
- 配置頁(yè)面，執(zhí)行：
$ hexo deploy 或者：hexo d
注意：若執(zhí)行命令hexo deploy報(bào)錯(cuò)：無(wú)法連接git或找不到git，則執(zhí)行如下命令來(lái)安裝hexo-deployer-git：
$ npm install hexo-deployer-git --save
- 輸入git賬號(hào)和密碼
打開(kāi)網(wǎng)頁(yè)地址
瀏覽器打開(kāi)網(wǎng)址http://SunShiLong.github.io
本地打開(kāi)http://localhost:4000 頁(yè)面一致
發(fā)布文章
- cd 到‘MyselfBlog’目錄，新建文章，執(zhí)行
$ hexo new "NewBlog"
- 可以看到新建一個(gè)名為“NewBlog.md”的文件目錄在MyselfBlog/source/_posts下，這里推薦使用markdown編輯博客，Mac端好用的編輯器有Mou和MacDown，但是Mou目前最高支持MacOS10.11，我的電腦系統(tǒng)是10.12，所有只好用MacDown。當(dāng)然喜歡Vim的不受影響啦。
還不錯(cuò)吧，可以邊碼字邊預(yù)覽。
- 文章編輯完成，接下來(lái)就可以發(fā)布了，還是執(zhí)行下面兩句：
$ hexo generate //生成靜態(tài)頁(yè)面
$ hexo deploy //部署到Github
NOW, Hexo博客搭建教程就告一段落了
更換主題
所有基于github建立的hexo博客，默認(rèn)主題都是landscape，可以自定義的，到主題官網(wǎng)選好自己喜歡的主題，例如主題Ada
cd 到‘MyselfBlog‘目錄，執(zhí)行：
$ git clone https://github.com/shuiRong/hexo-theme-Ada.git themes/Ada
// 將MyselfBlog目錄下_config.yml里theme的名稱(chēng)landscape修改為Ada
$ hexo clean //清除緩存文件 (db.json) 和靜態(tài)文件 (public)
$ hexo g //生成緩存和靜態(tài)文件
$ hexo d //重新部署到服務(wù)器
每個(gè)主題都有詳細(xì)的介紹，包括使用方法和內(nèi)容修改，可以替換，名字、標(biāo)題、圖片、網(wǎng)址等。
