Hexo usages

Welcome to Hexo! This is your very first post. Check documentation for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub.

Quick Start

Create a new post

1
$ hexo new "My New Post"

Create a page named tags

1
$ hexo new page "tags"

More info: Writing

Run server

1
$ hexo server

More info: Server

Generate static files

1
$ hexo generate

More info: Generating

Deploy to remote sites

1
$ hexo deploy

Front-matter

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

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

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

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

分类和标签

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

1
2
3
4
5
categories:
- Diary
tags:
- PS3
- Games

兼容 Hugo 所需要的修改

由于Hugo 似乎只支持字符串字符串数组形式的 Front-matter,如下:

1
2
3
4
5
6
title: "title name"
date: 2018-01-01 12:00:00
comments: true
draft: false
categories: "Diary"
tags: ["PS3","Games"]

所以,为使 Hexo 生成的 .md 文件的通用性更强,需要手动改写(亲测,通过更改scaffolds 文件夹内的模板是无法实现以上格式的,所有必须手动更改)成以上格式的 Front-matter

More info: Deployment