Hexo搭建GitHub博客(二)- Hexo配置使用

这篇博文主要介绍Hexo的配置安装和Hexo的常用命令,还有如何部署博客到GitHub。

Hexo 安装

打开Git命令行,执行如下命令

$ npm install -g hexo                

初始化博客

安装 Hexo 完成后,请执行下列命令,Hexo 将会在指定文件夹中新建所需要的文件。

1
2
3
$ hexo init blog
$ cd blog
$ npm install

新建完成后,指定文件夹的目录如下:

1
2
3
4
5
6
7
8
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes

_config.yml

1
网站的配置信息,您可以在此配置大部分的参数。

package.json

应用程序的信息。EJS, Stylus 和 Markdown renderer 已默认安装,您可以自由移除。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
package.json
{
"name": "hexo-site",
"version": "0.0.0",
"private": true,
"hexo": {
"version": "3.2.2"
},
"dependencies": {
"hexo": "^3.2.0",
"hexo-deployer-git": "^0.2.0",
"hexo-generator-archive": "^0.1.4",
"hexo-generator-category": "^0.1.3",
"hexo-generator-index": "^0.2.0",
"hexo-generator-searchdb": "^1.0.3",
"hexo-generator-tag": "^0.2.0",
"hexo-migrator-rss": "^0.1.2",
"hexo-renderer-ejs": "^0.2.0",
"hexo-renderer-marked": "^0.2.10",
"hexo-renderer-stylus": "^0.3.1",
"hexo-server": "^0.2.0",
"hexo-toc": "^1.0.4"
}
}

scaffolds

模版文件夹。当您新建文章时,Hexo 会根据 scaffold 来建立文件。

source

资源文件夹是存放用户资源的地方。除 posts 文件夹之外,开头命名为 (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹,而其他文件会被拷贝过去。

themes

主题文件夹。Hexo 会根据主题来生成静态页面。

配置

您可以在 _config.yml 中修改大部份的配置。

网站

网站

网址

网址

网站存放在子目录

如果您的网站存放在子目录中,例如 http://yoursite.com/blog,则请将您的 url 设为 http://yoursite.com/blog 并把 root 设为 /blog/

目录

目录

文章

文章

分类 & 标签

分类&标签

日期 / 时间格式

Hexo 使用 Moment.js 来解析和显示时间。

日期

分页

分页

扩展

扩展

Hexo 指令

init

$ hexo init [folder]     

新建一个网站。如果没有设置 folder,Hexo 默认在目前的文件夹建立网站。

new

$ hexo new [layout] <title>                    

新建一篇文章。如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话,请使用引号括起来。

generate

$ hexo generate                          

生成静态文件。

publish

$ hexo publish [layout] <filename>                                       

发表草稿。

server

$ hexo server                 

启动服务器。默认情况下,访问网址为: http://localhost:4000/。

deploy

$ hexo deploy                                 

部署网站。

render

$ hexo render <file1> [file2] ...        

渲染文件。

migrate

$ hexo migrate <type>                

从其他博客系统迁移内容。

clean

$ hexo clean        

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

list

$ hexo list <type>            

列出网站资料。

version

$ hexo version                

显示 Hexo 版本。

选项

安全模式
$ hexo --safe                         

在安全模式下,不会载入插件和脚本。当您在安装新插件遭遇问题时,可以尝试以安全模式重新执行。

调试模式
$ hexo --debug                            

在终端中显示调试信息并记录到 debug.log。当您碰到问题时,可以尝试用调试模式重新执行一次,并 提交调试信息到 GitHub。

简洁模式
$ hexo --silent                            

隐藏终端信息。

自定义配置文件的路径
$ hexo --config custom.yml                        

自定义配置文件的路径,执行后将不再使用 _config.yml。

显示草稿
$ hexo --draft                        

显示 source/_drafts 文件夹中的草稿文章。

自定义 CWD
$ hexo --cwd /path/to/cwd            

自定义当前工作目录(Current working directory)的路径。

测试

启动Server

运行以下命令

$ hexo server                         

Hexo server启动后,在浏览器中打开http://localhost:4000/ 即可访问自己的博客,按Ctrl+C停止

创建文章

运行以下命令,可生成一篇文章,刷新http://localhost:4000/ 即可看到新生成的文章。

$ hexo new "hello-hexo"                                

同时在/blog/source/_posts目录下会生成一个”hello-hexo.md”的markdown文件,可以使用一个支持markdown语法的编辑器来编辑该文件,刷新http://localhost:4000/ 即可看到修改后的结果。

打开这个文件

新建文件
生成静态网页

运行以下命令,将markdown文件生成静态网页。

$ hexo generate                

同时在/blog/目录下会生成一个public文件夹,里面是生成的静态文件。

部署到GitHub

至此我们已经可以在本地访问自己的博客了,但是只有本地能够看到,要部署到GitHub上面别人才能看到。我们可以在本地调试编辑好文章后再推送到GitHub上面。下面是部署到GitHub的过程。

创建github page

在第一篇文章中我们已经在自己的github中创建了自己的github page。参考Hexo搭建GitHub博客(一)- 环境搭建

安装自动部署到GitHub的插件

在初始化博客的时候运行的npm install命令默认并没有安装这个插件,所以要手动安装。
运行以下命令

$ npm install hexo-deployer-git              

修改站点配置文件

修改位于 blog 目录下的 _config.yml 文件
找到以下内容

GitHub配置

repository是自己github page的项目地址

运行hexo deploy命令

运行以下命令

$ hexo deploy                

过程中会提示输入你的github账号和密码,等待命令运行完成即可。部署完成后,在浏览器中访问wgfxcu.github.io能够看到你在本地调试好的博客,表示部署成功!

部署步骤总结

至此,部署到GitHub的工作已经完成,之后如果我们希望对自己的博客进行修改或者需要发布新的文章时,可以按以下三步进行。

1
2
3
$ hexo clean # 删除已经生成的静态页面
$ hexo generate
$ hexo deploy