转自http://www.tuicool.com/articles/Nnuyu2A
这部分Docs分了8块内容，分别从写作、前置声明、标签插件、资源目录、数据文件、服务器、生成器、部署。也许翻译得不得当，但是我尽量把主要内容呈现出来并加上自己的理解。
写作
写作之前当然得先创建一个.md文件，使用命令 hexo new [layout] <title> ，其中layout默认为post，前面提过。
Layout布局
Hexo提供了3种默认的布局， post 、 page 和 draft ，路径分别为： source/_posts 、 source 、 source/_draft 。如果你将在文章前置申明中，将layout设置为false，那么这篇文章将不会有任何的布局。
Filename文件名
Hexo会默认将文章的标题当做文件名，但是你可以编辑 _config.yml 配置文件中的 new_post_name 来改变默认的文件名。
例如：使用 hexo new hello 命令创建一篇为hello文章，Hexo会默认在_posts目录下给你创建一个名为hello.md的文件。假如你将 new_post_name 改为了 :year-:month-:day-:title.md ，那么hexo就自动帮你创建名为2015-05-16-hello.md（当前日期为2015年5月16）
- :title 文章标题
- :year 创建年份
- :month 月份，如4月为 04
- :day 日期
- i_month 月份，单数字，比如4月就是 4
- i_day 日期，单数字
Drafts草稿
Hexo提供草稿功能，在 _drafts 目录下的文章不会发表到网站上，你可以通过命令 hexo publish [layout] <title> 发布你的草稿，改命令会将文章移到 _posts 目录下。但是也可以设置 _config.yml 配置文件的 render_drafts 字段，使草稿默认发布到站点中。
Scaffolds模版
当你使用 new 命令创建一篇文章的时候，Hexo会根据scaffolds目录中的模版帮你生成文章。假如执行 hexo new photo "My Gallery" ，Hexo会尝试在scaffolds目录中去寻找photo.md的模版文件，然后基于它创建标题为My Gallery的文章。
它的用处就是能够在模版中写入你某一类文章都要添加的共同内容，这样你基于模版创建文章的时候，就不用再重复写入那部分内容。
前置申明
顾名思义，就是写在文章前面的一块内容，为了对文章进行某些设置。它有两种书写方式：
YAML方式，以三短线结束
title: Hello World
date: 2013/7/13 20:46:25
---
JSON方式，以三分号结束
"title": "Hello World",
"date": "2013/7/13 20:46:25"
;;;
参数列表
- layout: 布局，一般不用写，默认就行
- title: 标题，这个必须要有
- date: 时间
- updated: 修改时间
- comments: 是否开启评论，默认为true
- tags: 文章标签
- categories: 文章分类
- permalink: 文章永久链接，一般不用写，默认就行
在写标签和分类的时候，可能会有多个的情况，多个标签可以无序排列的方式书写，而分类可能会有多级分类的情况。如何书写举例如下:
categories:
- Sports
- Baseball
tags:
- Injury
- Fight
- Shocking
标签插件
这里说的标签插件不同于文章中的标签，它可以帮助你在文章中快速嵌入一些特殊的内容。
Block Quote-块引用
插入带有作者信息的应用，体现在Html上就是在 blockquote 标签下加入了 footer 标签。但是会给文章带来不一样的显示效果，书写格式非常简单。
{% blockquote [author[, source]] [link] [source_link_title] %}
content
{% endblockquote %}
看下面的例子就大概知道怎么书写了，第一种最简单的方式就等于markdown里的 > 语句。
{% blockquote %}
I love you forever
{% endblockquote %}
{% blockquote pengloo53 http://www.linux2me.com %}
I love you forever 我爱你
{% endblockquote %}
{% blockquote David Levithan, Wide Awake %}
I love you forever
{% endblockquote %}
显示效果为（主题为 light-ch ）：
显示效果
Code Block代码块
在文章中插入代码块可以使用下面方式书写
{% codeblock [title] [lang:language] [url] [link text] %}
code snippet
{% endcodeblock %}
实例如下
code block 实例
显示效果
显示效果
Pull Quote
这个插件可以帮助您在文章中插入重要引述
{% pullquote [class] %}
content
{% endpullquote %}
jsFiddle
在文章中嵌入jsFiddle片段。
{% jsfiddle shorttag [tabs] [skin] [width] [height] %}
Gist
嵌入Gist片段
{% gist gist_id [filename] %}
iFrame
插入网页框架
{% iframe url [width] [height] %}
Image
插入图片，可以自定义大小
{% img [class names] /path/to/image [width] [height] [title text [alt text]] %}
Link
插入带有target="_blank"属性值的链接。
{% link text url [external] [title] %}
Include Code
从资源目录中插入代码片段。
{% include_code [title] [lang:language] path/to/file %}
Youtube
在文章中插入Youtube视频。天朝的孩子就不用试了
{% youtube video_id %}
Vimeo
在文章中插入Vimeo视频。
{% vimeo video_id %}
Include Posts
包含其他文章的链接(这个我测试没有出现效果, 不知道是不是我的写法有问题, 希望有人可以测试一下)。
{% post_path slug %}
{% post_link slug [title] %}
Include Assets
包含文章资源。 (具体怎么使用，还不太明白，希望有人可以测试一下)
{% asset_path slug %}
{% asset_img slug [title] %}
{% asset_link slug [title] %}
Raw
一些内容不想被主题渲染，可以使用该插件呈现原始状态。
{% raw %}
content
{% endraw %}
资源目录
Assets指的是那些不在source目录下的资源，比如图片、CSS文件或者Javascript文件。Hexo提供一种更方便的方法来管理这些资源（Assets）。想使其生效，首先修改 post_asset_folder 字段的设置，将其值改为 true 。
当生效后，在你创建文章的时候，Hexo会创建一个同名目录，你可以将该文章关联的资源全部放到该目录下。这样就可以更加方便的使用它们了。
使用方法就是上面介绍过的标签插件。
{% asset_path slug %}
{% asset_img slug [title] %}
{% asset_link slug [title] %}
数据文件
有时，你可能会使用一些不在post中的模版数据，或者你想复用这些数据，那么你可以试用一下Hexo3中的『Data files』功能。这个特性加载source/_data目录中的YAML或者JSON文件，从而用到你的网站中。
例如，在source/_data目录中添加 menu.yml 文件。内容如下：
Home: /
Gallery: /gallery/
Archives: /archives/
在模版中，你可以这样使用它。
{% for link in site.data.menu %}
<a href="{{ link }}">{{ loop.key }}</a>
{% endfor %}
服务器
Hexo server
在Hexo3中，服务器模块从主模块中分开了，你可以通过安装 hexo-server 来使用它。
npm install hexo-server --save
安装完成后，通过运行命令 hexo server 来启动本地服务。可以通过 http://localhost:4000 或者 http://0.0.0.0:4000 来访问你的网站。服务启动后，Hexo会监视文件的改动情况并且自动更新，也就是说你修改网站内容后不必重启服务器就可以见到效果。
如果你想修改端口，可以通过
hexo server -p 5000
命令来指定端口。
hexo server -s 启动静态模式，在静态模式中，只有public文件夹下的文件才会被放到服务器上，并且文件监听功能关闭。你可以在运行 hexo g 命令后运行该命令，通常用于生产系统中。
hexo server -i 192.168.1.1 指定IP访问，可以替代默认的 0.0.0.0 .
Pow
Pow是Mac上一个零配置的服务架构。通过 curl get.pow.cx | sh 命令下载并安装该软件；然后链接到项目文件夹中，步骤如下：
cd ~/.pow
ln -s /path/to/myapp index
通过上面命令，会在~/.pow目录下创建一个index的链接文件指向你的hexo根目录，然后你就可以通过访问 http://index.dev 就可以看到你的主页了。
生成器
这个很简单， hexo generate 一条命令生成静态站点。可以使用缩写 hexo g ，还可以显示你修改的文件并且重新生成，使用命令 hexo g --watch ，还用两种用法可以跟部署结合起来， hexo g -d or hexo d -g ，指的是生成后马上部署站点。
部署
部署的方式有多种，这里我主要介绍一下Git的方式，因为GitHub提供Pages功能，可以直接将站点部署到Github上。
主要就是设置 _config.yml 配置文件，
deploy:
type: git
repo: 这里是自己的SSH或者Https路径
branch: master
这样就设置好了，注意将repo改成自己的。其他方式类似。部署命令很简单， hexo d 就OK了。
网友评论