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

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

Hexo安装

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

1
$ npm install -g hexo

初始化博客

在电脑上建立一个自己博客的文件夹(如E:\Hexo,以下教程都以这个目录为博客根目录),然后在此目录下打开Git Bash,执行如下命令

1
$ hexo init

这时候会输出

1
2
INFO Copying data e:\Hexo
INFO You are almost done! Don't forget to run `npm install` before you start blogging with Hexo!

在E:\Hexo目录下会生成以下文件

source:用于存放我们用markdown编写的博文源文件和静态资源
themes:用于存放主题文件,每个主题也有自己的主题配置文件_config.yml文件
_config.yml:站点配置文件,用于配置博客信息,如作者,博客名称等

按照提示运行npm install命令,在E:\Hexo目录下会增加一个node_modules文件夹

1
$ npm install

至此,博客的安装部署工作基本完成了,下面我们学习一下hexo的基本操作命令

Hexo命令

启动Server

运行以下命令

1
$ hexo server

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

创建文章

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

1
$ hexo new "new-post"

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

打开这个文件

1
2
3
4
5
6
title: new-post #文章标题
date: 2015-09-26 17:00:07 #发表日期
categories: blog #文章文类
tags: [博客,文章] #文章标签,多于一项时用这种格式
---
# 正文,用markdown写

生成静态网页

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

1
$ hexo generate

同时在E:\Hexo目录下会生成一个public文件夹,里面是生成的静态文件。

部署到GitHub

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

创建github page

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

安装自动部署到GitHub的插件

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

1
$ npm install hexo-deployer-git

修改站点配置文件

修改位于E:\Hexo目录下的_config.yml文件
找到以下内容

1
2
3
4
# Deployment
## Docs: http://hexo.io/docs/deployment.html
deploy:
type:

修改为

1
2
3
4
5
6
# Deployment
## Docs: http://hexo.io/docs/deployment.html
deploy:
type: git
repository: https://github.com/zhiho/zhiho.github.io.git
branch: master

Repository是自己github page的项目地址

运行hexo deploy命令

运行以下命令

1
$ hexo deploy

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

部署步骤总结

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

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

命令总结

常用命令

1
2
3
4
5
6
hexo new "postName" #新建文章
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
hexo deploy #将.deploy目录部署到GitHub
hexo help # 查看帮助
hexo version #查看Hexo的版本

生成静态文件并启动本地服务

1
hexo s -g

命令简写

1
2
3
4
hexo n == hexo new
hexo g == hexo generate
hexo s == hexo server
hexo d == hexo deploy