Quick Start for Hexo

发表于 更新于 分类于 本文字数： 1.6k 阅读时长 ≈ 1 分钟

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

Install

1
2
3
4
$ npm install hexo-cli -g
$ hexo init blog
$ cd blog
$ npm install

Create a new post

1
2
3
$ hexo new "My New Post"
$ hexo new page about
$ hexo new page tags

Create a new draft

1
hexo new draft <title>

上面的命令会建立一篇文章的草稿，放到 source/_draft 中，可以使用 publish 发布到 source/_posts 中。

1
hexo publish <title>

<% note warning %>
这里的title，要和 _draft 中的文件名一直，可能需要把空格变成“-”。
<% endnote %>

Asset 资源文件夹

资源（Asset）代表 source 文件夹中除了文章以外的所有文件，例如图片、CSS、JS 文件等。比方说，如果你的Hexo项目中只有少量图片，那最简单的方法就是将它们放在 source/images 文件夹中。然后通过类似于 ![](/images/image.jpg) 的方法访问它们。

对于那些想要更有规律地提供图片和其他资源以及想要将他们的资源分布在各个文章上的人来说，Hexo也提供了更组织化的方式来管理资源。这个稍微有些复杂但是管理资源非常方便的功能可以通过将 config.yml 文件中的 post_asset_folder 选项设为 true 来打开。

Embedding an image using markdown

hexo-renderer-marked 3.1.0 introduced a new option that allows you to embed an image in markdown without using asset_img tag plugin.

To enable:

1
2
3
4
5
_config.yml
post_asset_folder: true
marked:
  prependRoot: true
  postAsset: true

Once enabled, an asset image will be automatically resolved to its corresponding post’s path. For example, “image.jpg” is located at “/2020/01/02/foo/image.jpg”, meaning it is an asset image of “/2020/01/02/foo/“ post, ![](image.jpg) will be rendered as <img src="/2020/01/02/foo/image.jpg">.

More info: Writing

Run server

1
2
$ hexo server
$ hexo server -p 5000

More info: Server

Generate static files

1
2
$ hexo generate
$ hexo generate --deploy

More info: Generating

Deploy to remote sites

1
$ hexo deploy

More info: Deployment

Add tags and categories

1
2
3
4
tags:
  - Testing
  - Another Tag
categories: Label

More info: Tags