常用命令详解

Hexo 框架可以帮助我们快速创建一个属于自己的博客网站,熟悉 Hexo 框架提供的命令有利于我们管理博客

1、hexo init
hexo init 命令用于初始化本地文件夹为网站的根目录

$ hexo init [folder]
folder 可选参数,用以指定初始化目录的路径,若无指定则默认为当前目录
2、hexo new
hexo new 命令用于新建文章,一般可以简写为 hexo n

$ hexo new [layout] <title>
layout 可选参数,用以指定文章类型,若无指定则默认由配置文件中的 default_layout 选项决定

title 必填参数,用以指定文章标题,如果参数值中含有空格,则需要使用双引号包围

3、hexo generate
hexo generate 命令用于生成静态文件,一般可以简写为 hexo g

$ hexo generate
-d 选项,指定生成后部署,与 hexo d -g 等价
详细信息请参考:https://hexo.io/docs/generating

4、hexo server
hexo server 命令用于启动本地服务器,一般可以简写为 hexo s

$ hexo server
-p 选项,指定服务器端口,默认为 4000

-i 选项,指定服务器 IP 地址,默认为 0.0.0.0

-s 选项,静态模式 ,仅提供 public 文件夹中的文件并禁用文件监视

说明 :运行服务器前需要安装 hexo-server 插件

$ npm install hexo-server --save
详细信息请参考:https://hexo.io/docs/server.html

5、hexo deploy
hexo deploy 命令用于部署网站,一般可以简写为 hexo d

$ hexo deploy
-g 选项,指定生成后部署,与 hexo g -d 等价
说明 :部署前需要修改 _config.yml 配置文件,下面以 git 为例进行说明

deploy:

type: git
repo: <repository url>
branch:    master
message: 自定义提交消息,默认为Site updated: {{ now('YYYY-MM-DD HH:mm:ss') }}

详细信息请参考:https://hexo.io/docs/deployment.html

6、hexo clean
hexo clean 命令用于清理缓存文件,是一个比较常用的命令

$ hexo clean
网站显示异常时可尝试此操作

7、Option
(1)hexo --safe
hexo --safe 表示安全模式,用于禁用加载插件和脚本

$ hexo --safe
安装新插件时遇到问题可尝试此操作

(2)hexo --debug
hexo --debug 表示调试模式,用于将消息详细记录到终端和 debug.log 文件

$ hexo --debug
(3)hexo --silent
hexo --silent 表示静默模式,用于静默输出到终端

$ hexo --silent

指令大全
init
$ hexo init [folder]
新建一个网站。如果没有设置 folder ,Hexo 默认在目前的文件夹建立网站。

This command is a shortcut that runs the following steps:

Git clone hexo-starter including hexo-theme-landscape into the current directory or a target folder if specified.
Install dependencies using a package manager: Yarn 1, pnpm or npm, whichever is installed; if there are more than one installed, the priority is as listed. npm is bundled with Node.js by default.
new
$ hexo new [layout] <title>
新建一篇文章。如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话,请使用引号括起来。

$ hexo new "post title with whitespace"
参数 描述
-p, --path 自定义新文章的路径
-r, --replace 如果存在同名文章,将其替换
-s, --slug 文章的 Slug,作为新文章的文件名和发布后的 URL
默认情况下,Hexo 会使用文章的标题来决定文章文件的路径。对于独立页面来说,Hexo 会创建一个以标题为名字的目录,并在目录中放置一个 index.md 文件。你可以使用 --path 参数来覆盖上述行为、自行决定文件的目录:

hexo new page --path about/me "About me"
以上命令会创建一个 source/about/me.md 文件,同时 Front Matter 中的 title 为 "About me"

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

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

generate
$ hexo generate
生成静态文件。

选项 描述
-d, --deploy 文件生成后立即部署网站
-w, --watch 监视文件变动
-b, --bail 生成过程中如果发生任何未处理的异常则抛出异常
-f, --force 强制重新生成文件
Hexo 引入了差分机制,如果 public 目录存在,那么 hexo g 只会重新生成改动的文件。
使用该参数的效果接近 hexo clean && hexo generate
-c, --concurrency 最大同时生成文件的数量,默认无限制
该命令可以简写为

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

server
$ hexo server
启动服务器。默认情况下,访问网址为: http://localhost:4000/。

选项 描述
-p, --port 重设端口
-s, --static 只使用静态文件
-l, --log 启动日记记录,使用覆盖记录格式
deploy
$ hexo deploy
部署网站。

参数 描述
-g, --generate 部署之前预先生成静态文件
该命令可以简写为:

$ hexo d
render
$ hexo render <file1> [file2] ...
渲染文件。

参数 描述
-o, --output 设置输出路径
migrate
$ hexo migrate <type>
从其他博客系统 迁移内容。

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

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

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

version
$ hexo version
显示 Hexo 版本。

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

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

简洁模式
$ hexo --silent
隐藏终端信息。

自定义配置文件的路径

使用 custom.yml 代替默认的 _config.yml

$ hexo server --config custom.yml

使用 custom.yml 和 custom2.json,其中 custom2.json 优先级更高

$ hexo generate --config custom.yml,custom2.json,custom3.yml
自定义配置文件的路径,指定这个参数后将不再使用默认的 _config.yml。
你可以使用一个 YAML 或 JSON 文件的路径,也可以使用逗号分隔(无空格)的多个 YAML 或 JSON 文件的路径。例如:

使用 custom.yml 代替默认的 _config.yml

$ hexo server --config custom.yml

使用 custom.yml, custom2.json 和 custom3.yml,其中 custom3.yml 优先级最高,其次是 custom2.json

$ hexo generate --config custom.yml,custom2.json,custom3.yml
当你指定了多个配置文件以后,Hexo 会按顺序将这部分配置文件合并成一个 _multiconfig.yml。如果遇到重复的配置,排在后面的文件的配置会覆盖排在前面的文件的配置。这个原则适用于任意数量、任意深度的 YAML 和 JSON 文件。

显示草稿
$ hexo --draft
显示 source/_drafts 文件夹中的草稿文章。

自定义 CWD
$ hexo --cwd /path/to/cwd
自定义当前工作目录(Current working directory)的路径。

Last modification:February 25th, 2021 at 08:20 am
如果觉得我的文章对你有用,请随意投币