把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 文件夹中的草稿文章。