公告
为特殊事件创建公告或横幅。
公告是位于区域设置的 `announcements` 部分下的*常规 Hugo 页面*。这意味着我们利用 Hugo 内置的页面日期处理(未来或过期)、国际化等功能,根据构建日期自动显示或隐藏横幅,确定横幅顺序,处理回退到英文横幅等。
目前公告仅用作横幅。我们*可能*最终也会支持稍微通用的公告。
创建公告
要添加新公告,请使用以下命令在本地化的 `announcements` 文件夹下创建一个公告 Markdown 文件。
hugo new --kind announcement content/YOUR-LOCALE/announcements/announcement-file-name.md
根据您想要的区域设置和文件名进行调整。将公告文本作为页面正文添加。
对于横幅,公告正文应为一句短语。
对于本地化
如果您正在创建**特定区域设置的公告覆盖**,请确保使用与英文公告**相同的文件名**。
公告列表
任何公告将在构建日期介于公告的 `date` 和 `expiryDate` 字段之间时出现在站点构建中。当这些字段缺失时,它们分别假定为“现在”和“永远”。
公告将按照 Hugo 的常规页面功能确定的标准页面顺序显示。也就是说,“权重”最小的公告将首先出现;当权重相同或未指定时,最近的公告(按 `date`)将首先出现,依此类推。
因此,如果您想将公告强制置顶,请在 front matter 中使用负数 `weight`。
如果您发现此存储库的内容存在错误或问题,或者您希望请求增强功能,请创建问题。
如果您发现安全问题,请在打开问题之前阅读安全策略。
在报告新问题之前,请通过搜索我们的问题列表,确保该问题尚未被报告或修复。
创建新问题时,请包含一个简短、有意义的标题和一个清晰的描述。添加尽可能多的相关信息,并且如果可能,附带一个测试用例。