經(jīng)過各種找資料,踩過各種坑,終于搭建好了hexo,域名是在萬維網(wǎng)上買的,我的hexo是3.1.1版本,hexo不同的版本,很多配置都不一樣。好吧,廢話不多說了,開始吧。
正文:
hexo是一款基于Node.js的靜態(tài)博客框架,hexo github鏈接,這篇教程是針對(duì)與Mac的,參考鏈接,由于原文講到的hexo是以前的老版本,所以現(xiàn)在的版本配置的時(shí)候會(huì)有些改動(dòng)。
之前是想著寫博客,一方面是給自己做筆記,可以提升自己的寫作、總結(jié)能力,一個(gè)技術(shù)點(diǎn)我們會(huì)使用,并不難,但是要做到讓讓別人也能聽懂我們講得,還是需要一定的技巧和經(jīng)驗(yàn)的。很多類似于CSDN、博客園也都可以寫文章,但是頁面的樣式我,不是太喜歡,簡書還算好點(diǎn)得。最近看到一些大神們的博客,貌似都是用hexo寫得,我也依葫蘆畫瓢的搭建了一個(gè)。不羅嗦了,直接上搭建步驟。
配置環(huán)境
安裝Node(必須)
作用:用來生成靜態(tài)頁面的
到Node.js官網(wǎng)下載相應(yīng)平臺(tái)的最新版本,一路安裝即可。
安裝Git(必須)
作用:把本地的hexo內(nèi)容提交到github上去.
安裝Xcode就自帶有Git,我就不多說了。
申請(qǐng)GitHub(必須)
作用:是用來做博客的遠(yuǎn)程創(chuàng)庫、域名、服務(wù)器之類的,怎么與本地hexo建立連接等下講。
github賬號(hào)我也不再啰嗦了,沒有的話直接申請(qǐng)就行了,跟一般的注冊(cè)賬號(hào)差不多,SSH Keys,看你自己了,可以不配制,不配置的話以后每次對(duì)自己的博客有改動(dòng)提交的時(shí)候就要手動(dòng)輸入賬號(hào)密碼,配置了就不需要了,怎么配置我就不多說了,網(wǎng)上有很多教程。
正式安裝Hexo
Node和Git都安裝好后,首先創(chuàng)建一個(gè)文件夾,如blog,用戶存放hexo的配置文件,然后進(jìn)入blog里安裝Hexo。
執(zhí)行如下命令安裝Hexo:
sudo npm install-g hexo
初始化然后,執(zhí)行init命令初始化hexo,命令:
hexo init
好啦,至此,全部安裝工作已經(jīng)完成!blog就是你的博客根目錄,所有的操作都在里面進(jìn)行。
生成靜態(tài)頁面
hexo generate(hexo g也可以)
本地啟動(dòng)
啟動(dòng)本地服務(wù),進(jìn)行文章預(yù)覽調(diào)試,命令:
hexo server
瀏覽器輸入http://localhost:4000
我不知道你們能不能,反正我不能,因?yàn)槲疫€有環(huán)境沒配置好
配置Github
建立Repository
建立與你用戶名對(duì)應(yīng)的倉庫,倉庫名必須為【your_user_name.github.io】,固定寫法
然后建立關(guān)聯(lián),我的blog在本地/Users/leopard/blog,blog是我之前建的東西也全在這里面,有:
_config.yml? ?? node_modules? ? public? ? ? source
db.json? ? ? ?? package.json? ? scaffolds?? themes
現(xiàn)在我們需要_config.yml文件,來建立關(guān)聯(lián),命令:
vim _config.yml
翻到最下面,改成我這樣子的
deploy:
type: git
repo:https://github.com/leopardpan/leopardpan.github.io.git
branch:master
然后執(zhí)行命令:
npm install hexo-deployer-git--save
網(wǎng)上會(huì)有很多說法,有的type是github, 還有repository最后面的后綴也不一樣,是github.com.git,我也踩了很多坑,我現(xiàn)在的版本是hexo: 3.1.1,執(zhí)行命令hexo -vsersion就出來了,貌似3.0后全部改成我上面這種格式了。
忘了說了,我沒用SSH Keys如果你用了SSH Keys的話直接在github里復(fù)制SSH的就行了,總共就兩種協(xié)議,相信你懂的。
然后,執(zhí)行配置命令:
hexo deploy
然后再瀏覽器中輸入http://leopardpan.github.io/就行了,我的github的賬戶叫l(wèi)eopardpan,把這個(gè)改成你github的賬戶名就行了
部署步驟
每次部署的步驟,可按以下三步來進(jìn)行。
hexo clean
hexo generate
hexo deploy
一些常用命令:
hexo new"postName"#新建文章
hexo new page"pageName"#新建頁面
hexo generate#生成靜態(tài)頁面至public目錄
hexo server#開啟預(yù)覽訪問端口(默認(rèn)端口4000,'ctrl + c'關(guān)閉server)
hexo deploy#將.deploy目錄部署到GitHub
hexo help# 查看幫助
hexo version#查看Hexo的版本
報(bào)錯(cuò)總結(jié)
ERROR Deployer not found: git或者ERROR Deployer not found: github
解決方法:npm install hexo-deployer-git --save
如發(fā)生報(bào)錯(cuò):ERROR Process failed: layout/.DS_Store, 那么進(jìn)入主題里面layout和_partial目錄下,使用刪除命令:
rm-rf.DS_Store
ERROR Plugin load failed: hexo-server
原因:
Besides,utilities are separated into a standalone module.hexo.util is not reachable anymore.
解決方法,執(zhí)行命令:
sudo npm install hexo-server
執(zhí)行命令hexo server,提示:Usage: hexo ....
原因:
我認(rèn)為是沒有生成本地服務(wù)
解決方法,執(zhí)行命令:
npm install hexo-server--save
提示:hexo-server@0.1.2 node_modules/hexo-server
....
表示成功了參考
這個(gè)時(shí)候再執(zhí)行:
hexo-server
得到:
INFOHexois running at http://0.0.0.0:4000/.PressCtrl+C to stop.
這個(gè)時(shí)候再點(diǎn)擊http://0.0.0.0:4000,正常情況下應(yīng)該是最原始的畫面,但是我看到的是:
白板和Cannot GET / 幾個(gè)字
原因:
由于2.6以后就更新了,我們需要手動(dòng)配置些東西,我們需要輸入下面三行命令:
npm install hexo-renderer-ejs--save
npm install hexo-renderer-stylus--save
npm install hexo-renderer-marked--save
這個(gè)時(shí)候再重新生成靜態(tài)文件,命令:
hexo generate(或hexo g)
啟動(dòng)本地服務(wù)器:
hexo server(或hexo s)
再,點(diǎn)擊網(wǎng)址http://0.0.0.0:4000OK終于可以看到屬于你自己的blog啦,??,雖然很簡陋,但好歹有了一個(gè)屬于自己的小窩了。參考鏈接,本地已經(jīng)簡單的設(shè)置好了,但是現(xiàn)在域名和服務(wù)器都是基于自己的電腦,接下來需要跟github進(jìn)行關(guān)聯(lián)。
主題推薦
這里有大量的主題列表使用方法里面
都有詳細(xì)的介紹,我就不多說了。
我這里有幾款個(gè)人認(rèn)為不錯(cuò)的主題,免去你們,一個(gè)一個(gè)的選了,歡迎吐槽我的審美,??
Cover- A chic theme with facebook-like cover photo
Oishi- A white theme based on Landscape plus and Writing.
Sidebar- Another theme based on Light with a simple sidebar
TKL- A responsive design theme for Hexo. 一個(gè)設(shè)計(jì)優(yōu)雅的響應(yīng)式主題
Tinnypp- A clean, simple theme based on Tinny
Writing- A small and simple hexo theme based on Light
Yilia- Responsive and simple style 優(yōu)雅簡潔響應(yīng)式主題,我用得就是這個(gè)。
Pacman voidy- A theme with dynamic tagcloud and dynamic snow
一些基本路徑
文章在source/_posts, 文章支持Markdown語法,可以使用一些MarkDown渲染工具。如果想修改頭像可以直接在主題的_config.yml文件里面修改,友情鏈接,之類的都在這里。開始打理你的博客吧,有什么問題或者建議,都可以提出來,我會(huì)繼續(xù)完善的。
修改頭像
我當(dāng)前的路徑/Users/leopard/blog/themes/yilia,ls 你可以看到
Gruntfile.js? ? _config.yml package.json
README.md?? layout? ? ? source
vim _config.yml 進(jìn)去,找到 #你的頭像url avatar: 后接一個(gè)URL就行了,頭像就修改成功了
修改主題和作者名字
我當(dāng)前的路徑/Users/leopard/blog,ls 你可以看到
_config.yml ?node_modules? ? public? ? ? source? ? ? themes
db.json ? ? ? ?package.json ? ? scaffolds ? ssh-keygen
vim _config.yml 進(jìn)去,找到 author: 潘柏信,修改成你自己的名字就行了
修改主題,然后繼續(xù)往下找到
# Extensions
## Plugins: http://hexo.io/plugins/
## Themes: http://hexo.io/themes/
theme:yilia
改成theme: yilia,theme:后面接你自己的主題名字就行了,然后分別執(zhí)行
部署hexo g
提交hexo d
你的主題,和名字就修改成功了
Markdown語法參考鏈接
轉(zhuǎn)載請(qǐng)注明原地址,潘柏信的博客:http://leopardpan.github.io謝謝!
想修改下文章格式,發(fā)現(xiàn)簡書上只有新發(fā)表的文章才能使用MarkDown語法,大家有什么好的建議沒,求推薦。
文/潘柏信(簡書作者)
原文鏈接:http://www.itdecent.cn/p/465830080ea9
著作權(quán)歸作者所有,轉(zhuǎn)載請(qǐng)聯(lián)系作者獲得授權(quán),并標(biāo)注“簡書作者”。