Hexo博客教程系列（0x01）：Hexo的安装和配置

前言

Hexo的安装和配置内容主要由四个部分组成，它们分别是：

• Node.js:
  因为Hexo是基于Node.js框架进行开发的，所以Node.js为Hexo提供了必需的运行基础。

• Git:
  Git是著名的分布式版本控制软件，它可以对博客网站的仓库进行管理和远程部署。

• GitHub Pages:
  GitHub Pages是面向用户、组织和项目开放的公共静态页面搭建托管服务，博客站点可以被免费托管在GitHub上。

• Hexo:
  Hexo是一个简洁且强大的博客框架。

安装

前提

首先需要安装以下程序：

• Node.js
• Git

安装Node.js

Windows系统

直接从Node.js官网上下载相应（32或64位）的Node.js软件安装包，一路Next即可。

Ubuntu系统

安装Node.js的最佳方式是使用nvm。

1

$> wget -qO- https://raw.github.com/creationix/nvm/master/install.sh | sh

执行完命令之后，可使用以下命令来安装最新长期支持版本的Node.js：

1

$> nvm install --lts

或安装最新稳定版本的Node.js：

1

$> nvm install stable

安装Git

Windows系统

直接从Git官网上下载相应（32或64位）的软件安装包进行安装。安装时，请勾选Add to PATH选项。安装时强烈建议勾选Git Bash，Git Bash提供了一组Linux风格的Shell环境。在该环境下，你可以直接通过命令行的方式来安装Node.js以及之后的Hexo。因为Hexo的很多操作都涉及命令行的操作，所以Git Bash很重要！

Ubuntu系统

直接通过命令行来安装

1
2

$> sudo apt-get update
$> sudo apt-get install git-core

安装Hexo

在国内，npm下载安装包的速度会很慢（除了已翻墙的用户），推荐使用淘宝源或镜像，速度会比较快。

安装Hexo-cli

方法一：使用淘宝源来替换官方软件源

1

$> npm config set registry https://registry.npm.taobao.org

之后跟官方教程一样安装Hexo

1

$> npm install -g hexo-cli

方法二：使用淘宝镜像来替换官方镜像

1

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

之后就可以使用cnpm命令来安装Hexo了

1

$> cnpm install -g hexo-cli

因为我本人是一个坚定的K.I.S.S(Keep It Simple, Stupid)支持者，崇尚Unix的设计哲学。所以我在安装Hexo时会选择方法一，因为它不需要安装额外的软件，只是修改了用户的配置，比较精简。

初始化Hexo

切换目录到用户桌面

1

$> cd ~/Desktop

创建空文件夹，名字可以随便取，但最好跟你的博客有关

1
2

$> mkdir xxx_blog
$> cd xxx_blog

初始化博客文件夹

1

$> hexo init

安装Hexo默认的依赖和插件

1

$> npm install

安装Git插件并保存为Hexo的依赖，为部署到GitHub Page做准备

1

$> npm install hexo-deployer-git --save

配置

配置Git和GitHub

已配置过SSH Key的可以略过本小节。

• 打开Shell软件（Windows下Git Bash，Ubuntu下为默认的Terminal），依次输入以下命令

  配置全局的用户名和E-mail地址

  1 2	$> git config --global user.name "your_name" $> git config --global user.email "your_email@xxx.com"

  根据E-mail地址生成特定的ssh密钥

  1	$> ssh-keygen -t rsa -C "your_email@xxx.com"

  Windows用户注意：如果生成的.ssh文件夹默认不在C:\Users\xxx下，你可以通过向用户添加HOME环境变量为C:\Users\xxx来解决这个问题。

• 登录GitHub并点击Setting选项。

  

• 使用文本编辑器打开.ssh文件夹下的id_rsa.pub文件，将里面的内容添加到你的GitHub账户设置中的SSH Key中去。

  

• 再次打开Shell软件（Windows下Git Bash，Ubuntu下为默认的Terminal），输入以下命令

  1	$> ssh -T git@github.com

  如果Shell软件返回以下信息，就说明Git已经配置好了。

  1	$> Hi xxx! You've successfully authenticated, but GitHub does not provide shell access.

配置GitHub Pages

已配置过GitHub Page的可以略过本小节。

• 登录你的GitHub，点击New repository。

  

• 填写仓库的名字和相关描述。

  

  在设置界面上填写Repository name时一定要注意，仓库的名字是固定的。即your_name.github.io

• 点击Create repository完成。

配置Hexo

以下是生成的_config.yaml中的默认内容

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

# Hexo Configuration
## Docs: https://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/

# Site
title: Hexo
subtitle:
description:
author: John Doe
language:
timezone:

# URL
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://yoursite.com
root: /
permalink: :year/:month/:day/:title/
permalink_defaults:

# Directory
source_dir: source
public_dir: public
tag_dir: tags
archive_dir: archives
category_dir: categories
code_dir: downloads/code
i18n_dir: :lang
skip_render:

# Writing
new_post_name: :title.md # File name of new posts
default_layout: post
titlecase: false # Transform title into titlecase
external_link: true # Open external links in new tab
filename_case: 0
render_drafts: false
post_asset_folder: false
relative_link: false
future: true
highlight:
  enable: true
  line_number: true
  auto_detect: false
  tab_replace:

# Category & Tag
default_category: uncategorized
category_map:
tag_map:

# Date / Time format
## Hexo uses Moment.js to parse and display date
## You can customize the date format as defined in
## http://momentjs.com/docs/#/displaying/format/
date_format: YYYY-MM-DD
time_format: HH:mm:ss

# Pagination
## Set per_page to 0 to disable pagination
per_page: 10
pagination_dir: page

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: landscape

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type:

以下讲解每个参数的含义以及推荐的基本配置

网站

网址

目录

文章

分类 & 标签

日期 & 时间格式

分页

扩展

部署

最后讲一下Hexo部署的详细配置过程

修改以下配置

1
2

deploy:
  type:

为

1
2
3
4

deploy:
  type: git
  repo: git@github.com:your_name/your_name.github.io.git
  branch: master

命令

Hexo的命令极简单，安装后只需要记住以下五个常用的即可。执行命令时，需要Shell处于当前xxx_blog文件夹根目录下。

• 新建一篇文章，默认使用_config.yaml中default_layout参数指定的布局

  1	$> hexo new [layout] <title>

• 生成静态文件

  1	$> hexo generate

  或者简写为

  1

  $> hexo g

• 启动本地调试服务器

  1	$> hexo server

  或者简写为

  1

  $> hexo s

• 部署到远程网站，部署前请确保已经安装Git插件并已经按照上述完成了_config.yaml中的相关配置

  1	$> hexo deploy

  或者简写为

  1

  $> hexo d

• 清除缓存文件db.json和已生成的静态文件夹public

  1	$> hexo clean

总结

至此，最基本的Hexo博客网站就已经搭建好了，后续就是使用Markdown语法来写文章，最后部署就行了。当然，以上只是Hexo配置和使用的最基本流程，如果你想拥有个性化的博客网站界面以及一些增强功能的话，我会在接下来的文章中详细地介绍Hexo主题的配置方法，它肯定可以让你的博客变得更加酷炫的。