title: hexo1--hexo + github-pages博客的簡單搭建
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ù)，可以用來搭建個人頁面，GitHub Pages分兩種，一種是你的GitHub用戶名建立的username.github.io這樣的用戶&組織頁（站），另一種是依附項(xiàng)目的pages。我們要搭建自己的博客使用的是第一種方式，這種方式每個用戶名下面只能建立一個。

使用github創(chuàng)建的博客是屬于靜態(tài)網(wǎng)站博客，都是以靜態(tài)html形式展現(xià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)也不了解，不在我的知識范圍呢，使用hexo原因也很簡單，搜索出來hexo和jekyll二選一，我覺得hexo更簡潔一些而已（至少名字要好記）。

關(guān)于markdown

Markdown 是一種用來寫作的輕量級「標(biāo)記語言」，它用簡潔的語法代替排版，而不像一般我們用的字處理軟件 Word 或 Pages 有大量的排版、字體設(shè)置。它使我們專心于碼字，用「標(biāo)記」語法，來代替常見的排版格式。

雖然說是一種語言，其實(shí)學(xué)習(xí)成本很低，我在寫這篇博客時也才是剛剛使用。使用hexo來寫博客，需要使用markdown語言。

Markdown 語法說明 (簡體中文版)

博客搭建步驟

準(zhǔn)備工作

1. 你必須有一個github賬號。點(diǎn)此直達(dá)
2. 你必須在電腦上安裝了git工具，用于文章的上傳。點(diǎn)此下載
3. 安裝node.js，hexo是基于這個的，用于生成靜態(tài)頁面。點(diǎn)此下載

創(chuàng)建Github Pages項(xiàng)目

借用別人的一張圖：

1.png

然后需要配置SSH密鑰，可以讓本地git項(xiàng)目與遠(yuǎn)程的github建立聯(lián)系，讓我們在本地寫了代碼之后直接通過git操作就可以實(shí)現(xiàn)本地代碼庫與Github代碼庫同步。這個我就不贅述了，可以參考下這篇文章的第三節(jié)。

hexo的安裝和配置

安裝

找一個你喜歡的地方建個文件夾，進(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

反正我是不知道有什么用，直接全裝上了。安裝插件的時候也許會報錯，試試看更新下npm的版本：

npm i npm -g

然后需要做初始化：

hexo init

這樣文件夾內(nèi)就生成了博客的目錄，如下：

2.png

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文件均會被hexo處理。該頁面對應(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)頁面，后者是啟動服務(wù)，啟動后通過http://localhost:4000/能夠預(yù)覽你的博客。

3.png

hexo的常用命令和配置

關(guān)于你博客的設(shè)置可以分成2部分：

1. 全局設(shè)置：在你博客目錄下有一個文件名_config.yml，打開可以配置信息。
2. 局部設(shè)置：在你博客目錄下 \themes\你使用的主題_config.yml，經(jīng)常修改的應(yīng)該是這個文件，因?yàn)橹苯雨P(guā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)然，如果每次輸入那么長命令，那么一定想到用簡寫：

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)，按照如下配置：

4.png