| 摘要 | Category Banners 利用现有的分类详情为您的分类页面创建横幅(如需查看标签横幅,请参阅 Discourse Tag Banners)。 | |
| 预览 | 在 Discourse Theme Creator 上预览 | |
| 仓库链接 | https://github.com/discourse/discourse-category-banners | |
| 初识 Discourse 主题? | 使用 Discourse 主题的初学者指南 |
安装此主题组件
功能
Category Banners 利用现有的分类详情为您的分类页面创建横幅。它使用分类名称、描述和颜色,在相关分类页面的顶部生成横幅(如需查看标签横幅,请参阅 Discourse Tag Banners)。
分类描述是在每个分类的 “Category definition for …” 主题中的第一段定义的。横幅背景/文本颜色由您的分类徽章设置定义。
默认情况下,这将在桌面和移动设备上显示在所有分类和子分类页面上,但如果您未为分类设置描述,则不会显示。
设置
此组件提供了一些覆盖默认值的选项:
| 名称 | 描述 |
|---|---|
| show description | 显示 “About This Category” 帖子中的描述 |
| show mobile | 在移动设备上显示横幅 |
| show subcategory | 为子分类显示横幅 |
| hide if no description | 如果未设置分类描述,则隐藏横幅 |
| show category logo | 显示分类徽标 |
| align text | |
| exceptions | 这些分类名称不会显示横幅 |
| categories | 需要显示横幅的分类 |
| plugin outlet | 更改横幅在页面上的位置 |
| show category icon | 显示分类设置中的分类图标或表情符号 * |
| override category icon color | 当使用分类图标时,启用此选项将使图标与横幅文本颜色匹配 |
* 请注意,此设置现在指的是 在分类设置中设置的分类图标或表情符号,而不是 Category Icons 主题组件(该组件已弃用,转而使用核心功能)。
自定义说明
如果您想通过一些额外的 CSS 来自定义这些内容,可以使用以下结构来定位特定的分类标题(example-category 是您的分类名称):
.category-title-header {
&.category-banner-example-category {
background: url(example.jpg);
}
}
此组件还将 category-header 类添加到 body 标签,作为额外的 CSS 定位目标。
由我们托管? 主题组件在我们的 Standard、Business 和 Enterprise 计划中均可使用。
