公告

为特别活动创建公告或横幅。

公告是本地化目录中 announcements 部分下的一个常规 Hugo 页面。 这意味着我们可以利用 Hugo 内置功能来处理(未来或过期的)页面日期、国际化等功能, 这样可以根据构建日期自动显示或隐藏网站的横幅,确定横幅的排序,处理回退到英文横幅等情况。

目前,公告仅作为横幅使用。将来我们可能会支持更通用的公告形式。

创建公告

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

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

根据你想要的语言区域和文件名进行调整。将公告内容添加为页面的正文。

对于横幅来说,公告正文必须是简短的文字。

公告列表

当构建日期位于公告的 dateexpiryDate 字段之间时,所有提供的公告会出现在站点构建中。 如果这些字段缺失,则分别默认为 “now” 和 “forever”。

公告将按照 Hugo 的常规页面功能确定的标准页面顺序出现。 也就是说,weight 值最小(“最轻”的)公告会优先显示; 当多个公告的权重相同或未指定时,最新日期的公告将优先显示,依此类推。

因此,如果你希望将某条公告置顶,可以在 front matter 中将 weight 设为负数。

如果你发现仓库内容存在错误或问题,或者你希望请求某项增强功能,请创建一个 Issue

如果你发现了安全问题,请在创建 Issue 前阅读我们的安全策略

在报告新 Issue 之前,请先通过我们的 Issue 列表 确认该问题尚未被报告或已被修复。

在创建新的 Issue 时,标题要简短而有意义,并提供清晰的描述。 请尽可能提供相关信息,如有可能,还应附上测试用例。