Hexo常用命令备忘录

把Hexo常用的命令方法备忘在此。

创建新文章

1
$ hexo new [layout] <title>

新建一篇文章。如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话,请使用引号括起来。

1
$ hexo new "New article"

可简写为

1
$ hexo n "New article"

可用的参数:

-p, –path:自定义新文章的路径。
-r, –replace:如果存在同名文章会将其替换。
-s, –slug:文章的 Slug,作为新文章的文件名和发布后的URL。

默认情况下,Hexo 会使用文章的标题来决定文章文件的路径。对于独立页面来说,Hexo 会创建一个以标题为名字的目录,并在目录中放置一个index.md文件。你可以使用 –path 参数来覆盖上述行为、自行决定文件的目录:

1
$ hexo new page --path about/me "New article"

以上命令会创建一个 source/about/me.md 文件,同时 Front Matter 中的 title 为 “About me”。

注意!title 是必须指定的!如果你这么做并不能达到你的目的:

1
$ hexo new page --path about/me

此时 Hexo 会创建 source/_posts/about/me.md,同时 me.md 的 Front Matter 中的 title 为 “page”。这是因为在上述命令中,hexo-cli 将 page 视为指定文章的标题、并采用默认的 layout。

可以为文章指定一个文件名,并且作为发布后的URL。

1
$ hexo n "New article" -s filename

生成静态文件

1
$ hexo generate

可用的参数:

-d, –deploy:文件生成后立即部署网站。
-w, –watch:监视文件变动。
-b, –bail:生成过程中如果发生任何未处理的异常则抛出异常。
-f, –force:强制重新生成文件。

Hexo 引入了差分机制,如果 public 目录存在,那么 hexo g 只会重新生成改动的文件。使用该参数的效果接近 hexo clean && hexo generate。
-c, –concurrency:最大同时生成文件的数量,默认无限制。

可以简写为

1
$ hexo g

发表草稿

1
$ hexo publish [layout] <filename>

启动服务器

1
$ hexo server

默认情况下,访问网址为: http://localhost:4000/。

可用的参数:

-p, –port:重设端口。
-s, –static:只使用静态文件。
-l, –log:启动日记记录,使用覆盖记录格式。

部署网站

1
$ hexo deploy

可用的参数:

-g, –generate:部署之前预先生成静态文件。

可以简写为:

1
$ hexo d

清除缓存

1
$ hexo clean

清除缓存文件 (db.json) 和已生成的静态文件 (public)。

在某些情况(尤其是更换主题后),如果发现对站点的更改无论如何也不生效,那么运行该命令。

查看网站资料

1
$ hexo list <type>

查看Hexo版本

1
$ hexo version

显示草稿

1
$ hexo --draft

显示 source/_drafts 文件夹中的草稿文章。

参考文献

Hexo官网
Hexo安装
Hexo建站
Hexo配置
Hexo指令