# 新建文章
hexo n

# 清除缓存
hexo clean

# 生成静态页面+部署
hexo d -g        # 等同:hexo g && hexo d
# 生成静态网页
hexo g
# 部署
hexo d

# 启动服务器预览
hexo s

建站

# 安装hexo
npm install hexo -g

# 升级hexo
npm update hexo -g

# hexo初始化
hexo init


# 查看node.js版本号
node -v
# 查看npm版本号
npm -v
# 查看git版本号
git --version
# 查看hexo版本号
hexo -v

插件安装和卸载

# 安装插件
npm install hexo-xxx-xxx --save

# 卸载插件
npm uninstall hexo-xxx-xxx --save

指令

简写

指令 简写 描述
hexo new hexo n 新建文章
hexo generate hexo g 生成静态文件
hexo deploy hexo d 部署
hexo server hexo s 启动服务预览
hexo publish hexo p 发表草稿

注: hexo clean 没有简写, git --version 没有简写

init

# 新建一个网站
$ hexo init [folder]

如果没有设置folder,Hexo默认在当前文件夹建立网站

new

# 新建一篇文章,文章名称和标题为 [title],文章采用 [layout] 布局
$ hexo new [layout] <title>

会在目录source/_posts下生成 [title].md 文件,[title].md文件的顶部会使用---分割区域,也称作Front matter
如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替(一般默认是post)。
如果标题包含空格的话,请使用引号括起来。

# eg
$ hexo new "post title with whitespace"

generate

# 生成静态文件
$ hexo generate
$ hexo g
选项 描述
-d, --deploy 文件生成后立即部署网站
-w, --watch 监视文件变动

执行 $ hexo g后会在站点根目录下生成public文件夹, hexo会将/blog/source/下面的.md后缀的文件编译为.html后缀的文件,存放在/blog/public/路径下

publish

# 发表草稿
$ hexo publish [layout] <filename>

hexo publish [layout] <title> 通过 publish 命令将草稿移动到 source/_posts 文件夹
如:$ hexo publish [layout] <title>,草稿默认是不会显示在页面中的,可在执行时加上 --draft 参数,或是把 render_drafts 参数设为 true来预览草稿。

server

# 启动服务器(常用于调试)
$ hexo server
$ hexo s

默认情况下,访问网址为: http://localhost:4000/。Hexo 会监视文件变动并自动更新,除修改站点配置文件外,无须重启服务器,直接刷新网页即可生效。

选项 描述 eg
-p, --port 重设端口 hexo s -p 5000
-s, --static 只使用静态文件
-l, --log 启动日记记录,使用覆盖记录格式
-i 自定义IP hexo s -i 192.168.1.1

deploy

# 部署网站,将本地数据部署到远端服务器(如github、coding)
$ hexo deploy
$ hexo d
参数 描述
-g, --generate 部署之前预先生成静态文件

render

# 渲染文件
$ hexo render <file1> [file2] ...
参数 描述
-o, --output 设置输出路径

migrate

$ hexo migrate <type>

从其他博客系统 迁移内容

clean

# 清除缓存,网页正常情况下可以忽略此条命令,执行该指令后,会删掉站点根目录下的public文件夹
$ hexo clean

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

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

list

# 列出网站资料
$ hexo list <type>

version

# 显示 Hexo 版本
$ hexo version

选项

安全模式

$ hexo --safe

在安全模式下,不会载入插件和脚本。当您在安装新插件遭遇问题时,可以尝试以安全模式重新执行。

调试模式

$ hexo --debug

在终端中显示调试信息并记录到 debug.log。当您碰到问题时,可以尝试用调试模式重新执行一次,并 提交调试信息到 GitHub

简洁模式

$ hexo --silent

隐藏终端信息。

自定义配置文件的路径

$ hexo --config custom.yml

自定义配置文件的路径,执行后将不再使用 _config.yml

显示草稿

$ hexo --draft

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

自定义 CWD

$ hexo --cwd /path/to/cwd

自定义当前工作目录(Current working directory)的路径。

参考


YOLO