經(jīng)過(guò)一天的辛苦作戰(zhàn),總算基礎(chǔ)的東西出來(lái)了。踩了太多的坑澈圈,綜合我踩坑的經(jīng)過(guò)彬檀,明白到,選好一篇引導(dǎo)文很重要瞬女!有些步驟不要先做了窍帝,不然后面你都不知道怎么死的..
引
很多博客都已經(jīng)詳細(xì)講述了Hexo博客框架的好處和怎么做,下面的推薦文章里會(huì)給出鏈接诽偷。但有些過(guò)于復(fù)雜坤学,讓初次配置的人有點(diǎn)雨里霧里;有些又太簡(jiǎn)單报慕,出了問(wèn)題就會(huì)不知道怎么回事深浮。下面是自己的搭建記錄,及所遇問(wèn)題的解決眠冈。
在此感謝小馬哥Mark和 wingjay先前分享的教程飞苇,有些地方是從你們里借鑒來(lái)的,希望博主見(jiàn)諒蜗顽,如有侵權(quán)布卡,請(qǐng)聯(lián)系我刪除。
Ok雇盖,現(xiàn)在開(kāi)始:
GitHub Pages
在不購(gòu)買服務(wù)器的前提下忿等,我們的網(wǎng)站需要掛在GitHub Pages上。GitHub Pages是面向用戶崔挖、組織和項(xiàng)目開(kāi)放的公共靜態(tài)頁(yè)面搭建托管服務(wù)贸街,可用于搭建個(gè)人博客。
- 首先你需要擁有一個(gè)GitHub賬號(hào)虚汛。
- 然后進(jìn)入GitHub Pages匾浪,一步步做,完成后就能在瀏覽器打開(kāi)
http://username.github.io
了卷哩。
至此蛋辈,我們已經(jīng)利用GitHub Pages搭建好了個(gè)人博客雛形了。下面要做的将谊,就是個(gè)性化了冷溶。
注意:如果你
http://username.github.io
首頁(yè)就要是博客首頁(yè)的話,建議初次配置選擇首頁(yè)尊浓,就是這樣逞频。完成后可以把index.html
給刪了,因?yàn)榈阶詈竽惆l(fā)現(xiàn)那是沒(méi)用的栋齿,它將會(huì)給你造成干擾苗胀。
前期準(zhǔn)備
安裝Hexo
參考中文文檔或英文文檔襟诸。完成該步后,你的電腦便擁有了Git基协、Node.js和Hexo歌亲。
測(cè)試安裝狀態(tài)
$ node -v
v4.2.4
$ npm -v
2.14.12
$ hexo -v
正式開(kāi)始
確定擁有了Git、Node.js和Hexo后澜驮,進(jìn)行下一步:
建站
安裝 Hexo 完成后陷揪,請(qǐng)執(zhí)行下列命令,Hexo 將會(huì)在指定文件夾中新建所需要的文件杂穷。
$ hexo init <folder>
$ cd <folder>
$ npm install
新建完成后悍缠,指定文件夾的目錄如下:
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes
這樣Hexo會(huì)在該文件夾創(chuàng)建本地博客所需的一切資源。這樣本地博客就搭建好了耐量,輸入以下命令:
hexo s --debug // 啟動(dòng)本地hexo 服務(wù)器飞蚓,默認(rèn)localhost:4000可以訪問(wèn),可以看到調(diào)試信息
這樣就開(kāi)啟了一個(gè)本地博客服務(wù)器廊蜒,打開(kāi)瀏覽器玷坠,在地址欄輸入localhost:4000
,就可以查看本地博客了劲藐,hexo默認(rèn)生成了一片hello world博客。出現(xiàn)問(wèn)題可以看terminal終端錯(cuò)誤信息樟凄。按control + c
關(guān)閉調(diào)試聘芜。
注意:以上hexo開(kāi)頭的命令,執(zhí)行目錄必須是你創(chuàng)建的博客文件夾目錄缝龄。使用hexo s 也可以汰现,只是沒(méi)有了調(diào)試信息。
同步Hexo博客到Github
現(xiàn)在你已經(jīng)可以在本機(jī)查看你的博客了叔壤,但是要想讓別人通過(guò)網(wǎng)絡(luò)可以查看你的博客瞎饲,還需要一步,那就是將你的博客發(fā)布到github倉(cāng)庫(kù)炼绘。在terminal終端嗅战,將當(dāng)前目錄切換到你的本地博客目錄,執(zhí)行以下命令:
npm install hexo-deployer-git --save
安裝完成之后俺亮,打開(kāi)本地博客目錄的_config.yml
文件驮捍,編輯其中的deploy
節(jié)點(diǎn):
deploy:
type: git
repo: https://github.com/youlookwhat/youlookwhat.github.io.git
branch: master
注意:字段前需加空格,hexo有嚴(yán)格的格式規(guī)范脚曾。
保存配置之后东且,你可以不著急傳到倉(cāng)庫(kù),先刷新本地博客本讥,看是否還是原樣珊泳,如有問(wèn)題可以看到terminal終端上的錯(cuò)誤信息鲁冯,然后檢查沒(méi)問(wèn)題為止。
確認(rèn)無(wú)誤之后色查,在本地博客目錄執(zhí)行以下命令:
hexo clean // clean本地項(xiàng)目薯演,防止緩存
hexo g // 全拼是:hexo generate,可以簡(jiǎn)寫成 hexo g; 根據(jù)你編輯的md格式的博客综慎,生成靜態(tài)網(wǎng)頁(yè)
hexo d // 全拼是:hexo deploy涣仿,可以簡(jiǎn)寫成 hexo d; 將本地博客發(fā)布到github
然后,在瀏覽器地址欄輸入username.github.io
就可以訪問(wèn)你的博客了示惊,別人也可以通過(guò)這個(gè)地址訪問(wèn)你的博客好港。如果錯(cuò)誤請(qǐng)重復(fù)看以前流程,或參考其他文章米罚,也可以聯(lián)系我.
NexT主題配置
Hexo主題非常多钧汹,可以參考豐富多彩的Hexo主題,本文選Next為主題录择,NexT主題是一套簡(jiǎn)約的主題拔莱,設(shè)置完成之后,就像我的博客現(xiàn)在的樣子隘竭,里面有詳細(xì)的配置說(shuō)明塘秦,這里就不重述了。
配置后調(diào)試:
hexo clean
hexo g
hexo s --debug
確認(rèn)無(wú)誤后上傳:
hexo clean
hexo g
hexo d
注意:因?yàn)閔exo有嚴(yán)格的格式規(guī)范动看,所以建議配置時(shí)及時(shí)調(diào)試頁(yè)面尊剔。
優(yōu)化環(huán)節(jié)
- 域名設(shè)置
- fork me on github
- 配置SSH key
- 給博文添加tag和分類(主題)
- 手動(dòng)實(shí)現(xiàn)某條博文置頂
域名設(shè)置
大家可以看:替換自己的域名 ,里面講述的詳細(xì)。
注意:在萬(wàn)網(wǎng)買了域名以后直接在里面配置菱皆,這里只是參考用的须误。
其它四條
大家可以看:其他遺漏的點(diǎn)
注意:配置后進(jìn)入調(diào)試模式測(cè)試一下,這樣錯(cuò)了就可以馬上更正仇轻。
常用命令
cd 到倉(cāng)庫(kù)所在文件夾目錄下:
hexo init //在指定目錄執(zhí)行該命令京痢,會(huì)將當(dāng)前目錄初始化為hexo站點(diǎn),生成hexo站點(diǎn)所需的一切文件
hexo new “my new blog title” //新建一篇文章篷店。如果沒(méi)有設(shè)置 layout 的話祭椰,默認(rèn)使用 _config.yml 中的 default_layout 參數(shù)代替。如果標(biāo)題包含空格的話船庇,請(qǐng)使用引號(hào)括起來(lái)吭产。
hexo s --debug // 啟動(dòng)本地hexo 服務(wù)器,默認(rèn)localhost:4000可以訪問(wèn)
hexo clean // 清除緩存鸭轮,如果對(duì)本地文件做了修改臣淤,同步到遠(yuǎn)程驗(yàn)證修改的效果之前,先clean窃爷,清除緩存
hexo generate // 可以簡(jiǎn)寫成hexo g 根據(jù)markdown文件生成靜態(tài)文件
hexo deploy // 或者簡(jiǎn)寫成hexo d 將本地修改邑蒋,部署到遠(yuǎn)端
hexo version // 顯示hexo版本
推薦文章
- Mac搭建Hexo博客及NexT主題配置優(yōu)化
- 如何在一天之內(nèi)搭建以你自己名字為域名又具備cool屬性的個(gè)人博客
- 使用GitHub和Hexo搭建免費(fèi)靜態(tài)Blog
- 動(dòng)動(dòng)手指姓蜂,NexT主題與Hexo更搭哦(基礎(chǔ)篇)
所遇問(wèn)題
- 按照步驟來(lái),及時(shí)調(diào)試医吊,確認(rèn)無(wú)誤后再執(zhí)行下一步钱慢。有一句話說(shuō)的好,步子跨大了容易扯著蛋卿堂。
- 建議將基礎(chǔ)的先搭建出來(lái)束莫,主題細(xì)節(jié)可以之后再慢慢配置。
- 編輯站點(diǎn)
_config.yml
文件其中的deploy
節(jié)點(diǎn)時(shí)草描,注意repo
的值览绿。 - 替換域名時(shí):
- 直接在萬(wàn)維網(wǎng)設(shè)置解析方式;
- 在倉(cāng)庫(kù)Setting的要設(shè)置跳轉(zhuǎn)鏈接穗慕;
- CNAME會(huì)被覆蓋饿敲,安裝CNAME工具hexo-generator-cname
- 為博客文章添加閱讀量統(tǒng)計(jì)功能,參照這里逛绵,注意順序怀各,我在其中被坑過(guò)。
- 設(shè)置網(wǎng)站圖標(biāo)時(shí)术浪,就是上傳“.ico”文件時(shí)瓢对,確認(rèn)成功后瀏覽器會(huì)有緩存,顯示不出來(lái)胰苏,關(guān)掉瀏覽器清除緩存就好了(可放在最后)沥曹。
- 設(shè)置代碼高亮主題測(cè)試時(shí)沒(méi)事,上傳后會(huì)有延遲碟联,等等就好了(本人這樣)。
- 設(shè)置搜索欄僵腺,進(jìn)入swiftype官網(wǎng)鲤孵,注冊(cè)不上,應(yīng)該收費(fèi)了- -.
- 設(shè)置側(cè)邊欄社交鏈接時(shí)辰如,
social:
下面字段前要有兩個(gè)空格普监,切記。
相關(guān)網(wǎng)址
NexT琉兜、多說(shuō)凯正、百度統(tǒng)計(jì)、leancloud豌蟋、阿里云廊散、fork me、ico制作