廢棄功能 Deprecation

當一個專案標註為 廢棄 時，他們會告訴使用者：

1. 不要再使用 事物一。
2. 改用 事物二。
3. 我們將在未來的某個時點移除 事物一。

常見的 [廢棄原因]:

• 一個功能已被更強大的替代方案取代。
• 一個功能包含設計缺陷。
• 一個功能被認為是多餘的，將在未來移除，以簡化整個系統。
• 軟體的未來版本將進行重大結構變更，導致無法或不實用支援舊有功能。
• 標準化或增加命名的一致性。
• 一個曾經僅獨立存在的功能，現在與其共同功能結合在一起。

在專案團隊標註某個功能為廢棄後，Hugo 將會：

1. 在 6 次小版本釋出中，記錄一條 INFO 訊息¹
2. 再記錄 6 次小版本釋出，記錄一條 WARN 訊息
3. 從此以後記錄一條 ERROR 訊息並使構建失敗

要查看 INFO 訊息，您必須使用 --logLevel 指令列標誌：

hugo --logLevel info

若只顯示廢棄通知：

hugo --logLevel info | grep deprecate

每次升級 Hugo 時，都應該運行上述指令。