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