上次我介紹了Hexo的基本搭建方法 近期tommy351大神 又更新了3.0版本
和之前的2.0使用步驟略有不同 目前剛剛更新 可能有許多主題和插件不兼容3.0 請(qǐng)等待後續(xù)更新

本文介紹從零開始搭建的方法 如需從2.x升級(jí)到3.0 遷移方法請(qǐng)移至本文最後

目錄

I.Hexo簡介

II.Hexo安裝方法

III.Hexo配置方法

IV.Hexo部署方法

I.Hexo簡介

Hexo 是一個(gè)輕量的靜態(tài)博客框架。通過Hexo可以快速生成一個(gè)靜態(tài)博客框架,僅需要幾條命令就可以完成,相當(dāng)方便。

而架設(shè)Hexo的環(huán)境更簡單了 不需要lnmp/lamp這些繁瑣複雜的環(huán)境 僅僅需要一個(gè)簡單的http服務(wù)器即可使用 或者使用互聯(lián)網(wǎng)上免費(fèi)的頁面託管服務(wù)
比如Hexo的官方網(wǎng)站http://hexo.io 就是託管於github的pages服務(wù)上

II.Hexo安裝方法

• Mac OS X/Linux或其他UNIX/類UNIX系統(tǒng)

• node環(huán)境 請(qǐng)去官方網(wǎng)站下載源代碼編譯安裝

  wget http://nodejs.org/dist/v0.12.0/node-v0.12.0.tar.gztar zxvf node-v0.12.0.tar.gzcd node-v0.12.0./configure --prefix=/usrmakemake install

• npm(node包管理器)

• redhat系

  yum install npm -y

• debian系

  apt-get install npm -y

其他發(fā)行版請(qǐng)自行尋找wiki獲得幫助

通過npm安裝Hexo-Cli 和 hexo

npm install hexo-cli -gnpm install hexo --save

如果以上命令不能安裝 可以嘗試把官方源替換爲(wèi)淘寶npm源 再執(zhí)行安裝Hexo

npm install -g cnpm --registry=https://registry.npm.taobao.org

或者你直接通過添加 npm 參數(shù) alias 一個(gè)新命令:

alias cnpm="npm --registry=https://registry.npm.taobao.org --cache=$HOME/.npm/.cache/cnpm --disturl=https://npm.taobao.org/dist --userconfig=$HOME/.cnpmrc"

Or alias it in .bashrc or .zshrc

$ echo '\n#alias for cnpm\nalias cnpm="npm --registry=https://registry.npm.taobao.org --cache=$HOME/.npm/.cache/cnpm --disturl=https://npm.taobao.org/dist --userconfig=$HOME/.cnpmrc"' >> ~/.zshrc && source ~/.zshrc

• Windows系統(tǒng)（具體環(huán)境配置請(qǐng)參考這個(gè)）
• node環(huán)境
• npm(node包管理器)

III.Hexo配置方法

新建一個(gè)需要當(dāng)做博客目錄的文件夾

mkdir blog

進(jìn)去之後加入hexo主程序和安裝npm

hexo init && npm install

文件夾大致結(jié)構(gòu)如下

• scaffolds 工具模板

• scripts hexo的功能js

• source 博客資源文件夾

• source/_drafts 草稿文件夾

• source/_posts 文章文件夾

• themes 存放皮膚的文件夾

• themes/landscape 默認(rèn)皮膚文件夾

• _config.yml 全局配置文件

• db.json json格式的靜態(tài)常量數(shù)據(jù)庫

_posts目錄：Hexo存放博客文章的文件夾

themes目錄：存放皮膚的文件夾，默認(rèn)使用官方的主題 你也可以從hexo主題頁面下載你喜歡的主題

配置Hexo

Hexo全局配置

用文本編輯器修改_config.yml這個(gè)文件 大致如下 只需要自行修改幾個(gè) 其他保持默認(rèn)即可

通常需要修改站點(diǎn)名稱 /URL格式 /歸檔設(shè)置 /disqus評(píng)論用戶名 /部署配置 這幾項(xiàng)就可以了 注意冒號(hào)後面都要添加一個(gè)半角空格 之後纔是設(shè)置參數(shù)

自定義域名設(shè)置 在source我文件夾下面新建CNAME文件 裏面寫入你的自定義域名 並設(shè)置您的dns配置cname方式到服務(wù)提供商的給的地址即可

網(wǎng)站

參數(shù) 描述
title 網(wǎng)站標(biāo)題
subtitle 網(wǎng)站副標(biāo)題
description 網(wǎng)站描述
author 您的名字
language 網(wǎng)站使用的語言
timezone 網(wǎng)站時(shí)區(qū)。Hexo 預(yù)設(shè)使用您電腦的時(shí)區(qū)。時(shí)區(qū)列表

網(wǎng)址

參數(shù) 描述 默認(rèn)值
url 網(wǎng)址
root 網(wǎng)站根目錄
permalink 文章的 永久鏈接 格式 :year/:month/:day/:title/
permalink_default 永久鏈接中各部分的默認(rèn)值
網(wǎng)站存放在子目錄
如果您的網(wǎng)站存放在子目錄中，例如 http://yoursite.com/blog，則請(qǐng)將您的 url 設(shè)爲(wèi) http://yoursite.com/blog 並把 root 設(shè)爲(wèi) /blog/。

目錄

參數(shù) 描述 默認(rèn)值
source_dir 資源文件夾，這個(gè)文件夾用來存放內(nèi)容。 source
public_dir 公共文件夾，這個(gè)文件夾用於存放生成的站點(diǎn)文件。 public
tag_dir 標(biāo)籤文件夾 tags
archive_dir 歸檔文件夾 archives
category_dir 分類文件夾 categories
code_dir Include code 文件夾 downloads/code
i18n_dir 國際化（i18n）文件夾 :lang
skip_render 跳過指定文件的渲染，您可使用 glob 來配置路徑。

文章

參數(shù) 描述 默認(rèn)值
new_post_name 新文章的文件名稱 :title.md
default_layout 預(yù)設(shè)佈局 post
auto_spacing 在中文和英文之間加入空格 false
titlecase 把標(biāo)題轉(zhuǎn)換爲(wèi) title case false
external_link 在新標(biāo)籤中打開鏈接 true
filename_case 把文件名稱轉(zhuǎn)換爲(wèi) (1) 小寫或 (2) 大寫 0
render_drafts 顯示草稿 false
post_asset_folder 啓動(dòng) Asset 文件夾 false
relative_link 把鏈接改爲(wèi)與根目錄的相對(duì)位址 false
future 顯示未來的文章 true
highlight 代碼塊的設(shè)置

分類 & 標(biāo)籤

參數(shù) 描述 默認(rèn)值
default_category 默認(rèn)分類 uncategorized
category_map 分類別名
tag_map 標(biāo)籤別名
日期 / 時(shí)間格式
Hexo 使用 Moment.js 來解析和顯示時(shí)間。

參數(shù) 描述 默認(rèn)值
date_format 日期格式 MMM D YYYY
time_format 時(shí)間格式 H:mm:ss
分頁
參數(shù) 描述 默認(rèn)值
per_page 每頁顯示的文章量 (0 = 關(guān)閉分頁功能) 10
pagination_dir 分頁目錄 page

擴(kuò)展

參數(shù) 描述
theme 當(dāng)前主題名稱
deploy 部署

Hexo常用插件安裝與配置

安裝首頁文章數(shù)量 存檔 分類 的插件
安裝本地服務(wù)器代理插件
安裝發(fā)佈器插件
安裝更新插件 rss site-map之類的

npm install hexo-generator-index --savenpm install hexo-generator-archive --savenpm install hexo-generator-category --savenpm install hexo-generator-tag --savenpm install hexo-server --savenpm install hexo-deployer-git --savenpm install hexo-deployer-heroku --savenpm install hexo-deployer-rsync --savenpm install hexo-deployer-openshift --savenpm install hexo-renderer-marked@0.2 --savenpm install hexo-renderer-stylus@0.2 --savenpm install hexo-generator-feed@1 --savenpm install hexo-generator-sitemap@1 --save

裝完之後去全局配置文件 _config.yml 修改參數(shù)

index_generator:  per_page: 10 ##首頁默認(rèn)10篇文章標(biāo)題 如果值爲(wèi)0不分頁archive_generator:  per_page: 10 ##歸檔頁面默認(rèn)10篇文章標(biāo)題  yearly: true  ##生成年視圖  monthly: true ##生成月視圖tag_generator:  per_page: 10 ##標(biāo)籤分類頁面默認(rèn)10篇文章category_generator:    per_page: 10 ###分類頁面默認(rèn)10篇文章feed:  type: atom ##feed類型 atom或者rss2  path: atom.xml ##feed路徑  limit: 20  ##feed文章最小數(shù)量deploy:  type: git ##部署類型 其他類型自行g(shù)oogle之  repo: <repository url> ##git倉庫地址  branch: [branch] ##git 頁面分支  message: [message] ##git message建議默認(rèn)字段update 可以自定義

-多部署

deploy:  type: git  message: update  ##git message建議默認(rèn)字段update 可以自定義  repo:   github: <repository url>,[branch] ##github 倉庫地址和分支  gitcafe: <repository url>,[branch] ##gitcafe 倉庫地址和分支

更多插件可以去Hexo插件wiki找到 https://github.com/hexojs/hexo/wiki/Plugins

Hexo主題設(shè)置

同樣編輯主題文件夾的_config.yml

Header

menu: #導(dǎo)航欄連接
Home: /
Archives: /archives #歸檔頁面URL
自定義頁面標(biāo)題: /自定義頁面URL
rss: /atom.xml #rss地址 默認(rèn)即可

Content

excerpt_link: Read More #閱讀更多的文字顯示
fancybox: true #開啓fancybox效果

Sidebar #側(cè)邊欄設(shè)置

sidebar: right
widgets:

• category
• tag
• tagcloud
• archive
• recent_posts

Miscellaneous #社交網(wǎng)絡(luò)和統(tǒng)計(jì)連接地址

google_analytics: #google analytics ID
favicon: /favicon.png #網(wǎng)站的favicon
twitter:
google_plus:
fb_admins:
fb_app_id:

寫文章

Hexo使用markdown語法的純文本存放文章 後綴爲(wèi).md 你可以在_post文件夾裏面新建這個(gè)後綴的.md文件 使用的全是UTF-8編碼

也可以輸入命令以生成

hexo new post <title>

如果是新建一個(gè)頁面

hexo new page <title>

看一下剛纔生成的

title: title #文章標(biāo)題date: 2015-02-05 12:47:44 #文章生成時(shí)間categories: #文章分類目錄 可以省略tags: #文章標(biāo)籤 可以省略description: #你對(duì)本頁的描述 可以省略---   這裏開始使用markdown格式輸入你的正文。

多標(biāo)籤注意語法格式 如下:

tags:- 標(biāo)籤1- 標(biāo)籤2- 標(biāo)籤3- etc...

想在首頁文章預(yù)覽添加圖片可以添加photo參數(shù) 這個(gè)fancybox可以省略 如下:

photos:  - http://xxx.com/photo.jpg

正文中可以使用<!--more-->設(shè)置文章摘要 如下:

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

more以上內(nèi)容即是文章摘要，在主頁顯示，more以下內(nèi)容點(diǎn)擊『> Read More』鏈接打開全文才顯示。

IV.Hexo部署方法

寫完文章之後 就可以啓動(dòng)本地服務(wù)器測(cè)試了

hexo server

這個(gè)時(shí)候hexo啓動(dòng)localhost的4000端口 靜態(tài)的網(wǎng)站架設(shè)完成

推薦部署在 Github 或者 Gitcafe 的pages服務(wù)上

修改後就可以部署上去了

hexo clean #清除緩存 網(wǎng)頁正常情況下可以忽略此條命令hexo g #生成靜態(tài)網(wǎng)頁hexo d #開始部署

以上就是Hexo的基本使用方法 進(jìn)階的可以在Hexo的官方文檔裏找到 感謝閱讀!

Enjoy~

hexo3.0帶來了更好的性能，更新了API，模塊化了大部分組件。更多變化看這裏： https://github.com/hexojs/hexo/wiki/Breaking-Changes-in-Hexo-3.0

hexo2.x到3.0遷移指南：

原文： https://github.com/hexojs/hexo/wiki/Migrating-from-2.x-to-3.08