參考文獻(xiàn):
hexo中文文檔
http://opiece.me/2015/04/09/hexo-guide/
http://blog.csdn.net/jzooo/article/details/46781805
http://blog.csdn.net/xuezhisdc/article/details/53130328
博主環(huán)境:Windows8.1
1. 前置條件—— 安裝Git、Node.js
參考 hexo中文文檔 概述篇,沒什么要補(bǔ)充的。
2. 安裝Hexo
第一步:
前置條件滿足后,即Git伍俘、Node.js安裝完成后,即可使用npm 安裝 Hexo闯团。
(npm是Git下的命令千诬。若出現(xiàn)命令無法執(zhí)行,檢查下環(huán)境變量PATH蚪黑。)
$ npm install -g hexo-cli
安裝完成后的界面如下圖:
第二步:設(shè)置初始環(huán)境
安裝 Hexo 完成后盅惜,請執(zhí)行下列命令,Hexo 將會在指定文件夾中新建所需要的文件忌穿。這個指定的文件夾就是以后的工作目錄抒寂。我將它放在了G:\Hexo 路徑下。
$ hexo init <folder>
$ hexo init G:\Hexo #我將它放在了G:\Hexo 路徑下掠剑。
安裝完成后的界面如下圖:
第三步:安裝依賴
切換到安裝的指定文件夾中屈芜,安裝依賴文件,命令如下:
$ cd <folder>
$ npm install
#這里建議在安裝一些組件朴译,防止后續(xù)的一些問題的出現(xiàn)
npm install hexo-server --save
npm install hexo-admin --save
npm install hexo-generator-archive --save
npm install hexo-generator-feed --save
npm install hexo-generator-search --save
npm install hexo-generator-tag --save
npm install hexo-deployer-git --save
npm install hexo-generator-sitemap --save
$ npm install
這個命令應(yīng)該是用來安裝一些Node.js 模塊井佑。我命令執(zhí)行的結(jié)果如下:
看警告提示,大意是“跳過可選依賴:…………”眠寿,命令應(yīng)該是已經(jīng)執(zhí)行成功了毅糟,這個WARN 警告可以忽視。
此時已經(jīng)安裝完成了澜公。完成后的指定文件夾下的目錄內(nèi)容如下:
用dir
命令查看
文件目錄說明
參見 Hexo中文文檔 建站
_config.yml
網(wǎng)站的配置信息,可以配置大部分的參數(shù)
package.json
應(yīng)用程序的信息喇肋。EJS, Stylus 和 Markdown renderer 已默認(rèn)安裝坟乾,您可以自由移除。
package.json
{
"name": "hexo-site",
"version": "0.0.0",
"private": true,
"hexo": {
"version": ""
},
"dependencies": {
"hexo": "^3.0.0",
"hexo-generator-archive": "^0.1.0",
"hexo-generator-category": "^0.1.0",
"hexo-generator-index": "^0.1.0",
"hexo-generator-tag": "^0.1.0",
"hexo-renderer-ejs": "^0.1.0",
"hexo-renderer-stylus": "^0.2.0",
"hexo-renderer-marked": "^0.2.4",
"hexo-server": "^0.1.2"
}
}
scaffolds
模版 文件夾蝶防。當(dāng)您新建文章時甚侣,Hexo 會根據(jù) scaffold 來建立文件。
Hexo的模板是指在新建的markdown文件中默認(rèn)填充的內(nèi)容间学。例如殷费,如果您修改scaffold/post.md中的Front-matter內(nèi)容印荔,那么每次新建一篇文章時都會包含這個修改。
source
資源文件夾是存放用戶資源的地方详羡。除 _posts 文件夾之外仍律,開頭命名為 _ (下劃線)的文件 / 文件夾和隱藏的文件將會被忽略。Markdown 和 HTML 文件會被解析并放到 public 文件夾实柠,而其他文件會被拷貝過去水泉。
themes
主題 文件夾。Hexo 會根據(jù)主題來生成靜態(tài)頁面窒盐。
本地預(yù)覽Hexo博客
第一次使用hexo草则,在本地創(chuàng)建服務(wù)器使用。
hexo generate # 生成靜態(tài)頁面
hexo s # 開啟本地服務(wù)器
打開瀏覽器蟹漓,輸入URL:localhost:4000(或127.0.0.1:4000)炕横,即可在本地預(yù)覽,如下:
按【CTRL + C】 后葡粒,即可停止本地服務(wù)器:
將hexo博客部署到github上
Github 準(zhǔn)備
首先你要先有一個Github 賬號份殿,可以直接去注冊一個賬號。
注冊完成之后塔鳍,登錄伯铣,創(chuàng)建一個新的存儲倉庫:new repositories
點(diǎn)擊新建倉庫之后,界面如下:
注意:箭頭所指部分填寫倉庫名轮纫,倉庫名格式應(yīng)該為:用戶名.github.io
將hexo部署到Github上
修改配置文件blog/_config.yml腔寡,修改deploy項(xiàng)的內(nèi)容(在文件末尾)。修改方式有兩種掌唾。
第一種:
利用SSH鏈接協(xié)議放前,如下所示:
# Deployment 注釋
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: git@github.com:XavierRoot/XavierRoot.github.io.git
branch: master
第二種:
利用http協(xié)議,如下所示:
# Deployment 注釋
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: https://github.com/XavierRoot/XavierRoot.github.io.git
branch: master
注意:type: git中的冒號后面是有空格的糯彬。
輸入下面的命令將hexo博客部署到github中:
hexo clean # 清空靜態(tài)頁面
hexo generate # 生成靜態(tài)頁面
hexo deploy # 上傳到倉庫
打開網(wǎng)頁凭语,輸入URL:http://Github用戶名.github.io,即可打開博客撩扒。
還有一種部署到Github上的方法似扔,參見:最簡單的Hexo搭建博客教程
大致說下基本思路:就是下載一個Github客戶端,然后Clone下來你剛創(chuàng)建的倉庫搓谆。再將hexo中的public文件夾下的所有東西全部粘貼到你剛剛Clone下來的倉庫中炒辉,通過Github客戶端提交上去,完成部署泉手。
感興趣的朋友可以自行嘗試黔寇。
到這里,基本的安裝就結(jié)束了斩萌,但是hexo還有很多的功能尚未接觸缝裤,也將在接下來使用過程中屏轰,一點(diǎn)點(diǎn)的去學(xué)習(xí),與大家共同進(jìn)步憋飞。