网站文章及页面配置须知
2025年2月10日大约 1 分钟
页面布局(CustomBlogHome)
页面布局可以通过在front matter中设置layout
字段来设置。目前提供了CustomBlogHome
。 针对CustomBlogHome
布局下,其特定的frontmatter有:
字段名 | 类型 | 是否必填 | 默认值 | 说明 |
---|---|---|---|---|
heroText | String | 否 | null | 页面展示标题 |
showAllArticle | Boolean | 否 | ture | 展示任何类型的文章 |
showTypes | Array | 否 | null | 展示特定类型的文章 |
showBlogInfo | Boolean | 否 | true | 展示网站作者信息 |
其它字段请参考主题官方文档
文章类型
设置文章类型需要在markdown文件的front matter中设置categories
字段,设置类型为数组,你可以添加多个文章类型。
文章类型的设置非常有必要,因为它将影响到一些页面的展示。你可以看到在 社团公开资源页面、服务器wiki页面、新闻与公告页面 这三个页面中会按照时间顺序展示特定类型的文章。分别对应的类型是社团公开资源
、服务器百科
、新闻与公告
。
front matter规范
你需要注意的是,一些字段没有硬性要求填写,但在该网站下,为了规范运行,务必填写以下字段:
字段名 | 类型 | 是否必填 | 默认值 | 说明 |
---|---|---|---|---|
title | String | 是 | null | 文章或页面标题 |
如果新建的页面不是文章,或者你不希望它显示在任何BlogHome页面下,你需要设置article
为false