简介

Hexo 是一个快速、简洁且高效的静态站点生成框架，它基于 Node.js 。它有以下特点：

通过 Hexo 你可以轻松地使用 Markdown 编写文章，除了 Markdown 本身的语法之外，还可以使用 Hexo 提供的标签插件来快速的插入特定形式的内容。

基于 Hexo 这个优秀的博客框架，很多优秀的开发者奉献出了它们基于 Hexo 开发的主题。
NexT 因其精于心，简于形的风格，一直被广大用户所喜爱。

安装

安装 Hexo 只需几分钟时间，若你在安装过程中遇到问题或无法找到解决方式，请提交问题，我会尽力解决你的问题。

安装前提

安装 Hexo 相当简单。然而在安装前，您必须检查电脑中是否已安装下列应用程序:

Node.js
Git

如果您的电脑中已经安装上述必备程序，那么恭喜你！接下来只需要使用 npm 即可完成 Hexo 的安装。

1	$ npm install -g hexo-cli

如果你的电脑中尚未安装所需要的程序，请根据以下安装指示完成安装。

安装 Git

Windows：下载安装 git 。 Download Now
Mac：使用 Homebrew，MacPorts 或下载安装程序安装
Linux（Ubuntu，Debian）：sudo apt-get install git-core
Linux（Fedora，Red Hat，CentOS）：sudo yum install git-core

安装 Node.js

安装 Node.js 的最佳方式是使用 nvm。（nvm：Node Version Manager）
windows 下使用 nvm 请看这里： nvm-windows ，首先需要下载安装 nvm 。 Download Now
windows下安装完nvm以后，我们可以打开命令行中执行命令

1 2	$ nvm $ nvm install latest

执行完以后，重启命令行，执行命令 node -v ，如果出现版本号，那么 Node.js 就安装成功了。

如果没有安装成功，那可能就是墙的原因。建议下载 `Node.js` 直接安装。 Download Now

安装 Hexo

有了 Node.js ，我们可以使用 npm 安装 Hexo。

1	$ npm install -g hexo-cli

安装 Hexo 完成后，我们首先需要为我们的项目创建一个指定文件夹（例如我在 D 盘目录下创建了一个文件夹 blog 。D:\blog ），在指定文件夹中执行下列命令， Hexo 将会在指定文件夹中新建所需要的文件。

1	$ hexo init

等待安装，安装完成后，指定文件夹的目录如下：

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└──

我们继续执行命令

1 2	$ hexo g $ hexo s --debug

Hexo 将 source 文件夹中除 posts 文件夹之外，开头命名为 (下划线)的文件 / 文件夹和隐藏的文件将会被忽略。Markdown 和 HTML 文件会被解析并放到 public 文件夹，而其他文件夹会被拷贝过去。
这个时候，我们在浏览器中访问 http://localhost:4000/ ，就可以看到基于 Hexo 的默认主题的原型：

安装 NexT 主题

下载 NexT 主题

依旧是在当前目录下，使用 Git 来 checkout 代码：

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

提示：原作者 iissnan 已经停止更新 hexo-theme-next；所以，如果你想使用 5.x 之前的版本可以使用上面的链接下载 NexT 主题；如果你想体验 6.x 之后的新版本，请使用下面的链接。

1	$ git clone https://github.com/theme-next/hexo-theme-next themes/next

等待下载完成。

在 Hexo 中有两份主要的配置文件，其名称都是 _config.yml 。其中，一份位于站点根目录下，主要包含 Hexo 本身的配置；另一份位于主题目录下，这份配置由主题作者提供，主要用于配置主题相关的选项。我们约定，将前者称为站点配置文件，后者称为主题配置文件

启用 NexT 主题

打开站点配置文件，找到 theme 字段，并将其值更改为 next 。
到此， NexT 主题安装完成。下一步我们将验证主题是否正确启用。在切换主题之后、验证之前，我们最好使用 hexo clean 来清除 Hexo 的缓存。

验证主题

首先启动 Hexo 本地站点，并开启调试模式（即加上 --debug），整个命令是 hexo s --debug。在服务启动的过程，注意观察命令行输出是否有任何异常信息。当命令行输出中提示：

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

此时即可使用浏览器访问 http://localhost:4000/ ，检查站点是否正确运行。

当你看到站点的外观与下图所示类似时即说明你已成功安装 NexT 主题。这是 NexT 默认的 Scheme —— Muse

![hexo-next-one-2](/images/hexo-next-one-2.png) 现在，我们已经成功安装并启用了 NexT 主题。

关于更多基本操作和基础知识，请查阅 [Hexo](https://hexo.io/zh-cn/) 与 [NexT](http://theme-next.iissnan.com/) 官方文档.

总结

本地调试步骤

三部曲：

1
2
3

$ hexo clean
$ hexo g
$ hexo s --debug

这种带 debug 的运行，如果出现错误，可以在命令行中看到错误提示信息。

部署步骤

三部曲：

1
2
3

$ hexo clean
$ hexo g
$ hexo d

当然在部署之前，需要先配置好配置文件中的 deploy。

常用命令

$ hexo new "postName"  #新建文章
$ hexo new page "pageName" # 新建页面
$ hexo generate # 生成静态页面至public目录
$ hexo server # 开启预览访问端口(默认端口4000，'ctrl+c'关闭server)
$ hexo deploy # 项目部署
$ hexo help # 查看帮助
$ hexo version # 查看Hexo的版本

简写命令

$ hexo new == hexo n
$ hexo generate == hexo g
$ hexo server == hexo s
$ hexo deploy == hexo d

常见问题1

在 hexo 的配置和设置文件中，在冒号后面没留空格会导致出问题：
错误的设置：

1
2
3

author:Neveryu
email:react.dong.yu@gmail.com
language:zh-CN

正确的设置：

1
2
3

author: Neveryu
email: react.dong.yu@gmail.com
language: zh-CN

常见问题2

关于 Git 提交中用户名和 Email 的设置

1 2	git config --global user.name "Your name" git config --global user.email "Your email"

常见问题3

Hexo 中的图标使用的是 Font Awesome ，所以，我们的博客已经自带了 Font Awesome 中的所有图标，基本可以满足我们的所有需求，我们可以去 Font Awesome 中查找我们想要使用的图标。

最后要说的是：

[博客源码](https://github.com/Neveryu/Neveryu.github.io) ，欢迎 star

Hexo-NexT搭建个人博客（一）

简介

超快速度

支持Markdown

一键部署

丰富的插件

安装