升级 Eleventy (11ty) 历来都是比较简单的更新。最近，11ty版本v3.0发布了，这就是运行时引擎，可以说是静态站点生成器。
与其他 npm 软件包不同，11ty 在从一个版本升级到另一个版本时有一个升级帮助器插件。这会检查构建过程，并确保您的配置、构建过程、结构正确反映 11ty 将如何构建您的网站。
它根据您如何构建要使用生成器构建的网站结构来查找警告或错误。这确实很有帮助，因为某些内置功能可能已分解为自己的插件，以更好地扩展流程。
我不知道为什么我花了这么长时间才进行升级，因为升级插件非常有帮助。老实说，有些是 ESM 与 CommonJS 模式、模型，我很困惑。一旦我开始工作，我就可以出发了。
要测试升级过程，最好创建一个升级分支来确认如何升级项目，然后将其合并回主分支，或者如果足够简单，则重做更新。
如何升级
Eleventy 文档很棒，是我寻找某些问题答案的第一个地方。
- 升级十一
- 安装助手插件
- 添加到配置文件
- 运行你的构建
- 删除插件
检查错误
这是我觉得最需要帮助的部分。如前所述，我使用 Node，但也不是 Node JavaScript 开发人员。我确实发现了许多有益的用例，可以使流程变得更容易，并且我应该花更多的时间来学习和理解我正在使用的开发引擎。
不过，许多错误或警告都提供了如何解决帮助程序插件在构建网站时发现的问题的示例。
对我来说，我无法解决的一个问题是EleventyRenderPlugin的问题。错误不断提到以这种方式导入插件，如果是 CommonJS 或 ESM，请执行此操作…我检查了我的配置和代码，并意识到我根本没有使用该模块。我删除了该插件并测试了该网站是否能够按照我的预期成功构建。由于我使用的是Excellent Eleventy入门网站，所以一开始我不确定是否需要这样做。
成功
查看所有警告或错误后，请记住从依赖项、package.json 和 Eleventy 配置文件中删除该插件。这有助于确保升级不会发生重大更改，并帮助您解决任何问题（如果有）。
现在这个网站使用的是Eleventy v3.0 ！
通过电子邮件回复
原文： https://claytonerrington.com/blog/upgrading-eleventy/?utm_source=rss