Hexo 完整使用教程

img

官網(wǎng)

官網(wǎng)地址：https://hexo.io/zh-cn/

環(huán)境

1.node

hexo 基于 node技俐，所以首先要安裝node環(huán)境

2.npm

包管理工具

環(huán)境配置請參考本站對應安裝教程

快速開始

安裝 hexo
```
npm install -g hexo-cli
```
初始化 hexo
```
hexo init
```
工程配置
```
npm install
```
瀏覽器調(diào)試
```
hexo g
hexo s
```

主題安裝

下載主題

git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/Butterfly

修改站點配置文件_config.yml,把主題修改為 Butterfly
```
theme: Butterfly
```
為便于后續(xù)平滑升級罪裹，在source目錄下創(chuàng)建_data文件夾,將Themes/Butterfly目錄下的 _config.yml復制一份到source/_data目錄下,并改名為butterfly.yml

執(zhí)行以下指令,以查看應用主題后的效果

hexo clean #清除舊的內(nèi)容
hexo g #生成發(fā)布用的靜態(tài)頁面

錯誤處理

錯誤1：如果第一次操作，可能會報以下的錯誤

C: B1og)hexo g
INFO Start processing
FATAL Something s wrong. Maybe you can find the solution here: https:l /hexo. io/ docs/ troub1 eshooting. htm1
Error: Cannot find module cheeri 0
Require stack :
C: B1 og themes But terflyscripts photo. js
at Functi on. Module._ reso1veF ilename (internal / modul es/cjs/loader. js:797:15)
at Functi on. Module._ load (internal 1 modul es/cjs/ loader. js:690:27)
at Module. require (internal 1 modul es/c js/loader. js:852: 19)
at require (C: B1og node_ modul es hexo)1ib hexolindex. js :280:23)
at Hexo. (anonymous) (C: B1og themes Butterfly scripts photo. js:5: 19)
at Hexo. tryCatcher (C: B1og node_ modul es b1uebirdljs release util. js:16:23)
at Hexo. (anonymous) (C: B1og node_ modul es b1uebirdljs release method. js:15 :34)
at C: B1 og node modul es hexo1ib extendlfilter. js:62:52
at tryCatcher (C: B1og node_ modul es b1uebirdljs release util. js:16:23)
at 0bject. gotValue (C: )B1og node_ modul es bluebird,js release reduce. js: 166:18)
at 0bject. gotAccum (C: B1og node_ modul es b1uebird,js release reduce. js: 155:25 )
at 0bject. tryCatcher (C: B1 og node_ modul es bluebirdljs releaseutil. js: 16:23)
at Promise. sett1 ePromi seF romHandler (C: B1og node_ modul es b1uebirdjs rel ease promi se. js:547:31)
at Promise. settlePromise (C: B1og node_ modul es bluebirdljs release promise. js :604: 18)
at Promise. settlePromi se0 (C: B1og node_ modul es bluebird,js rel ease promise. js :649: 10)
at Promise. settlePromises (C: B1og node_ modul es b1uebirdljs release promi se. js:729:18)
at_ drainQueueStep (C: B1 og node_ modul es b1uebirdkjs release async. js:93:12)
at drainQueue (C: B1og node_ modul es b1uebird,js release lasync. js:86:9)
at Async._ drainQueues (C: )B1 og node_ modul es bluebirdljs re1 ease lasync. js: 102:5)
at Immedi ate. Async. drainQueues [as onI mmediate] (C: B1og node_ modul es b1uebirdlisrelease)async. js:15:14)
at processImmediate (internal/ timers. js: 439:21)

解決方案

npm install cheerio@0.22.0 --save
hexo g
hexo s

錯誤2：如果你沒有 pug 以及 stylus 的渲染器會報錯

extends includes/layout.pug block content include ./includes/mixins/post-ui
.pug #recent-posts.recent-posts +postUI include includes/pagination.pug

解決方案

npm install hexo-renderer-pug hexo-renderer-stylus --save
npm install hexo-deployer-git --save / yarn add hexo-deployer-git

再次依次執(zhí)行
```
hexo clean
hexo g
hexo s
```

完整博客

超逸の博客 - 主題魔改+完整開源
- 【源碼開放】Hexo+Github 博客butterfly 和 matery 主題搭建完全教程【整理】 | 超逸の博客
小弋の生活館 - 主題魔改
洪衛(wèi)の博客
- 博客配置+網(wǎng)站優(yōu)化：https://sunhwee.com/posts/6e8839eb.html

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者