命令行用法

使用 Lume 的命令行界面

在你的电脑上安装 Lume CLI

Lume 使用 Deno tasks 来工作, 所以你只需要输入 deno task lume [...args] 就可以运行任何 lume 命令。

有些人可能会觉得这有点冗长,所以如果你不想一直输入 deno task ...,你可以安装 Lume CLI 脚本,使用命令:

deno install --allow-run --allow-env --allow-read --name lume --force --reload --global https://deno.land/x/lume_cli/mod.ts

这个脚本创建了 lume 命令,包含以下子命令:

  • lume init 运行命令 deno run -A https://lume.land/init.ts 以在当前目录中初始化 Lume。
  • lume upgrade 将 Lume、LumeCMS 和任何已知主题升级到最新版本。
  • lume upgrade-cli 将 Lume CLI 升级到最新版本。
  • 任何其他命令都将委托给 deno task lume [...args]。例如,lume -s 等同于运行 deno task lume -s
  • CLI 命令还有一些有用的快捷方式,例如 --drafts (用于创建 LUME_DRAFTS=true 环境变量) 和 --debug--info--warning--error--critical 来更改 LUME_LOGS 环境变量。

构建站点

运行以下命令来构建你的网站:

deno task lume

# 或者使用 Lume CLI
lume

这个命令会将你的文档编译成 HTML 并保存到目标 目录(通常是 _site)。

Tip

这里有 deno task build 任务作为一个别名。

启动本地服务器

通常你会想在浏览器中打开站点,所以你可以通过添加 --serve (或 -s) 参数来启动本地服务器:

deno task lume --serve

# 或者使用 Lume CLI
lume --serve

Tip

这里有 deno task serve 任务作为一个别名。

这个命令会初始化一个 本地 web 服务器 并开始监听你站点的更改。 所以在你更改任何内容后,Lume 会自动重建站点并使用新的更改自动重新加载你的浏览器。本地服务器默认使用端口 3000,但你可以使用 --port 参数更改它。例如:

deno task lume --serve --port=8000

# 或者使用 Lume CLI
lume --serve --port=8000

要在不启动本地服务器的情况下监听更改,请使用 --watch 参数:

deno task lume --watch

# 或者使用 Lume CLI
lume --watch

帮助

运行 deno task lume -h 以显示所有可用的命令和选项。