命令

init

$ hexo init [folder]

初始化网站。如果没有提供 `folder`,Hexo 将在当前目录设置一个网站。

此命令是一个快捷方式,它运行以下步骤

  1. Git clone hexo-starter 包括 hexo-theme-landscape 到当前目录,如果指定了目标文件夹,则到目标文件夹。
  2. 使用包管理器安装依赖项: Yarn 1pnpmnpm,根据安装情况选择;如果有多个安装,优先级如上所列。 npm 默认与 Node.js 捆绑在一起。

new

$ hexo new [layout] <title>

创建一个新的文章。如果没有提供 `layout`,Hexo 将使用 _config.yml 中的 `default_layout`。使用布局 `draft` 创建草稿。如果 `title` 包含空格,请用引号将其括起来。

选项 描述
-p, --path 文章路径。自定义文章的路径。
-r, --replace 如果存在,则替换当前文章。
-s, --slug 文章 slug。自定义文章的 URL。

默认情况下,Hexo 将使用标题来定义文件的路径。对于页面,它将创建一个同名目录,并在其中创建一个 `index.md` 文件。使用 `--path` 选项可以覆盖此行为并定义文件路径

hexo new page --path about/me "About me"

将创建 `source/about/me.md` 文件,并在前置内容中设置标题“About me”。

请注意,标题是必填项。例如,这将不会产生您可能期望的行为

hexo new page --path about/me

将创建文章 `source/_posts/about/me.md`,并在前置内容中设置标题“page”。这是因为只有一个参数 ( `page` ),并且默认布局为 `post`。

generate

$ hexo generate

生成静态文件。

选项 描述
-d, --deploy 在生成完成之后部署
-w, --watch 监控文件更改
-b, --bail 如果在生成过程中抛出任何未处理的异常,则引发错误
-f, --force 强制重新生成
-c, --concurrency 最大并行生成的文件数。默认值为无穷大

publish

$ hexo publish [layout] <filename>

发布草稿。

server

$ hexo server

启动本地服务器。默认情况下,它位于 `https://127.0.0.1:4000/`。

选项 描述
-p, --port 覆盖默认端口
-s, --static 只提供静态文件
-l, --log 启用日志记录器。覆盖日志记录器格式。

deploy

$ hexo deploy

部署您的网站。

选项 描述
-g, --generate 在部署之前生成

render

$ hexo render <file1> [file2] ...

渲染文件。

选项 描述
-o, --output 输出目标

migrate

$ hexo migrate <type>

迁移 其他博客系统的内容。

clean

$ hexo clean

清理缓存文件 ( `db.json` ) 和生成的文件 ( `public` )。

list

$ hexo list <type>

列出所有路由。

version

$ hexo version

显示版本信息。

config

$ hexo config [key] [value]

列出配置 ( `_config.yml` )。如果指定了 `key`,则只显示配置中对应 `key` 的值;如果同时指定了 `key` 和 `value`,则将配置中对应 `key` 的值更改为 `value`。

选项

安全模式

$ hexo --safe

禁用加载插件和脚本。如果您在安装新插件后遇到问题,请尝试此方法。

调试模式

$ hexo --debug

将详细消息记录到终端和 `debug.log`。如果您遇到任何 Hexo 问题,请尝试此方法。如果您看到错误,请 在 GitHub 上创建一个问题

静默模式

$ hexo --silent

静默终端输出。

自定义配置文件路径

$ hexo --config custom.yml

使用自定义配置文件(而不是 `_config.yml`)。还接受以逗号分隔的 JSON 或 YAML 配置文件的列表(无空格),这些文件将合并这些文件到单个 `_multiconfig.yml` 中。

$ hexo --config custom.yml,custom2.json

显示草稿

$ hexo --draft

显示草稿文章(存储在 `source/_drafts` 文件夹中)。

自定义 CWD

$ hexo --cwd /path/to/cwd

自定义当前工作目录的路径。