公告是本地化目录中 announcements 部分下的一个常规 Hugo 页面。
这意味着我们可以利用 Hugo 内置功能来处理(未来或过期的)页面日期、国际化等功能,
这样可以根据构建日期自动显示或隐藏网站的横幅,确定横幅的排序,处理回退到英文横幅等情况。
目前,公告仅作为横幅使用。将来我们可能会支持更通用的公告形式。
创建公告 {#creating-an-announcement}
要添加一个新的公告,请在你的本地化目录下的 announcements 文件夹中使用以下命令创建一个 Markdown 文件:
hugo new --kind announcement content/YOUR-LOCALE/announcements/announcement-file-name.md
根据你想要的语言区域和文件名进行调整。将公告内容添加为页面的正文。
对于横幅来说,公告正文必须是简短的文字。
如果你正在创建一个特定语言区域的公告,请确保使用与英文公告相同的文件名。
公告列表 {#announcement-list}
当构建日期位于公告的 date 和 expiryDate 字段之间时,所有提供的公告会出现在站点构建中。
如果这些字段缺失,则分别默认为 “now” 和 “forever”。
公告将按照 Hugo 的常规页面功能确定的标准页面顺序出现。
也就是说,weight 值最小(“最轻”的)公告会优先显示;
当多个公告的权重相同或未指定时,最新日期的公告将优先显示,依此类推。
因此,如果你希望将某条公告置顶,可以在 front matter 中将 weight 设为负数。
如果你发现仓库内容存在错误或问题,或者你希望请求某项增强功能,请创建一个 Issue。
如果你发现了安全问题,请在创建 Issue
前阅读我们的安全策略。
在报告新 Issue 之前,请先通过我们的
Issue 列表
确认该问题尚未被报告或已被修复。
在创建新的 Issue 时,标题要简短而有意义,并提供清晰的描述。
请尽可能提供相关信息,如有可能,还应附上测试用例。