本文会对hexo一些常用的命令进行详细说明
主要参考 hexo官方文档
init
1 | $ hexo init [folder] |
新建一个网站。如果没有设置 folder ，Hexo 默认在目前的文件夹建立网站
new
1 | $ hexo new [layout] <title> |
新建一篇文章。如果没有设置 layout 的话，默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话，请使用引号括起来
1 | $ hexo new "post title with whitespace" |
| 参数 | 描述 |
|---|---|
-p, --path |
自定义新文章的路径 |
-r, --replace |
如果存在同名文章，将其替换 |
-s, --slug |
文章的 Slug，作为新文章的文件名和发布后的 URL |
默认情况下，Hexo 会使用文章的标题来决定文章文件的路径。对于独立页面来说，Hexo 会创建一个以标题为名字的目录，并在目录中放置一个 index.md 文件。你可以使用 --path 参数来覆盖上述行为、自行决定文件的目录
1 | hexo new page --path about/me "About me" |
以上命令会创建一个 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
generate
1 | $ hexo generate |
生成静态文件。
| 选项 | 描述 |
|---|---|
-d, --deploy |
文件生成后立即部署网站 |
-w, --watch |
监视文件变动 |
-b, --bail |
生成过程中如果发生任何未处理的异常则抛出异常 |
-f, --force |
强制重新生成文件 Hexo 引入了差分机制，如果 public 目录存在，那么 hexo g 只会重新生成改动的文件。 使用该参数的效果接近 hexo clean && hexo generate |
-c, --concurrency |
最大同时生成文件的数量，默认无限制 |
该命令可以简写为
1 | $ hexo g |
publish
1 | $ hexo publish [layout] <filename> |
发表草稿
server
1 | $ hexo server |
启动服务器。默认情况下，访问网址为： http://localhost:4000/
| 选项 | 描述 |
|---|---|
-p, --port |
重设端口 |
-s, --static |
只使用静态文件 |
-l, --log |
启动日记记录，使用覆盖记录格式 |
deploy
1 | $ hexo deploy |
部署网站。
| 参数 | 描述 |
|---|---|
-g, --generate |
部署之前预先生成静态文件 |
render
1 | $ hexo render <file1> [file2] ... |
渲染文件。
| 参数 | 描述 |
|---|---|
-o, --output |
设置输出路径 |
clean
1 | $ hexo clean |
清除缓存文件 (db.json) 和已生成的静态文件 (public)
在某些情况（尤其是更换主题后），如果发现您对站点的更改无论如何也不生效，您可能需要运行该命令
list
1 | $ hexo list <type> |
列出网站资料
version
1 | $ hexo version |
显示 Hexo 版本
显示草稿
1 | $ hexo --draft |
显示 source/_drafts 文件夹中的草稿文章
自定义 CWD
1 | $ hexo --cwd /path/to/cwd |
自定义当前工作目录（Current working directory）的路径