公告

为特殊事件创建公告或横幅。

公告是位于区域设置的 `announcements` 部分下的*常规 Hugo 页面*。这意味着我们利用 Hugo 内置的页面日期处理(未来或过期)、国际化等功能,根据构建日期自动显示或隐藏横幅,确定横幅顺序,处理回退到英文横幅等。

目前公告仅用作横幅。我们*可能*最终也会支持稍微通用的公告。

创建公告

要添加新公告,请使用以下命令在本地化的 `announcements` 文件夹下创建一个公告 Markdown 文件。

hugo new --kind announcement content/YOUR-LOCALE/announcements/announcement-file-name.md

根据您想要的区域设置和文件名进行调整。将公告文本作为页面正文添加。

对于横幅,公告正文应为一句短语。

公告列表

任何公告将在构建日期介于公告的 `date` 和 `expiryDate` 字段之间时出现在站点构建中。当这些字段缺失时,它们分别假定为“现在”和“永远”。

公告将按照 Hugo 的常规页面功能确定的标准页面顺序显示。也就是说,“权重”最小的公告将首先出现;当权重相同或未指定时,最近的公告(按 `date`)将首先出现,依此类推。

因此,如果您想将公告强制置顶,请在 front matter 中使用负数 `weight`。

如果您发现此存储库的内容存在错误或问题,或者您希望请求增强功能,请创建问题

如果您发现安全问题,请在打开问题之前阅读安全策略

在报告新问题之前,请通过搜索我们的问题列表,确保该问题尚未被报告或修复。

创建新问题时,请包含一个简短、有意义的标题和一个清晰的描述。添加尽可能多的相关信息,并且如果可能,附带一个测试用例。