安装

如何安装和更新 Lume

由于 Lume 由 Deno 运行,如果您尚未安装 Deno,请阅读 Deno 安装 说明。

设置 Lume

要在您的项目文件夹中设置 Lume,请运行以下命令:

deno run -A https://lume.land/init.ts

此命令将创建以下文件:

_config.ts
Lume 配置文件, 您可以在其中自定义站点构建。
deno.json
Deno 的配置文件。 它包括 import map 和一些运行 Lume 的任务 (tasks)。您还可以配置 Deno 的其他功能,如 TypeScript、formatter、linter 等。

以下是这两个配置文件的示例:

import lume from "lume/mod.ts";

const site = lume();

export default site;
{
  "tasks": {
    "lume": "echo \"import 'lume/cli.ts'\" | deno run -A -",
    "build": "deno task lume",
    "serve": "deno task lume -s"
  },
  "imports": {
    "lume/": "https://deno.land/x/lume@v2.0.0/"
  },
  "compilerOptions": {
    "types": [
      "lume/types.ts"
    ]
  }
}

现在您可以使用 Deno 的 tasks 在任何环境 (environment) 中运行 Lume。命令 deno task lume 运行 Lume,您可以添加 额外的参数 (arguments)。例如,deno task lume -s 运行 Lume,打开本地 web 服务器并开始监听更改。

build (用于构建网站) 和 serve (用于构建并启动本地 服务器) 任务 (tasks) 只是主 lume 任务 (task) 的快捷方式,带有额外的参数 (arguments)。

运行 deno task lume -h 查看说明。

更新 Lume

任务 (task) deno task lume upgrade 将您的项目文件夹中使用的 Lume 版本升级到最新版本。

使用 --dev 参数 (argument) 可以升级到最新的开发版本 (development version)(Github 仓库 中的最新 commit)。它 对于测试 Lume 尚未发布的新功能很有用。

Vendoring

如果您想将 Deno 的所有远程依赖项 (dependencies) 下载到本地文件夹中,您 可以使用 DENO_DIR 环境变量 (environment variable)。例如,编辑 lume 任务 (task) 以定义此变量:

{
  "tasks": {
    "lume": "echo \"import 'lume/cli.ts'\" | DENO_DIR=_vendor deno run -A -",
    "build": "deno task lume",
    "serve": "deno task lume -s"
  }
}

现在,当您运行任何 Lume 任务 (task) 时,所有 Deno 依赖项 (dependencies) 都将被下载到 _vendor 文件夹中。

Visual Studio Code 配置

如果您使用 Visual Studio Code,强烈建议安装 Deno 扩展

WebStorm 配置

如果您使用 WebStorm 这个 IDE,有一个 Deno 插件 可以安装。