# 新建文章
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)的路径。