 |
摘要 | 分类横幅（Category Banners) 使用已经存在的分类明细来为你的分类页面创建横幅 (针对 tags 的横幅配置请参考Tag Banners - Theme component - Discourse Meta 页面) |
 |
预览 | Theme Creator |
 |
官方仓库链接 | GitHub - discourse/discourse-category-banners |
 |
iSharkFly 镜像 | Discource-C/discourse-category-banners - discourse-category-banners - iSharkFly SRC |
 |
了解更多 Discourse Themes | Beginner's guide to using Discourse Themes - Site Management - Discourse Meta |
官方链接
本文从官方文档中进行翻译和优化，官方原文请访问：Category Banners - Theme component - Discourse Meta
特性
分类横幅（Category Banners） 使用已经存在的分类明细内容来为你的分类创建一个横幅。
在这个分类横幅中将会使用分类名，描述和指定的配色来在分类页面的顶部生成内容。
针对 Tag 标签的横幅，请参考：Tag Banners - Theme component - Discourse Meta 文章的内容。
分类的描述是在每一个分类描述主题中的第一段文字中进行定义的。
分类横幅的背景和文本色彩是定义在分类横幅的设置。
在默认的情况下，分类横幅针对分类本身和子分类会在桌面和移动设备上都会显示，但如果分类没有描述内容的话就不会显示。
配置
针对这个组件可以对下面的特性和属性进行覆盖。
| 配置名称 | 描述 |
|---|---|
| 显示描述（show description） | 从关于这个分类（About This Category）主题中显示描述 |
| 移动设备上显示（show mobile） | 在移动设备中显示横幅 |
| 在子分类中显示（show subcategory） | 在子分类中显示横幅 |
| 如无描述则不显示（hide if no description） | 如果分类描述没有设置的话，隐藏分类横幅 |
| 显示分类 Logo（show category logo） | 显示分类 logo |
| 文本对齐（align text） | |
| 不显示的分类（exceptions） | 如果分类名字（NAMES）在这个列表中的话，分类横幅针对这些分类不显示 |
| 分类（categories） | 显示分类横幅的分类 |
| 插件布局（plugin outlet） | 针对页面中配置显示分类横幅的位置 |
| 显示分类图标（show category icon） | Discourse 分类图标组件 显示分类图标 |
| 覆盖分类图标颜色（override category icon color） | 当分类图标被使用后，启用这个配置将会配置图标与横幅的文本色彩匹配 |
自定义备注（notes）
如果想对分类进行一些 CSS 的自定义，你可以使用下面的 CSS 配置来进行修改 (example-category 是你的分类名):
.category-title-header {
&.category-banner-example-category {
background: url(example.jpg);
}
}
这个组件同时针对 category-header 类添加额外的 CSS 。
:discourse2: 如果 Discourse 官方维护的 实例? 这个主题组件能够同时在 Standard, Business 和 Enterprise 套餐中使用。