弃用

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

1. 不要再使用事物一了。
2. 请改用事物二。
3. 我们将在未来的某个时间点移除事物一。

常见的弃用原因：

• 一个特性已被更强大的替代方案取代。
• 一个特性包含设计缺陷。
• 一个特性被认为是多余的，为了简化整个系统，将来将会被移除。
• 软件的未来版本将进行重大的结构性更改，使得支持旧特性变得不可能或不切实际。
• 标准化或命名的一致性提高。
• 曾经仅独立提供的特性现在与其配套特性组合在一起。

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

1. 记录 INFO 消息 6 个次要版本¹（例如，v0.1.1 => v0.2.0 是次要版本）。
2. 记录 WARN 消息另外 6 个次要版本
3. 记录 ERROR 消息并在之后构建失败

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

hugo --logLevel info

要将输出限制为弃用通知：

hugo --logLevel info | grep deprecate

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