Hexo 基本操作

写作

您可以执行下列命令来创建一篇新文章。

1	$ hexo new [layout] <title>

您可以在命令中指定文章的布局(layout)，默认为post，可以通过修改_config.yml中的default_layout参数来指定默认布局。

布局(layout)

Hexo有三种默认布局：post、page和draft，它们分别对应不同的路径，而您自定义的其他布局和post相同，都将存储到source/_posts文件夹。

布局	路径
post	source/_posts
page	source
draft	source/_drafts

不要处理我的文章
如果你不想你的文章被处理，你可以将Front-Matter中的layout:设为false。

文件名称

Hexo默认以标题作为文件名称，但您可编辑new_post_name参数来改变默认的文件名称，举例来说，设为:year-:month-:day-:title.md可让您更方便的通过日期来管理文章。

变量	描述
`:title`	标题（小写，空格将会被替换为短杠）
`:year`	建立的年份，比如，`2015`
`:month`	建立的月份（有前导零），比如，`04`
`:i_month`	建立的月份（无前导零），比如，`4`
`:day`	建立的日期（有前导零），比如，`07`
`:i_day`	建立的日期（无前导零），比如，`7`

草稿

刚刚提到了 Hexo 的一种特殊布局：draft，这种布局在建立时会被保存到 source/_drafts 文件夹，您可通过 publish 命令将草稿移动到 source/_posts 文件夹，该命令的使用方式与 new 十分类似，您也可在命令中指定 layout 来指定布局。

1	$ hexo publish [layout] <title>

草稿默认不会显示在页面中，您可在执行时加上 --draft 参数，或是把 render_drafts 参数设为 true 来预览草稿。

模板(Scaffold)

在新建文章时，Hexo 会根据 scaffolds 文件夹内相对应的文件来建立文件，例如：

1	$ hexo new photo "My Gallery"

在执行这行指令时，Hexo 会尝试在 scaffolds 文件夹中寻找photo.md，并根据其内容建立文章，以下是您可以在模版中使用的变量：

变量	描述
`layout`	布局
`title`	标题
`date`	文件建立日期

Front-matter

Front-matter 是文件最上方以---分隔的区域，用于指定个别文件的变量，举例来说：

1
2
3

title: Hello World
date: 2013/7/13 20:46:25
---

以下是预先定义的参数，您可在模板中使用这些参数值并加以利用。

参数	描述	默认值
layout	布局
title	标题
date	建立日期	文件建立日期
updated	更新日期	文件更新日期
comments	开启文章的评论功能	true
tags	标签（不适用于页面(pages)）
categories	分类（不适用于页面(pages)）
permalink	覆盖文章默认的永久链接

分类和标签

只有文章支持分类和标签，您可以在 Front-matter 中设置。在其他系统中，分类和标签听起来很接近，但是在 Hexo 中两者有着明显的差别：分类具有顺序性和层次性，也就是说 Foo, Bar 不等于 Bar, Foo；而标签没有顺序和层次。

categories:
- Sports
- Baseball
tags:
- Injury
- Fight
- Shocking

JSON Front-matter

除了 YAML 外，你也可以使用 JSON 来编写 Front-matter，只要将 --- 代换成 ;;; 即可。

1
2
3

"title": "Hello World",
"date": "2013/7/13 20:46:25"
;;;