title: hexo1--hexo + github-pages博客的簡(jiǎn)單搭建
date: 2017-01-04 14:15:08
categories: hexo建博
tags: hexo
copyright: true
keywords: github pages hexo 博客
comments: ture
關(guān)于github pages
Github Pages 是github提供的一種服務(wù)狈茉,可以用來搭建個(gè)人頁面挥吵,GitHub Pages分兩種,一種是你的GitHub用戶名建立的username.github.io這樣的用戶&組織頁(站)葛菇,另一種是依附項(xiàng)目的pages碳褒。我們要搭建自己的博客使用的是第一種方式叉寂,這種方式每個(gè)用戶名下面只能建立一個(gè)惠桃。
使用github創(chuàng)建的博客是屬于靜態(tài)網(wǎng)站博客驶乾,都是以靜態(tài)html形式展現(xiàn),好處就是簡(jiǎn)單金刁。
關(guān)于hexo
hexo是一款基于Node.js的靜態(tài)博客框架。目前在GitHub上已有1375 star 和 219 fork议薪。
特性
- 風(fēng)一般的速度
Hexo基于Node.js尤蛮,支持多進(jìn)程,幾百篇文章也可以秒生成斯议。
- 流暢的撰寫
支持GitHub Flavored Markdown和所有Octopress的插件产捞。
- 擴(kuò)展性
Hexo支持EJS、Swig和Stylus哼御。通過插件支持Haml坯临、Jade和Less。
也有很多類似的框架恋昼,比如Jekyll看靠、Ghost等等,我反正一點(diǎn)也不了解液肌,不在我的知識(shí)范圍呢挟炬,使用hexo原因也很簡(jiǎn)單,搜索出來hexo和jekyll二選一嗦哆,我覺得hexo更簡(jiǎn)潔一些而已(至少名字要好記)谤祖。
關(guān)于markdown
Markdown 是一種用來寫作的輕量級(jí)「標(biāo)記語言」,它用簡(jiǎn)潔的語法代替排版老速,而不像一般我們用的字處理軟件 Word 或 Pages 有大量的排版粥喜、字體設(shè)置。它使我們專心于碼字橘券,用「標(biāo)記」語法额湘,來代替常見的排版格式卿吐。
雖然說是一種語言,其實(shí)學(xué)習(xí)成本很低缩挑,我在寫這篇博客時(shí)也才是剛剛使用但两。使用hexo來寫博客,需要使用markdown語言供置。
博客搭建步驟
準(zhǔn)備工作
- 你必須有一個(gè)github賬號(hào)谨湘。點(diǎn)此直達(dá)
- 你必須在電腦上安裝了git工具,用于文章的上傳芥丧。點(diǎn)此下載
- 安裝node.js紧阔,hexo是基于這個(gè)的,用于生成靜態(tài)頁面续担。點(diǎn)此下載
創(chuàng)建Github Pages項(xiàng)目
借用別人的一張圖:
然后需要配置SSH密鑰擅耽,可以讓本地git項(xiàng)目與遠(yuǎn)程的github建立聯(lián)系,讓我們?cè)诒镜貙懥舜a之后直接通過git操作就可以實(shí)現(xiàn)本地代碼庫與Github代碼庫同步物遇。這個(gè)我就不贅述了乖仇,可以參考下這篇文章的第三節(jié)。
hexo的安裝和配置
安裝
找一個(gè)你喜歡的地方建個(gè)文件夾询兴,進(jìn)文件夾使用Git Bash敲命令
npm install -g hexo-cli
此外有很多插件可以選擇:
npm install hexo-generator-index --save
npm install hexo-generator-archive --save
npm install hexo-generator-category --save
npm install hexo-generator-tag --save
npm install hexo-server --save
npm install hexo-deployer-git --save
npm install hexo-deployer-heroku --save
npm install hexo-deployer-rsync --save
npm install hexo-deployer-openshift --save
npm install hexo-renderer-marked@0.2 --save
npm install hexo-renderer-stylus@0.2 --save
npm install hexo-generator-feed@1 --save
npm install hexo-generator-sitemap@1 --save
反正我是不知道有什么用乃沙,直接全裝上了。安裝插件的時(shí)候也許會(huì)報(bào)錯(cuò)诗舰,試試看更新下npm的版本:
npm i npm -g
然后需要做初始化:
hexo init
這樣文件夾內(nèi)就生成了博客的目錄警儒,如下:
deploy:執(zhí)行hexo deploy命令部署到GitHub上的內(nèi)容目錄
public:執(zhí)行hexo generate命令,輸出的靜態(tài)網(wǎng)頁內(nèi)容目錄
scaffolds:layout模板文件目錄眶根,其中的md文件可以添加編輯
scripts:擴(kuò)展腳本目錄蜀铲,這里可以自定義一些javascript腳本
source:文章源碼目錄,該目錄下的markdown和html文件均會(huì)被hexo處理属百。該頁面對(duì)應(yīng)repo的根目錄记劝,404文件、favicon.ico文件诸老,CNAME文件等都應(yīng)該放這里隆夯,該目錄下可新建頁面目錄。
_drafts:草稿文章
_posts:發(fā)布文章
themes:主題文件目錄
_config.yml:全局配置文件别伏,大多數(shù)的設(shè)置都在這里
package.json:應(yīng)用程序數(shù)據(jù)蹄衷,指明hexo的版本等信息,類似于一般軟件中的關(guān)于按鈕
至此hexo也就安裝好了厘肮,可以試著預(yù)覽下愧口,需要通過命令:
hexo g
hexo s
前者是生成靜態(tài)頁面,后者是啟動(dòng)服務(wù)类茂,啟動(dòng)后通過http://localhost:4000/能夠預(yù)覽你的博客耍属。
hexo的常用命令和配置
關(guān)于你博客的設(shè)置可以分成2部分:
- 全局設(shè)置:在你博客目錄下有一個(gè)文件名_config.yml托嚣,打開可以配置信息。
- 局部設(shè)置:在你博客目錄下 \themes\你使用的主題_config.yml厚骗,經(jīng)常修改的應(yīng)該是這個(gè)文件示启,因?yàn)橹苯雨P(guān)乎到博客的樣子
常用命令都很簡(jiǎn)單:
Hexo常用命令:
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 clean #有任何問題都可以使用clean試試
當(dāng)然领舰,如果每次輸入那么長(zhǎng)命令夫嗓,那么一定想到用簡(jiǎn)寫:
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy
復(fù)合命令:
hexo d -g
hexo s -g
其他命令:
npm update -g hexo #更新hexo
和Github pages項(xiàng)目進(jìn)行關(guān)聯(lián)
復(fù)制你的github pages項(xiàng)目的地址,例如我的是:https://github.com/lanshu/lanshu.github.io.git冲秽。
打開你的hexo文件夾的配置文件_config.yml舍咖,找到deploy節(jié)點(diǎn),按照如下配置:
到此锉桑,最初始的博客就搭建完成了并能通過github pages的地址可以訪問到排霉。