9月 13 2014

hexo使用指南（一）

hexo is a fast, simple and poweful blog framework.

简介

它可以用来极快的生成有着自定义主题的静态文件，它支持解析Markdown等几种格式的文件。

下面通过搭建一个简单、漂亮的个人博客并部署到github来介绍hexo(2.8.3)的使用。

安装

1. 安装Node.js
2. 安装git
3. 使用npm全局安装hexo：

$ npm install -g hexo

1. 生成project并安装依赖，其中name是你自定义的project名字：

$ hexo init name
$ cd name
$ npm install

project目录结构介绍

目录结构如下：

.
|- _config.yml
|- package.json
|- scaffolds
|- source
|- themes

1. 配置文件_config.yml

1.1 Site

配置	说明
title	网站名称
subtitle	网站子名称
description	网站说明
author	作者
email	email地址
language	网站使用的语言，比如中文是zh-CN

1.2 Deploy

配置	说明
type	部署类型，比如github
repo	repository地址，repository名为your_name.github.io
branch	branch名，默认为repository默认branch

1.3 其他

还有URL、Directory、Writing、Category & Tag、Archives、Server、Date / Time format、Pagination、Disqus、Extensions等配置信息，起始阶段暂时只需要自定义以上详细介绍的部分。

文章

1. 新建草稿，title为新文章的标题（将用来作为url的一部分，建议使用英文）：

$ hexo new draft "title"

1. 打开生成的文件，编辑（格式默认为Markdown）好后保存。

2. 如果在编辑过程中希望可以在浏览器看到效果，可以使用以下命令：

$ hexo server --drafts

或者修改_config.yml中的配置：

render_drafts: true

1. 发布文章，title为文章文件名：

$ hexo publish "title"

1. 也可以直接编辑直接发布的文章：

$ hexo new "title"

1. 生成静态文件：

$ hexo generate

Option	Description
-d, --deploy	在静态文件生成后自动部署
-w, --watch	查看修改的信息

1. 在本机启动blog：

$ hexo server

Option	Description
-p, --port	指定启动时的端口号，默认为_config.yml指定的port
-s, --static	只处理静态文件
-l, --log	启用logger
-d, --drafts	同时将草稿像已发布文章一样处理

1. 部署到服务器：

$ hexo deploy

1. projct会自动提交到github并自动部署，稍等几分钟，你就可以在github上看到你发布的blog了，地址是你的repository名。

hexo