CNB
EO命令行使用
先决条件
- W3C技术联盟 在终端应用程序中运行。等等，什么是终端？
- 您是否已经安装了 W3C技术联盟？
这是您可以在终端应用程序中输入的第一个命令来运行 W3C技术联盟：
# 搜索当前目录，输出到 ./\_site
npx @11ty/eleventy
# `npx @11ty/eleventy` 等同于：
npx @11ty/eleventy --input=. --output=\_site# 搜索当前目录，输出到 ./\_site
pnpm exec eleventy
# `pnpm exec eleventy` 等同于：
pnpm exec eleventy --input=. --output=\_site# 搜索当前目录，输出到 ./\_site
yarn exec eleventy
# `yarn exec eleventy` 等同于：
yarn exec eleventy --input=. --output=\_site当前目录中的一个假设的 template.md 文件将被渲染为 _site/template/index.html。在 永久链接 中阅读更多信息。
# 仅使用模板类型的子集
npx @11ty/eleventy --formats=md,html,ejs
# 不处理任何格式
npx @11ty/eleventy --formats=
# 查找最新的命令列表（还有更多）
npx @11ty/eleventy --help# 仅使用模板类型的子集
pnpm exec eleventy --formats=md,html,ejs
# 不处理任何格式
pnpm exec eleventy --formats=
# 查找最新的命令列表（还有更多）
pnpm exec eleventy --help# 仅使用模板类型的子集
yarn exec eleventy --formats=md,html,ejs
# 不处理任何格式
yarn exec eleventy --formats=
# 查找最新的命令列表（还有更多）
yarn exec eleventy --help--formats=的默认值在 3.0.0 版本中从*的别名更改为空集合。
保存时重新运行 Eleventy
# 添加 Web 服务器以应用更改并
# 自动刷新。我们也会为您 --watch。
npx @11ty/eleventy --serve
# 更改 Web 服务器的端口—使用 localhost:8081
npx @11ty/eleventy --serve --port=8081
# 监视文件更改并重新运行，不使用 Web 服务器。
npx @11ty/eleventy --watch# 添加 Web 服务器以应用更改并
# 自动刷新。我们也会为您 --watch。
pnpm exec eleventy --serve
# 更改 Web 服务器的端口—使用 localhost:8081
pnpm exec eleventy --serve --port=8081
# 监视文件更改并重新运行，不使用 Web 服务器。
pnpm exec eleventy --watch# 添加 Web 服务器以应用更改并
# 自动刷新。我们也会为您 --watch。
yarn exec eleventy --serve
# 更改 Web 服务器的端口—使用 localhost:8081
yarn exec eleventy --serve --port=8081
# 监视文件更改并重新运行，不使用 Web 服务器。
yarn exec eleventy --watch如果输出太嘈杂，使用 --quiet
# 嘘—不要向控制台记录太多内容
npx @11ty/eleventy --quiet# 嘘—不要向控制台记录太多内容
pnpm exec eleventy --quiet# 嘘—不要向控制台记录太多内容
yarn exec eleventy --quiet使用 --dryrun 进行一些测试
在不写入文件系统的情况下运行。在调试时很有用。
# 运行 Eleventy 但不写入任何文件
npx @11ty/eleventy --dryrun# 运行 Eleventy 但不写入任何文件
pnpm exec eleventy --dryrun# 运行 Eleventy 但不写入任何文件
yarn exec eleventy --dryrun--config 更改配置文件名
# 覆盖默认的 Eleventy 项目配置文件名 (.eleventy.js)
npx @11ty/eleventy --config=myeleventyconfig.js# 覆盖默认的 Eleventy 项目配置文件名 (.eleventy.js)
pnpm exec eleventy --config=myeleventyconfig.js# 覆盖默认的 Eleventy 项目配置文件名 (.eleventy.js)
yarn exec eleventy --config=myeleventyconfig.js阅读更多关于配置文件的信息。
(vv3.0.0-alpha.18)如果您指定的 --config 文件不存在，Eleventy 将抛出错误。
--to 可以输出 JSON (v1.0.0)
# 输出 JSON 结构（不写入文件系统）
npx @11ty/eleventy --to=json
# 输出换行分隔的 JSON 结构（不写入文件系统）
npx @11ty/eleventy --to=ndjson
# 默认行为（输出到文件系统）
npx @11ty/eleventy --to=fs# 输出 JSON 结构（不写入文件系统）
pnpm exec eleventy --to=json
# 输出换行分隔的 JSON 结构（不写入文件系统）
pnpm exec eleventy --to=ndjson
# 默认行为（输出到文件系统）
pnpm exec eleventy --to=fs# 输出 JSON 结构（不写入文件系统）
yarn exec eleventy --to=json
# 输出换行分隔的 JSON 结构（不写入文件系统）
yarn exec eleventy --to=ndjson
# 默认行为（输出到文件系统）
yarn exec eleventy --to=fs阅读更多关于 ndjson 的信息。
--incremental 用于部分增量构建
# *重复*构建仅对已更改的文件进行操作
npx @11ty/eleventy --watch --incremental
npx @11ty/eleventy --serve --incremental
# 使用 `--ignore-initial` 跳过初始完整构建
npx @11ty/eleventy --serve --incremental --ignore-initial
# 传入模板路径，不需要监视/服务
# 在 3.0.0 中添加
npx @11ty/eleventy --incremental=myfile.md# *重复*构建仅对已更改的文件进行操作
pnpm exec eleventy --watch --incremental
pnpm exec eleventy --serve --incremental
# 使用 `--ignore-initial` 跳过初始完整构建
pnpm exec eleventy --serve --incremental --ignore-initial
# 传入模板路径，不需要监视/服务
# 在 3.0.0 中添加
pnpm exec eleventy --incremental=myfile.md# *重复*构建仅对已更改的文件进行操作
yarn exec eleventy --watch --incremental
yarn exec eleventy --serve --incremental
# 使用 `--ignore-initial` 跳过初始完整构建
yarn exec eleventy --serve --incremental --ignore-initial
# 传入模板路径，不需要监视/服务
# 在 3.0.0 中添加
yarn exec eleventy --incremental=myfile.md阅读更多关于增量构建的信息。相关 GitHub #3324
--ignore-initial 在没有初始构建的情况下运行 Eleventy (v2.0.0-canary.25)
注意 Eleventy 未运行时发生的任何文件更改！
# Eleventy 启动时不构建，仅在文件更改时构建
npx @11ty/eleventy --watch --ignore-initial
npx @11ty/eleventy --serve --ignore-initial
# 与增量构建完美配合
npx @11ty/eleventy --serve --incremental --ignore-initial# Eleventy 启动时不构建，仅在文件更改时构建
pnpm exec eleventy --watch --ignore-initial
pnpm exec eleventy --serve --ignore-initial
# 与增量构建完美配合
pnpm exec eleventy --serve --incremental --ignore-initial# Eleventy 启动时不构建，仅在文件更改时构建
yarn exec eleventy --watch --ignore-initial
yarn exec eleventy --serve --ignore-initial
# 与增量构建完美配合
yarn exec eleventy --serve --incremental --ignore-initial深入了解 Eleventy 内部
您可以使用 DEBUG 环境变量 来启用特殊调试日志输出，允许深入了解 Eleventy 的内部。为简单起见，此示例使用 cross-env 包。
npx cross-env DEBUG=Eleventy:* npx @11ty/eleventy --dryrunpnpm exec cross-env DEBUG=Eleventy:* pnpm exec @11ty/eleventy --dryrunyarn exec cross-env DEBUG=Eleventy:* yarn exec @11ty/eleventy --dryrun了解更多关于 Eleventy 的调试模式日志输出。
使用相同的输入和输出
是的，您可以使用相同的 input 和 output 目录，如下所示：
# 解析 Markdown 并写入 HTML，保持目录结构。
npx @11ty/eleventy --input=. --output=. --formats=md# 解析 Markdown 并写入 HTML，保持目录结构。
pnpm exec eleventy --input=. --output=. --formats=md# 解析 Markdown 并写入 HTML，保持目录结构。
yarn exec eleventy --input=. --output=. --formats=mdWARNING
在这里小心使用
--formats=html！如果您多次运行 Eleventy，我们将尝试将新的输出文件作为输入文件处理（这将抛出错误）。