Hexo 是一个基于Node.js的开源静态博客程序,通过markdown书写文章,生成的静态网页可以托管在github及gitcafe上。通过Hexo可以方便的创建自己的博客,本博客即使用Hexo创建并托管在github及gitcafe上。

依赖程序的安装

Hexo 基于Node.js,其部署通过Git进行,以下程序的安装过程仅以Windows平台为例。

安装 Node.js

Node.js 官网下载安装包,直接双击安装。

安装 Git

Git官网下载安装包,直接双击安装。

验证安装是否正确

在开始菜单中打开Git Bash,输入:

1
2
git --version
git version 2.5.2.windows.2

如果如上显示正确的版本号则Git 已正确安装。 输入:

1
2
npm -v
2.14.7

显示对应版本号则表示Node.js 已正确安装。

安装与部署 Hexo

安装Hexo

打开Git Bash 通过npm命令即可安装Hexo:

1
2
npm install hexo-cli -g
npm install hexo --save

初始化 Hexo

打开Git Bash并切换到想要存放Hexo的目录下,执行以下命令将在该目录下新建文件夹<folder>并在该文件夹中初始化Hexo:

D:\
1
hexo init <folder>
cd <folder>
npm install

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

D:\hexo
1
.
├── _config.yml   #主配置文件
├── package.json  #应用数据,不建议手动修改
├── .deploy       #将部署的静态文件,为git同步目录
├── node_modules  #Hexo安装的所有插件
├── scaffolds     #(脚手架)新建文章的模板文件
├── scripts       #自定义的随程序运行的脚本文件
├── source        #博客源文件,文章markdown文件、404和CNAME文件等
|   ├── _drafts   #文章草稿,不会被转换为html
|   └── _posts    #发表的文章
└── themes        #主题文件夹

本地查看Hexo 博客

执行以下命令打开Hexo 本地服务器

D:\hexo
1
hexo server
INFO  Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.

在浏览器中打开网址localhost:4000就可以查看默认的Hexo博客。

安装 Hexo 插件

Hexo 提供了许多插件以提供不同的功能,插件列表列出了可用的插件。以安装hexo-generator-feed插件为例。 该插件可以为博客增加rss订阅支持,在博客目录下打开命令行,输入以下命令即可安装该插件:

D:\hexo
1
npm install hexo-generator-feed --save

安装完成后在主目录的配置文件中可以配置该插件的功能:

D:\hexo\_config.yml
1
feed:
  type: atom
  path: atom.xml
  limit: 20

然后在页面添加对atom.xml文件的链接即可。 其他插件的功能、安装及配置可以查看插件列表详细了解。

安装 Hexo 主题

通过安装不同的主题,可以方便的使博客拥有不同的外观,官方的主题列表列举一些主题。 一款非常流行的Hexo主题NexT:

另一款流行的主题Jacman:

安装Hexo主题十分简单,首先下载主题后解压到主目录下的themes文件夹,建议使用git clone的方式安装主题,便于更新。 以安装NexT主题为例,打开命令行,切换到Hexo主目录下:

D:\hexo
1
git clone https://github.com/iissnan/hexo-theme-next themes/next

完成后,主题已被下载到了themes\next目录下。 当需要更新主题时,执行以下命令即可:

D:\hexo
1
2
cd themes/next
git pull origin master

之后更改主目录中的配置文件_config.yml应用新主题,修改其中的theme字段的值即可:

D:\hexo\_config.yml
1
theme: next
# 注意所有参数名后的冒号“:”后面必须有一个空格

然后重新生成网页文件即可:

D:\hexo
1
# 清除已经生成的缓存网页文件,只是新增文章时可以不执行该命令
hexo clean
# 生成网页文件,如果生成网页文件有问题,可以尝试先执行上一个clean命令清除缓存再重新生成
hexo generate

hexo generate 也可以用短命令 hexo g 代替。

之后打开本地服务器,查看应用新主题后的博客效果。

D:\hexo
1
hexo server

Hexo 的使用

用Hexo书写博客的流程为:

  1. hexo new "post-name"按照模板文件生成新的文章,该文件位于source/_posts文件夹中
  2. 按照markdown语法编辑post-name.md文件
  3. hexo generate生成新的网页文件
  4. hexo deploy部署生成的网页文件

Hexo常用命令

1
2
3
4
5
6
7
8
hexo help                  #查看hexo所有命令及帮助
hexo init #初始化一个目录
hexo new "post_Name" #新建文章
hexo new page "page_Name" #新建页面
hexo generate #生成网页, 可以在 public 目录查看整个网站的文件
hexo server #打开本地服务器,预览博客
hexo deploy #部署生成的博客至远端服务器
hexo clean #清除缓存网页文件,如果生成的网页有问题可以用此命令清除缓存后重新生成

Hexo 中的某些常用命令还支持简写:

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

本文主要介绍了Hexo博客本地应用程序的安装以及基本应用,在下一篇文章中将介绍将Hexo生成的博客部署至github及gitcafe上及自定义域名的绑定。