Hexo使用攻略：（三）Hexo的配置和使用

通过前面的操作，我们已经可以把本地新建的页面通过hexo d更新到GitHub了。
下面我们来熟悉一下如何新建、编辑Hexo内容以及常用的一些配置。

基本配置

在Hexo中，有两个配置文件，一个是用来配置整站信息的，位于项目更目录下的_config.yml文件。另外一个是对主题的配置，位于themes目录下你所采用的主题目录里，文件名同样是_config.yml。

首先，我们来看第一个配置文件，整站信息配置：

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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
# Hexo Configuration
## Docs: http://hexo.io/docs/configuration.html
## Source: https://github.com/hexojs/hexo/
# Site 这里的配置，哪项配置反映在哪里，可以参考我的博客
title: GoonX #站点名，站点左上角
subtitle: 我走的很慢，但我从不后退。 #副标题，站点左上角
description: GoonX #给搜索引擎看的，对站点的描述，可以自定义
author: ijiaober #默认在站点左下角可以看到
email: ijiaober@qq.com #邮箱
language: zh-CN #语言包设置。
# URL #访问地址等信息设置，可根据需要自己修改。
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://ijiaober.github.io #访问域名
root: /
permalink: :year/:month/:day/:title/ #具体内容页的存储路径结构
tag_dir: tags #标签目录名
archive_dir: archives #归档目录名
category_dir: categories #分类目录名
# Directory #默认文章和生成目录设置
source_dir: source
public_dir: public
# Writing 文章布局、写作格式的定义
new_post_name: :title.md # File name of new posts
default_layout: post
auto_spacing: false # Add spaces between asian characters and western characters
titlecase: false # Transform title into titlecase
max_open_file: 100
filename_case: 0
highlight:
  enable: true
  backtick_code_block: true
  line_number: true
  tab_replace:
# Category & Tag 分类和标签设置
default_category: uncategorized
category_map:
tag_map:
# Archives 默认值为2，如果这里都修改为1，相应页面就只会列出标题，而非全文
## 2: Enable pagination
## 1: Disable pagination
## 0: Fully Disable
archive: 1
category: 1
tag: 1
# Server 本地预览服务信息，默认端口是4000，有需要的话可以自己修改
## Hexo uses Connect as a server
## You can customize the logger format as defined in
## http://www.senchalabs.org/connect/logger.html
port: 4000
logger: false
logger_format:
# 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: MMM D YYYY
time_format: H:mm:ss
# Pagination 每页显示文章数，可以自定义
## Set per_page to 0 to disable pagination
per_page: 5
pagination_dir: page
# Disqus Disqus 插件，我们会替换成“多说”
disqus_shortname:
# Extensions 这里配置站点所用主题和插件
## Plugins: https://github.com/hexojs/hexo/wiki/Plugins
## Themes: https://github.com/hexojs/hexo/wiki/Themes
theme: light
exclude_generator:
# Deployment 站点部署到github要配置
## Docs: http://hexo.io/docs/deployment.html
deploy:
  type: github
  repository: https://github.com/ijiaober/ijiaober.github.io.git
  branch: master

当你根据自己的需要修改了配置以后，就可以依次使用hexo g和hexo s命令，然后通过localhost:4000来查看效果了。

我们再来看看主题下的配置文件：

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
menu: #右上角导航菜单，冒号前面是菜单名，后面是访问路径。
  Home: /
  Archives: /archives
  About: /about
  
widgets: #站点右边栏，可以调整顺序和增减内容，会自动调用主题layout/_widget目录下的同名文件。
- search
- category
- tagcloud
excerpt_link: Read More #列表页里Read more链接名称，可以替换成’查看更多‘等。
plugins: 
twitter: #右边栏要显示twitter展示的话，需要在此设置
  username: 
  show_replies: false
  tweet_count: 5
addthis: #分享设置
  enable: true
  pubid:
  facebook: true
  twitter: true
  google: true
  pinterest: true
fancybox: true #图片效果，默认
google_analytics: #google_analytics统计ID
rss:  #生成RSS路径

开始使用

Good job!
我们已经完成了Hexo的简单配置，下面就来发布我们第一篇文章吧。

  1. 在Hexo目录下输入：

hexo n “Hello post” #引号里的是文件名，可以自己定义

  1. 在Hexo/source/_posts目录下找到刚才建立的Hllo-post.md文件，可以用sublime text等工具来编辑。
1
2
3
4
5
6
title: Hello post #文章标题
date: 2014-08-05 11:15:00 #发表时间
categories: #分类
tags: #标签，多个标签时可以用[标签1,标签2]的方式，或者”- 标签“的方式每行一个。
---
#这里是正文，用markdown语法写。

  1. 编辑完文章后依次执行hexo g和hexo s,然后访问localhost:4000来预览效果

  2. 没有问题了以后，执行hexo d来同步到GitHub。

扩展阅读：
关于Hexo的更多命令，可以参阅commands;
关于Hexo的配置说明，可以参阅configuration;

Hexo
hexo