OS X 使用 Hexo 和 Coding Pages 搭建静态

Hexo是一款基于 Node.js 的静态博客框架, 目前在 GitHub 上已有 9133 star 和 1499 fork。Hexo 生成的静态页面可以部署在 Github 或 Coding 上，并且能够免费绑定自己的域名，可以用来很方便地搭建个人博客。

---

一、安装 Git

搭建博客需要用到 git，下面这条命令可查看本机是否已安装 git，若未安装可参考这篇博文进行安装。

git --version

二、安装 Node.js

安装 Node.js 的最佳方式是使用 nvm。

cURL:

$ curl https://raw.github.com/creationix/nvm/v0.33.11/install.sh | sh

Wget:

$ wget -qO- https://raw.github.com/creationix/nvm/v0.33.11/install.sh | sh

安装完成后，重启终端并执行下列命令即可安装 Node.js。

$ nvm install stable

或者您也可以下载 安装程序 来安装。

三、安装 Hexo

所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。

$ npm install -g hexo-cli

以上安装配置如有问题请参考官方文档

四、本地建立博客

安装完成后，新建一个目录如 blog 用于存放博客，切换到该目录下执行以下指令，Hexo 即会在目标文件夹初步生成博客所需要的所有文件

hexo init

然后切换到该目录下执行如下命令，安装所需要的依赖

sudo npm install

生成静态页面

hexo g

启动本地服务

hexo s

生成静态页面与启动本地服务可以结合成以下指令

hexo s -g

打开浏览器，输入 http://localhost:4000/ ，看到页面说明hexo环境安装成功。

四、NexT主题配置

• 安装
  将它的 Git 仓库 Clone 以后放到博客目录下的 themes 文件夹中即可

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

• 启用
  与所有Hexo主题一样，把主题源码导入themes目录后，打开根目录配置文件_config.yml， 找到 theme 字段，并将其值更改为 next 就完成了主题的切换。

theme: next

四、部署到Coding Pages

在 Coding 新建一个项目，假设为 blog，然后修改本地博客目录下的 _config.yml 文件，根据官方文档的描述，修改以下几个参数，这些参数一般在文件底部：

deploy:
type: git               #部署方式，这里我们用的是Coding的Git
repo: <repository url>  #仓库地址，例如我的是git@git.coding.net:xxx/blog.git 
branch: [branch]        #分支名，可任意填写，我填写的是master
message: [message]      #可不填，这是显示在提交记录里的描述信息，默认为日期

参数修改完成后，我们需要在终端中切换到博客所在目录安装 deploy 组建，执行以下命令将生成的博客静态页面 push 到我们上面在 Coding 创建的 blog 仓库中：

sudo npm install hexo-deployer-git --save

然后执行依次执行清理命令

hexo clean

生成命令：

hexo g

部署命令：

hexo d

如果在 _config.yml 的 repo 处填写的仓库地址是 https 形式的，在部署时可能需要输入你的 Coding 账号和密码。
然后切换到该项目的 Pages 标签，开启 pages 服务，分支名填写为我们在_config.yml 文件中设定的分支，我的是 master。

五、效果预览

pages 服务开启完成后，Coding 会提供一个类似 {user_name}.coding.me/{project_name} 的链接用于访问，例如用户名为 xxx 项目名为 blog 的链接应该是：

http://xxx.coding.me/blog

若资源加载失败，主题没有显示出来，查看根目录配置文件_config.yml

url: http://xxx.coding.me/blog/ #项目地址
root: /blog #项目名称

六、绑定域名

默认提供的链接可能过长或者不便于日常使用，我们也可以绑定自己的域名。首先，需要提前准备一个域名，然后打开自己的域名控制面板，新建一个 CNAME 解析到 {user_name}.coding.me，例如我的是将 www.xxx.com 解析到 xxx.coding.me； 然后，打开 Coding 项目页面切换到 pages 项，填入刚才的设置解析的域名 www.xxx.com，点击“添加域名绑定”按钮即可，在浏览器中直接访问 www.xxx.com 就能成功打开。 有时可能由于缓存或者解析时间的问题，稍等片刻即可。

七、撰写博客

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

• 使用命令直接创建一篇文章

hexo new "Hello Word"

成功后我们会在source文件夹下的_posts文件夹中找到我们刚刚创建的文件Hello Word.md，编写格式为markdown, 打开文件即可直接编写

• 手动在_posts文件夹下创建*.md文件的博客，但是我们自己要把头信息给补上

部署博客

hexo d -g

持续更新中...