Hexo搭建Github Pages託管的靜態個人博客

Hexo簡介

一個偶然的機會，我看到一篇介紹使用Markdown語言寫靜態博客的文章，一下子就喜歡上了這種專注寫作的方式。之前我在Github上託管的博客就是使用jekyll搭建的，官方的Github Pages同樣推薦使用它。通過體驗jekyll，沒有達到我想要的效果。於是尋找替代方案，搜索同類博客程序，我認識了Hexo：Hexo出自臺灣大學生tommy351之手,是由Node.js驅動的一款快速、簡單且功能強大的博客框架。Node.js是一個可以快速構建網絡服務及應用的平臺 。該平臺的構建是基於Chrome’s JavaScript runtime，也就是說，實際上它是對Google V8引擎（應用於Google Chrome瀏覽器)進行了封裝。V8引擎執行Javascript的速度非常快，性能非常好。Node對一些特殊用例進行了優化，提供了替代的API，使得V8在非瀏覽器環境下運行得更好。它和jekyll相比，更快，更輕量。

Hexo安裝

• 安裝git

• 大多數Linux發行版已經默認安裝了git,如果沒有直接使用包管理工具安裝
• Windows: Git-Downloads

• 安裝node.js

• Gentoo package: net-libs/nodejs
• Arch: nodejs
• Windows: node.js

• 安裝hexo

npm install hexo -g

配置Hexo

• 初始化博客根目錄

hexo init blog

• 安裝依賴包

npm install

安裝之後，項目目錄下出現如下文件結構：

.
├── _config.yml     全局配置文件
├── package.json
├── scaffolds
├── scripts
├── source           文章存放位置
| ├── _drafts        草稿
| └── _posts         文章
└── themes

插件和主題

• plugins: 插件

添加插件的基本操作是：

npm install <plugin-name> --save
npm update

然後修改blog根目錄下的_config.yml，添加：

plugins:
- plugin-name

• themes:

安裝主題：

git clone <repository> themes/<theme-name>

無論是插件還是主題在安裝後都需要在根目錄下_config.yml中修改plugins和theme的值以啓用他們。

本博客使用pacman主題，扁平化設計，響應速快，推薦使用。修改配置參考: http://yangjian.me/workspace/introducing-pacman-theme/

寫文章

使用Markdown語法編輯文章。使用hexo new命令生成文章或者直接在_posts目錄下直接創建文件，打開後先編輯文章頭部信息，如下所示是本文的頭部信息，以—結尾。

title: 使用Hexo搭建個人靜態博客  #文章頁面上的顯示名稱，可以任意修改，不會出現在URL中
layout: post
date: 2014-11-10 10:07:43  #文章生成時間，一般不改，當然也可以任意修改
updated: 2014-11-12 13:24
comments: true
categories: 
- Blog
tags: 
- hexo
- blog
---

文章摘要

在需要顯示摘要的地方添加如下代碼即可：

以上是摘要
<!--more-->
以下是餘下全文

文章中插入圖片

使用markdown寫文章，插入圖片的格式爲![圖片名稱](鏈接地址)，這裏要說的是鏈接地址怎麼寫。對於hexo，使用本地路徑：在/source目錄下新建一個img文件夾，將圖片放入該文件夾下，插入圖片時鏈接即爲/img/圖片名稱。

發佈博客

這裏的發佈也是十分簡單的，首先在github上創建名爲yourname.github.io的repo，接着修改_config.yml中的deploy字段，最後執行hexo d(前提是你已經在github上添加了你本機的ssh key)，OK，現在通過yourname.github.io已經可以訪問你的博客了。

deploy:
type: github
repo: [e-mail]:yourname/yourname.github.io.git
branch: master

如果是博客主頁以github項目的方式創建，分支選擇gh-pages。

或 多個平臺同時發佈

deploy:
type: git
repo:
  gitcafe: https://gitcafe.com/yourname/yourname.git,gh-pages
  github: https://github.com/yourname/yourname.github.io.git,master

Hexo使用

init 初始化博客

hexo init [folder]

如果目錄不存在，將設置初始化當前目錄

new 創建新文章

hexo new [layout] <title>

默認layout是post

generate 生成靜態網頁文件

hexo generate

publish 發佈草稿

hexo publish [layout] <filename>

server 啓動本地服務

hexo server

搭建本地server，進行文章預覽調試。
瀏覽器輸入http://localhost:4000 就可以看到效果。

deploy 發佈博客

hexo deploy

clean 清除緩存

hexo clean

清除緩存文件：Cleans the cache file (db.json) and generated files (public).

list 顯示博客結構

hexo list route

列出生成的所有博客文件路徑

常用命令

Hexo現在支持更加簡單的命令格式了，比如：

hexo n == hexo new
hexo g == hexo generate
hexo p == hexo publish
hexo s == hexo server
hexo d == hexo deploy
發佈博客：
hexo g -d
或
hexo d -g

參考：
- hexo.io
- hexo on github
- 搭建一個免費的，無限流量的Blog—-github Pages和Jekyll入門
- pacman主題介紹
- hexo你的博客