本篇主要介绍Hexo如何安装、使用,以及配置文件。

操作指南

系统环境

本系列文章以Hexo 3.0.0为例,操作系统为Windows 8.1 Pro VL x64 。

首先需要安装以下程序:

  • Node.js
    安装非常简单,一路Next即可。

  • Git
    安装建议勾选Git Bash Here,方便以后的操作。其他一路Next即可。

  • Notepad++(可选)
    文本编辑器,用于修改配置文件及写文章。

安装Hexo

  1. 新建一个文件夹,例如blog

  2. 进入blog文件夹,右键点击Git Bash Here

  3. 安装Hexo

    1
    npm install hexo-cli -g
  4. 初始化blog文件夹

    1
    hexo init
  5. 安装依赖和插件

    1
    npm install
  6. 启动服务器进行本地预览

    1
    hexo s
  7. 在浏览器中打开http://localhost:4000,成功的话即可看到博客页面,至此安装就完成了。

常用命令

Hexo的命令极简单,安装后只需要记住四个常用的即可。执行命令需要Git当前处于blog文件夹根目录下。

  • generate 生成静态文件。

    1
    hexo g
  • server 启动服务器。

    1
    hexo s
  • deploy 部署网站。部署网站前,需要预先生成静态文件。

    1
    hexo d
  • clean 清除缓存文件 (db.json) 和已生成的静态文件 (public)。

    1
    hexo clean

其他

  • Q:如何卸载Hexo?
    A:3.0.0版本执行npm uninstall hexo-cli -g,之前版本执行npm uninstall hexo -g

  • Q:如何安装旧版本Hexo?
    A:先卸载当前版本,以2.8.3为例,执行npm install [email protected] -g,再初始化并安装依赖和插件。

配置

Hexo的配置文件是位于blog文件夹下的_config.yml文件。

修改配置文件请使用Notepad++或者Sublime Text 2之类的程序,不要使用Windows自带的记事本。

以下为Hexo 3.0.0初始配置。常规需要修改的地方已加中文注释,未加注释的参数不建议新手修改。

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
# Hexo Configuration
## Docs: http://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/

# Site
title: Hexo ##站点标题
subtitle: ##站点副标题
description: ##站点描述
author: John Doe ##作者
language: ##语言包,需要主题自带才可设置。如Jcaman自带简繁英,设置简体中文填入 zh-CN
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/ ##文章永久链接格式,可添加.html后缀,如 :title.html
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
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: http://hexo.io/plugins/
## Themes: http://hexo.io/themes/
theme: landscape ##当前主题名称

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