HEXO+GitHub,搭建博客 - 配置

Markdown

本篇文章主要介绍怎样利用 Hexo + NextGitHub 上搭建个人博客。

简介

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

1、 超快速度
Node.js 所带来的超快生成速度,让上百个页面在几秒内瞬间完成渲染。
2、 支持Markdown
Hexo 支持 GitHub Flavored Markdown 的所有功能,甚至可以整合 Octopress 的大多数插件。
3、 一件部署
只需一条指令即可部署到Github Pages,或其他网站
4、 丰富的插件
Hexo 拥有强大的插件系统,安装插件可以让 Hexo 支持 Jade, CoffeeScript。
通过 Hexo 你可以轻松地使用 Markdown 编写文章,除了 Markdown 本身的语法之外,还可以使用 Hexo 提供的 标签插件 来快速的插入特定形式的内容。

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

准备工作

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

Node.js
Git

如果您的电脑中已经安装上述必备程序,跳过这一步。
如果你的电脑中尚未安装所需要的程序,请根据以下安装指示完成安装。

安装 Git

  • Windows:下载安装 git 。 Download Now
  • Mac:使用 HomebrewMacPorts 或下载 安装程序 安装
  • 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。(执行完以后,我们同样可以执行命令 hexo -v 查看是否安装成功就安装成功了。)

1
$ npm install -g hexo-cli

Hexo安装完成后,我们需要为我们的blog项目创建一个 指定文件夹 (例如我在 D 盘根目录下创建了一个文件夹 blog 。D:\blog ),在 该文件夹中 执行以下命令, Hexo 将会在指定文件夹中新建所需要的文件。

1
2
$ hexo init
$ npm install

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

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

继续执行命令

1
2
$ hexo g //编译
$ hexo s --debug //开启本地服务

这个时候,我们在浏览器中访问 http://localhost:4000/ ,就可以看到基于 Hexo 的默认主题的原型:

Markdown

到目前为止我们的本地博客已经部署完成。下面我们换上Next主题。

使用Next

下载 NexT 主题

依旧是在当前目录下,使用 Git checkout 代码:

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

等待下载完成。

启用 NexT 主题

打开 站点配置文件 (Hexo文件夹下的_config.yml文件),找到 theme 字段,并将其值更改为 next
到此, NexT 主题安装完成。下一步我们依次执行以下命令验证主题是否正确启用。

1
2
3
$ hexo clean
$ hexo g
$ hexo s

我们在浏览器中访问 http://localhost:4000/ ,你将看到:
Markdown

总结

本地调试三部曲:

1
2
3
$ hexo clean
$ hexo g
$ hexo s --debug

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