Discourse 分类横幅（Category Banners）


	摘要	分类横幅（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）	当分类图标被使用后，启用这个配置将会配置图标与横幅的文本色彩匹配

如果想对分类进行一些 CSS 的自定义，你可以使用下面的 CSS 配置来进行修改 (example-category 是你的分类名):

.category-title-header {
  &.category-banner-example-category {
        background: url(example.jpg);
  }
}

这个组件同时针对 category-header 类添加额外的 CSS 。