安装
如何安装和更新 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 插件 可以安装。