弃用

当一个项目弃用某些东西时，他们是在告诉其用户：

1. 不要再使用 Thing One 了。
2. 改用 Thing Two。
3. 我们将在未来的某个时候删除 Thing One。

常见的弃用原因

• 某个功能已被更强大的替代方案取代。
• 某个功能包含设计缺陷。
• 某个功能被认为是多余的，将来会被删除，以简化整个系统。
• 软件的未来版本将进行重大结构更改，使得支持旧功能变得不可能或不切实际。
• 标准化或命名方面的一致性增强。
• 曾经只能独立使用的功能现在与其共同功能合并。

在项目团队弃用代码中的某些内容后，Hugo 将：

1. 在 6 个次要版本中记录 INFO 消息¹
2. 在另外 6 个次要版本中记录 WARN 消息
3. 在此之后记录 ERROR 消息并使构建失败

要查看 INFO 消息，您必须使用 --logLevel 命令行标志

hugo --logLevel info

要将输出限制为弃用通知

hugo --logLevel info | grep deprecate

每次升级 Hugo 时都运行以上命令。